Grafana
Grafana connector for querying metrics and logs and for managing dashboards, data sources, folders, alerts, annotations, teams, and organizations.
Categories: Observability, Monitoring
What you can ask
- Show me dashboards owned by the
paymentsteam and surface any with no panels updated in 90 days. - Pull the alert rules that fired in the last 24 hours, grouped by severity.
- Find dashboards with broken panels (data source unreachable).
Set up
Grafana connects with credentials from your Grafana account. Have these values ready:
- Instance URL
- Service account token
- Go to Organization > Connectors and find Grafana.
- Click Enable and choose which tools to allow.
- Each member enters their own values the first time they use it.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
Tools
Grafana offers 46 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (23)
View and search information without changing it.
| Tool | What it does |
|---|---|
call_datasource_resource | Discover what a Grafana data source can be queried for: metric names, label names, and label values. |
check_datasource_health | Check whether a Grafana data source is reachable and its stored credentials work. |
get_alert_rule | Get a Grafana alert rule by UID. |
get_current_user | Get the currently authenticated Grafana user. |
get_dashboard | Get a Grafana dashboard by UID. |
get_datasource | Get a Grafana data source by UID. |
get_folder | Get a Grafana folder by UID. |
get_org | Get the current Grafana organization info. |
get_team | Get a Grafana team by ID. |
list_alert_history | Get state-change history for Grafana alert rules over a time range: when a rule moved to firing, normal, or error, and why. |
list_alert_instances | List Grafana alert instances that are currently firing, silenced, or inhibited, with their labels, annotations, and start times. |
list_alert_rule_states | List Grafana alert rules with their current evaluation state and health, grouped by rule group. |
list_alert_rules | List all Grafana alert rules. |
list_annotations | List Grafana annotations filtered by time range, tags, or dashboard. |
list_contact_points | List all Grafana alerting contact points. |
list_datasources | List all Grafana data sources. |
list_folders | List all Grafana folders. |
list_org_users | List all users in the current Grafana organization. |
list_team_members | List members of a Grafana team. |
query_datasource | Query a Grafana data source for the actual metric, log, or SQL data behind dashboards. |
search_dashboards | Search Grafana dashboards by query, tags, or folder. |
search_teams | Search Grafana teams by name or query. |
validate_credential | Validate Grafana credentials by fetching the current organization. |
Write (8)
Create or send data.
| Tool | What it does |
|---|---|
add_team_member | Add a user to a Grafana team. |
create_alert_rule | Create a Grafana alert rule. |
create_annotation | Create a Grafana annotation. |
create_contact_point | Create a Grafana alerting contact point. |
create_dashboard | Create a new Grafana dashboard. |
create_datasource | Create a new Grafana data source. |
create_folder | Create a new Grafana folder for organizing dashboards. |
create_team | Create a new Grafana team. |
Delete or overwrite (15)
Remove or replace existing data.
| Tool | What it does |
|---|---|
delete_alert_rule | Delete a Grafana alert rule by UID. |
delete_annotation | Delete a Grafana annotation by ID. |
delete_contact_point | Delete a Grafana alerting contact point by UID. |
delete_dashboard | Delete a Grafana dashboard by UID. |
delete_datasource | Delete a Grafana data source by UID. |
delete_folder | Delete a Grafana folder and all its dashboards. |
delete_team | Delete a Grafana team by ID. |
remove_team_member | Remove a user from a Grafana team. |
update_alert_rule | Update a Grafana alert rule by UID. |
update_annotation | Update a Grafana annotation by ID. |
update_contact_point | Update a Grafana alerting contact point by UID. |
update_dashboard | Update an existing Grafana dashboard. |
update_datasource | Update an existing Grafana data source by numeric ID. |
update_folder | Update a Grafana folder's title. |
update_team | Update a Grafana team's name or email. |