Documentation Grafana Cloud Observe and act Instrument and send data Logs Cloud Logs Export Alerting

Cloud Logs Export Alerting

When using Cloud Logs Export, it is important to set up alerting to be notified of any export failures. Export failures can happen for various reasons such as misconfigured permissions, deleted buckets, or issues on the cloud provider side.

By configuring alerts, you can ensure that you are promptly notified if the Cloud Logs Export feature is unable to successfully write logs to your target bucket.

Recommended Alerts

We recommend creating alerts based on the metrics or logs related to the export process.

If you observe errors in your insightlogs data source, or notice that the Age of last synced file metric in the Cloud Logs Export Insights dashboard isn’t behaving as expected, your alert should trigger so that you can investigate and resolve the issue.

It is recommended to have at least one alert that fires for the absence of grafanacloud_logs_instance_cloud_logs_export_status{status="succeeded"} in the last 24h. This metric is available under the grafanacloud-usage data source.

How to set up an alert

To set up an alert for Cloud Logs Export failures:

1. Navigate to Alerting > Alert rules in your Grafana instance.
2. Click New alert rule.
3. Define a query that monitors the Cloud Logs Export metrics or queries the insightlogs data source for export errors.
4. Configure the alert condition and evaluation behavior.
5. Set up notifications to route the alerts to your preferred channels.

For more detailed information on configuring alerts, refer to the Grafana Alerting documentation.