Grafana 9 adds support for images to grafana alerts! This is a feature that legacy alerting had - but it’s new for unified grafana alerting. That said, we want to point out that if you’re migrating from legacy alerting - there are a few configuration steps to add images in new alerts. These settings aren’t migrated from the legacy alerting section of your configuration file.
A short list of helpful docs to review for managing and configuring migrated grafana alerts:
- Add images to notifications
- List of notifiers that support images
- Migrating from legacy alerts OR opting out
- Roll back to legacy alerting
- About differences/limitations of the migration
Configuring images in new grafana alerts:
First, enable image rendering if it isn’t already!
If Grafana has been set up to use image rendering images in notifications can be turned on via the
# Enable screenshots in notifications. This option requires a remote HTTP image rendering service. Please # see [rendering] for further configuration options. capture = true
It is recommended that
max_concurrent_screenshotsis set to a value that is less than or equal to
concurrent_render_request_limit. The default value for both
# The maximum number of screenshots that can be taken at the same time. This option is different from # concurrent_render_request_limit as max_concurrent_screenshots sets the number of concurrent screenshots # that can be taken at the same time for all firing alerts where as concurrent_render_request_limit sets # the total number of concurrent screenshots across all Grafana services. max_concurrent_screenshots = 5
If Grafana has been set up to use an external image store,
upload_external_image_storageshould be set to
# Uploads screenshots to the local Grafana server or remote storage such as Azure, S3 and GCS. Please # see [external_image_storage] for further configuration options. If this option is false, screenshots # will be persisted to disk for up to temp_data_lifetime. upload_external_image_storage = false
Restart Grafana for the changes to take effect.