Grafana Integration
Connect Grafana so Annie can inspect dashboards, query connected data sources, and examine alert rules.Setup Guide
- Create a Grafana service account and token with the required roles
- Go to the Anyshift Grafana integration page
- Select Grafana Cloud or Self-Hosted Grafana
- Enter your Grafana Instance URL
- Enter a display name for the service account and paste the Service Account Token
- Click Save Grafana Configuration
1. Grafana Instance URL
- For Grafana Cloud, enter your stack name only (for example
your-org). Anyshift buildshttps://your-org.grafana.netfor you. - For self-hosted, use your public or internal Grafana URL (for example
https://grafana.example.com)
2. Service Account & API Token
Annie authenticates with a Grafana service account token (it starts withglsa_). Do not use a personal API key or a Grafana Cloud Access Policy token.
Create a Grafana service account
You need Grafana organization Admin permissions (or equivalent service-account creator roles) in the instance you are connecting.- Sign in to the Grafana instance you want to connect (for Grafana Cloud, open your stack at
https://your-org.grafana.net, not only the Grafana.com portal) - In the left menu, go to Administration → Users and access → Service accounts
- Click Add service account
- Enter a display name such as
anyshift-readonly - Set the basic role to Viewer
- Click Create
Add the Alerting provisioning role
A plain Viewer can query dashboards and data sources, but cannot read alert rules through the provisioning API that Anyshift uses (/api/v1/provisioning/alert-rules).
- Open the service account you just created
- In the role picker / Fixed roles section, add Alerting:Read via Provisioning API + Export Secrets (
fixed:alerting.provisioning.secrets:reader) - Click Update
alert.provisioning:read if you want to avoid the secrets permission.
If your Grafana edition does not expose that fixed role, assign Alerting provisioning writer (fixed:alerting.provisioning:writer) instead. That grants write access to alert rules; Anyshift still only reads them.
Create a service account token
- Still on the service account page, click Add service account token
- Enter a token name such as
anyshift - Optionally set an expiration date
- Click Generate token
- Copy the token immediately and store it securely. Grafana shows it only once.