Self-Hosted Grafana? If you’re running Grafana in your own infrastructure, you’ll need to use the Resolve Satellite. See the Grafana On-Prem setup guide for instructions.
Create a Service Account Token
To access your Grafana environment a service account token is needed. If you don’t already have a service account, please create one: How to create a service account. There are two options for creating your service account token.Option 1: Create a token via the UI [Recommended]
Option 1: Create a token via the UI [Recommended]
Official documentation: How to add a token to a service account in Grafana
Option 2: Create a token via the API
Option 2: Create a token via the API
If you are running Grafana Enterprise, for some endpoints you might need to have specific permissions. Refer to Role-based access control permissions documentation for more information. For Grafana Cloud instances, you can use a Bearer token to authenticate.The response will include the new Service Account ID. Please take a note of it.The response will include the new API key. Securely store this key immediately, as it won’t be displayed again.
Create a Service Account through the API
Official documentation: How to create to Grafana service account via APIRun the following command. Please ensure that you replace the following properties:- grafana-instance: Your Grafana endpoint
- auth-api-key: Your authorization token for accessing the API (if applicable).
create service account api
create service account api response
Create a token for your Service Account via the API
Official documentation: How to create to Grafana service account token via APIRun the following command. Please ensure that you replace the following properties:- grafana-instance: Your Grafana endpoint
- id: Your service account ID, for which a token will be created
- auth-api-key: Your authorization token for accessing the API (if applicable)
token creation api response
Configure the Grafana Integration in the UI
- Sign in to ResolveAI and open the Grafana integration page https://app0.resolve.ai/integrations/grafana/connect
- Click Add Connection and set up a new integration:
- Token: Generated in the previous step
- URL: The endpoint for your Grafana instance
Send alerts to ResolveAI via webhook
If you use Grafana for alerts, use webhooks to send alert events to ResolveAI.- Sign in to ResolveAI and open the Grafana integration page https://app0.resolve.ai/integrations/grafana/connect
- Inside your Grafana integration, scroll down and click Edit
- Scroll down to Webhooks and click + icon to add a new webhook token
- Enter a Name and click Save
- Auto-generated instructions will show in the UI, to guide you through the steps in Grafana.
Mitigation Actions (Optional)
If your organization uses Resolve’s Mitigation Actions to silence alerts during investigations, your service account needs additional permissions beyond the default Viewer role.This section only applies if you have enabled Mitigation Actions. The default Viewer role is sufficient for investigation.
- Grafana v11+: Add the
alert.provisioning:writeRBAC permission to your service account. See Grafana RBAC permissions for details. - Older versions: Use the
Adminrole instead ofViewerfor the service account.

