Skip to main content

​
Grafana Integration

Connect Grafana to enable the AI agent to query dashboards, metrics, and alerts during investigations.

​
Capabilities

Once connected, the AI agent can:
CapabilityDescription
Query MetricsFetch data from configured data sources
View DashboardsAccess dashboard panels and visualizations
Check AlertsReview alert rules and their current state
Search AnnotationsFind annotations marking events

​
Prerequisites

  • A Grafana instance (Cloud or self-hosted)
  • A Service Account with API access
  • Viewer or higher permissions

​
Setup

1

Create a Service Account

  1. Log in to your Grafana instance
  2. Navigate to Administration → Service accounts
  3. Click Add service account
  4. Name it (e.g., “AccelOS Integration”)
  5. Assign the Viewer role
2

Generate API Token

  1. In the service account, click Add token
  2. Give it a name and set expiration (or no expiration)
  3. Copy the generated token immediately
3

Add Integration in AccelOS

  1. Go to Integrations in AccelOS
  2. Click Grafana
  3. Enter a name (e.g., “Production Grafana”)
4

Configure Credentials

Enter the following:
  • URL: Your Grafana URL (e.g., https://your-org.grafana.net)
  • API Token: The service account token you created
5

Test and Save

Click Test Connection to verify, then Save.

​
Required Permissions

The service account needs:
PermissionWhy It’s Needed
Viewer roleBasic read access to dashboards and data
Data source accessQuery underlying data sources
For self-hosted Grafana, ensure the service account has access to the specific data sources you want to query.

​
Grafana Cloud vs Self-Hosted

​
Grafana Cloud

Use your Grafana Cloud URL: 
https://your-org.grafana.net

​
Self-Hosted Grafana

Use your Grafana server URL: 
https://grafana.your-company.com
Ensure the URL is accessible from AccelOS (check firewall rules).

​
Example Queries

Once connected, you can ask the AI agent: 
Show me the request rate from the API dashboard

What alerts are currently firing in Grafana?

Get CPU metrics for the web servers from the last 30 minutes

​
Troubleshooting

  • Verify the API token is correct and hasn’t expired
  • Check that the service account hasn’t been disabled
  • Ensure the token was copied completely
  • Verify the Grafana URL is correct
  • Check firewall rules allow access from AccelOS
  • Ensure Grafana is running and accessible
  • Verify the service account has Viewer permissions
  • Check folder permissions for dashboards