Skip to main content

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 payments team 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
  1. Go to Organization > Connectors and find Grafana.
  2. Click Enable and choose which tools to allow.
  3. 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.

ToolWhat it does
call_datasource_resourceDiscover what a Grafana data source can be queried for: metric names, label names, and label values.
check_datasource_healthCheck whether a Grafana data source is reachable and its stored credentials work.
get_alert_ruleGet a Grafana alert rule by UID.
get_current_userGet the currently authenticated Grafana user.
get_dashboardGet a Grafana dashboard by UID.
get_datasourceGet a Grafana data source by UID.
get_folderGet a Grafana folder by UID.
get_orgGet the current Grafana organization info.
get_teamGet a Grafana team by ID.
list_alert_historyGet state-change history for Grafana alert rules over a time range: when a rule moved to firing, normal, or error, and why.
list_alert_instancesList Grafana alert instances that are currently firing, silenced, or inhibited, with their labels, annotations, and start times.
list_alert_rule_statesList Grafana alert rules with their current evaluation state and health, grouped by rule group.
list_alert_rulesList all Grafana alert rules.
list_annotationsList Grafana annotations filtered by time range, tags, or dashboard.
list_contact_pointsList all Grafana alerting contact points.
list_datasourcesList all Grafana data sources.
list_foldersList all Grafana folders.
list_org_usersList all users in the current Grafana organization.
list_team_membersList members of a Grafana team.
query_datasourceQuery a Grafana data source for the actual metric, log, or SQL data behind dashboards.
search_dashboardsSearch Grafana dashboards by query, tags, or folder.
search_teamsSearch Grafana teams by name or query.
validate_credentialValidate Grafana credentials by fetching the current organization.

Write (8)​

Create or send data.

ToolWhat it does
add_team_memberAdd a user to a Grafana team.
create_alert_ruleCreate a Grafana alert rule.
create_annotationCreate a Grafana annotation.
create_contact_pointCreate a Grafana alerting contact point.
create_dashboardCreate a new Grafana dashboard.
create_datasourceCreate a new Grafana data source.
create_folderCreate a new Grafana folder for organizing dashboards.
create_teamCreate a new Grafana team.

Delete or overwrite (15)​

Remove or replace existing data.

ToolWhat it does
delete_alert_ruleDelete a Grafana alert rule by UID.
delete_annotationDelete a Grafana annotation by ID.
delete_contact_pointDelete a Grafana alerting contact point by UID.
delete_dashboardDelete a Grafana dashboard by UID.
delete_datasourceDelete a Grafana data source by UID.
delete_folderDelete a Grafana folder and all its dashboards.
delete_teamDelete a Grafana team by ID.
remove_team_memberRemove a user from a Grafana team.
update_alert_ruleUpdate a Grafana alert rule by UID.
update_annotationUpdate a Grafana annotation by ID.
update_contact_pointUpdate a Grafana alerting contact point by UID.
update_dashboardUpdate an existing Grafana dashboard.
update_datasourceUpdate an existing Grafana data source by numeric ID.
update_folderUpdate a Grafana folder's title.
update_teamUpdate a Grafana team's name or email.
⌘J