Setup & Integrations
...
Grafana
Grafana On-Prem
with resolve ai's grafana integration, you don’t need to maintain separate integrations for each data source like loki, prometheus, or tempo once grafana is connected, all its data sources are seamlessly integrated prerequisite the resolve satellite should already be installed in your environment if you need assistance with installation, refer to the instructions provided in this resolve satellite /resolve satellite md section 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] official documentation how to add a token to a service account in grafana 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 create a service account through the api official documentation how to create to grafana service account via api run the following command please ensure that you replace the following properties grafana instance this is your grafana endpoint auth api key this is your authorization token for accessing the api (if applicable) create service account api curl x post http //\<grafana instance>/api/serviceaccounts \\ h "content type application/json" \\ h "authorization bearer \<auth api key>" \\ d '{"name" "resolve service account", "role" "viewer", "isdisabled" false}' the response will include the new service account id please take a note of it create service account api response { "id" 1, "name" "resolve service account", "isdisabled" false, } create a token for your service account via the api official documentation how to create to grafana service account token via api https //grafana com/docs/grafana/latest/developers/http api/serviceaccount/#create service account tokens run the following command please ensure that you replace the following properties grafana instance this is your grafana endpoint id this is your service account id for which a token will be created auth api key this is your authorization token for accessing the api (if applicable) curl x post http //\<grafana instance>/api/serviceaccounts/\<id>/tokens \\ h "content type application/json" \\ h "authorization bearer \<auth api key>" \\ d '{"name" "resolve access key", "role" "viewer"}' the response will include the new api key securely store this key immediately, as it won't be displayed again token creation api response {"id" 1,"name" "resolve access key","key" "eyjrij "} configure the grafana integration in resolve satellite below is an example of how to setup the grafana integration in the satellite with the url property as well as using the k8s secret (potentially backed by an aws secret manager or another mechanism) for authentication the secret format in this example is for a grafana service account token create a kubernetes secret create a kubernetes secret of the following form note that the structure of the secret is important and for a service account token for grafana integration, it must have the top level key token ‘token value’ secret creation apiversion v1 kind secret type opaque metadata name grafana resolve access token stringdata token "\<your grafana token>" to apply the secret run apply secret kubectl apply f grafana resolve access token yml configure your grafana token and urls in the resolve satellite update your helm values override file with the following information (e g resolve values yaml ) resolve values yaml integrations grafanaintegration type grafana create true secretname "grafana resolve access token" connection usegrafanaproxy true url "\<your grafana url>" linksdomainoverride "\<your grafana url for external links>" #(optional) use this if you want resolve ai to reference a separate grafana url for external links in investigations install the satellite and apply the values from the yaml file that you have just updated e g resolve values yaml to find the latest version, visit resolve ai's docker hub repository for the helm chart and satellite image apply config to satellite and redeploy helm upgrade install oci //registry 1 docker io/resolveaihq/satellite chart version \<latestchart> values resolve values yaml set image tag=\<latestimage> once your satellite is deployed, we will automatically create an integration instance for you verify your integration status in resolve ai login to https //app0 resolve ai/ https //app0 resolve ai/ go to the integrations page and and select “grafana” you should see an automatically created integration based on the provided configuration send alerts to resolve ai via webhook if you use grafana to manage your alerts, follow the steps to complete the alert integration for your environment note if you want to integrate directly with specific alerting sources, such as prometheus alertmanager or loki, ensure you follow the webhook instructions in each platform’s installation guide go to the grafana integration you have set up and click into it scroll down to the webhooks section click "edit" click on the "+" icon to add a new webhook token click "save" follow the instructions to add a new webhook integration in grafana cloud, and create a new notification policy