Grafana
Connect Grafana to index dashboards, alerts, and data-source queries into Cortex for operational awareness.
Overview
| Auth method | API Key / Service Account Token |
| Setup time | ~5 minutes |
How to connect
- Navigate to Settings → Integrations → Connectors
- Click Connect on the Grafana integration
- Enter your Grafana service account token and instance URL
- Once configured, dashboard and alerting data becomes available to Cendriix agents
Getting your API token
Grafana Cloud
- Go to your Grafana Cloud instance → Administration → Service Accounts
- Click Add service account
- Assign the Viewer role (minimum required)
- Create a token for the service account
- Copy the token and paste it in the Cendriix setup wizard
Self-hosted Grafana
- Go to Administration → Service Accounts (Grafana 9+) or Configuration → API Keys (older versions)
- Create a service account with Viewer role
- 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