Skip to Content
ConnectorsGrafana

Grafana

Connect Grafana to index dashboards, alerts, and data-source queries into Cortex for operational awareness.

Overview

Auth methodAPI Key / Service Account Token
Setup time~5 minutes

How to connect

  1. Navigate to Settings → Integrations → Connectors
  2. Click Connect on the Grafana integration
  3. Enter your Grafana service account token and instance URL
  4. Once configured, dashboard and alerting data becomes available to Cendriix agents

Getting your API token

Grafana Cloud

  1. Go to your Grafana Cloud instance → Administration → Service Accounts
  2. Click Add service account
  3. Assign the Viewer role (minimum required)
  4. Create a token for the service account
  5. Copy the token and paste it in the Cendriix setup wizard

Self-hosted Grafana

  1. Go to Administration → Service Accounts (Grafana 9+) or Configuration → API Keys (older versions)
  2. Create a service account with Viewer role
  3. Generate a token and paste it in the Cendriix setup wizard

Capabilities

Once connected, Cendriix agents can:

  • Read dashboard definitions and panel configurations
  • Access alert rules and their current states
  • Query data source metadata
  • Reference operational dashboards when troubleshooting or planning infrastructure changes

Security notes

  • Service account tokens can be scoped to specific roles (Viewer recommended)
  • Tokens are stored encrypted in AWS Secrets Manager
  • API keys (legacy) never expire unless configured — prefer service account tokens with expiry
  • Disconnect at any time from Settings → Integrations → Connectors

Further reading

Last updated on