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 your agent in Agent Studio
- In the Integrations panel, click Add Integration Config
- Select Grafana from the integration list
- Give the config a display name (e.g., "Grafana - Monitoring")
- Enter your Base URL
- Paste your Service Account Token
- Save the agent revision
Using in Your Agent
- In an Agent Step, attach Grafana tools from the tools panel
- The agent uses your integration config for all Grafana API calls
- 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 |