Connect Grafana
A Grafana connection reaches your Prometheus, Loki and Tempo through Grafana's data source proxy, with one service account token. Guidely never logs in as a user and only sends the read-only query requests listed in Security.
1. Create a service account
In Grafana, Administration → Users and access → Service accounts → Add service account:
- Name it Guidely and give it the Viewer role. Viewer is enough to query data sources; Guidely needs nothing more.
- Add service account token, give it an expiry that suits your rotation policy, and copy it (
glsa_…). Grafana shows it once.
If your Grafana restricts data source access (data source permissions, Grafana Enterprise and Cloud), give the service account Query permission on the Prometheus, Loki and Tempo data sources you want Guidely to use.
2. Add the connection in Guidely
A workspace admin opens Integrations → Grafana, Prometheus, Tempo, Loki → Add connection:
- What to connect: Grafana.
- How Guidely reaches it: Public URL with your Grafana's URL (for example
https://your-stack.grafana.net), or Through a relay and the relay'sgrafanatarget (see The relay). - Authentication: Service account token, and paste the service account token. With a relay, leave it empty: the relay sends the token (
TARGET_<NAME>_BEARER). - Click Test. Guidely lists the Prometheus, Loki and Tempo data sources the token can see.
- Pick the data sources for metrics, logs and traces. You don't need all three: a connection with only a Loki data source answers logs only.
- Add connection. Guidely tests it again and marks it working or failing.
Guidely reads the data source list from /api/datasources, or from /api/frontend/settings when the token may not list data sources. A data source is remembered by its UID, so renaming it in Grafana doesn't break anything. If you delete or replace a data source, pick the new one in the connection.
"Open in Grafana" links
Every panel has Open in Grafana, which opens Explore with the same query, data source and time range, so you can carry on there.
- For a direct Grafana connection the links use the connection's URL.
- Through a relay, the URL Guidely calls is private (
http://grafana:3000), so set Grafana URL for links to the address your team opens in the browser (for examplehttps://grafana.internal.example.com). Guidely never calls it; it only builds links with it.
Grafana Cloud
Grafana Cloud works directly, with no relay:
- URL: your stack,
https://<stack>.grafana.net. - Token: a service account token from that stack, as above.
- Pick the stack's
grafanacloud-<stack>-prom,-logsand-tracesdata sources.
Alternatively, connect the stack's Prometheus, Loki and Tempo endpoints directly with an access policy token; then you don't need a service account.
Rotating or revoking the token
Paste a new token in the connection and Save; the old one is discarded. To stop Guidely's access at once, delete the token or the service account in Grafana, or delete the connection in Guidely (which deletes the stored token). Tokens are stored encrypted and never shown again; only their last characters are.