Grafana Cloud Health Check

‍

Gremlin can use Grafana alert rules as Health Checks. You'll need to retrieve the Alert Rule URL from the relevant alert's page in the Grafana Cloud web app. See Grafana Alerting in the Grafana Cloud documentation for more information.

To add a Grafana Cloud Health Check:

1. Open the Health Checks page in the Gremlin web app, click + Health Check, then select Grafana Cloud from the Integrations drop-down.
2. If Grafana Cloud is already authenticated, continue to step 3. Otherwise, follow these steps:
   1. Enter your Grafana Cloud domain in the API Base URL text box. The full URL should appear similar to:<span class="code-class-custom"> https://example.grafana.net/</span>
   2. In Grafana Cloud, <a href="https://grafana.com/docs/grafana/latest/administration/service-accounts/" target="_blank">create a Service Account</a>. In the Authentication section of the Gremlin web app, paste your Service account token into the API key text box.
   3. Click Authenticate Observability Tool. To validate the endpoint with the added header, Gremlin calls the following API: <span class="code-class-custom">https://<your_domain>.grafana.net/api/alertmanager/grafana/api/v2/alerts</span>
   4. If the authentication passes, click Save Authentication, then click Next.
3. In the Grafana Cloud web app, navigate to the Alert page and copy the URL of the rule you want to use.
4. Back in the Gremlin web app, enter the URL into the Entity URL text box. For example, <span class="code-class-custom">https://example.grafana.net/alerting/grafana/107Vz/view</span>
5. Click Test Health Check. Gremlin will look at the response body and verify that the rule has no alerts in a <span class="code-class-custom">Firing</span> state. A value of <span class="code-class-custom">Normal</span> for the State field will evaluate as successful.
6. Click Create Health Check.