Grafana

​

What it provides

​

Dashboards

• Read as images. Nexus renders a dashboard for the incident’s time window and reads the resulting image. It interprets the charts the way a responder glancing at the dashboard would: the spike, the dip, the line that breaks trend. It isn’t limited to the numbers behind a panel; it sees the panel.
• Learned from. The queries built into your dashboards are a record of how your team investigates: which signals matter, how they’re filtered and grouped. Nexus learns from them, which sharpens how it queries the data sources behind Grafana, dashboard or not. See How telemetry works.

​

Setup

• The URL of your Grafana instance. It must use HTTPS and a publicly resolvable hostname; if your Grafana runs on a private network, run a proxy and connect through it instead.
• A Grafana service account token. It must be non-expiring: Grafana suggests an expiry when you create a token, so choose no expiration. Otherwise the connection stops working when the token lapses.

• Viewer basic role: assign the Viewer basic role to the service account. It grants read and query access to all data sources, and it’s the fastest to set up.
• Fixed roles: assign the three fixed roles Dashboards Reader, Folders Reader, and Data sources Reader. The middle ground: scoped to just what Nexus reads, without maintaining a custom role.
• Custom role: create a custom role with exactly the actions Nexus needs, then assign it to the service account:

{
  "version": 1,
  "name": "custom:incidentio:telemetry",
  "displayName": "incident.io telemetry",
  "global": true,
  "permissions": [
    { "action": "datasources:read", "scope": "datasources:*" },
    { "action": "datasources:query", "scope": "datasources:*" },
    { "action": "dashboards:read", "scope": "dashboards:*" },
    { "action": "folders:read", "scope": "folders:*" }
  ]
}

1. From the Nexus telemetry settings, add a telemetry data source and choose Grafana.
2. Enter your Grafana URL and service account token, then test the connection. If you’re connecting through a proxy, choose it here; you can also set a public URL so that links back into Grafana open somewhere your browser can reach.
3. Once connected, Nexus discovers the data sources behind Grafana and lists your dashboards. Enable the data sources your team uses and select their most-used dashboards.

​

Related