Connect to Grafana Cloud

Grafana Cloud's hosted Prometheus is a valid source for Observer agents. The connection uses basic auth with credentials issued by Grafana for read access.

Steps

1. In Grafana Cloud, open the stack details for the Prometheus instance you want the agent to read. Note:

   • URL: the remote-read URL (e.g. https://prometheus-prod-01-eu-west-0.grafana.net/api/prom).
   • Username: the numeric user id (e.g. 123456).
   • Password: a Grafana Cloud access policy token with metrics:read scope.

2. Set the agent's environment:

   PROMETHEUS_SERVER_URL=https://prometheus-prod-01-eu-west-0.grafana.net/api/prom
   PROMETHEUS_BASIC_AUTH_ENABLED=true
   PROMETHEUS_USERNAME=123456
   PROMETHEUS_PASSWORD=glc_eyJ...   # access policy token

3. Restart the agent. Heartbeats and probe queries now hit Grafana Cloud.

Verification

Define a Prometheus metric in the console (any working PromQL query against the data Grafana Cloud holds). Within one push interval the metric reports a value. Failures resolve to no_data with a reason:

• Unauthorized when the access policy token is missing or lacking the required scope.
• BadQuery when the PromQL string is invalid against the data.
• PromUpstream for Grafana-side 5xx responses.