Grafana
Grafana observability platform integration for dashboards, data sources, alert rules, and annotations
The Grafana integration lets your agents search dashboards, query data sources, manage alert rules, and work with folders and annotations.
Prerequisites
You need:
- Grafana Service Account Token — Create one in your Grafana instance under Administration → Service Accounts.
- Base URL — The URL of your Grafana instance (e.g.,
https://your-org.grafana.net).
Setup
- Open Integrations from the sidebar
- Select Grafana from the catalog
- Click Add Integration Config
- Give the config a display name (e.g., "Grafana - Monitoring")
- Enter your Base URL
- Paste your Service Account Token
- Save the config
Using in Your Agent
- Open your agent in Agent Studio and select an Agent Step
- Under Attached Integration Configurations, click Attach configuration and choose your config
- Attach Grafana tools from the tools panel
- Tools are referenced as
grafana.search_dashboards,grafana.list_alert_rules, etc.
Available Tools
| Tool | Description | Action Type |
|---|---|---|
search_dashboards | Search dashboards | ReadOnly |
get_dashboard | Get a specific dashboard | ReadOnly |
list_datasources | List data sources | ReadOnly |
get_datasource | Get a specific data source | ReadOnly |
list_alert_rules | List alert rules | ReadOnly |
get_alert_rule | Get a specific alert rule | ReadOnly |
list_folders | List folders | ReadOnly |
get_folder | Get a specific folder | ReadOnly |
list_annotations | List annotations | ReadOnly |
create_annotation | Create an annotation | Reversible |