Grafana Cloud

Verbinde Grafana Cloud, damit Agents deine Dashboards lesen, deine Datasources abfragen und Grafana Alerting inspizieren können.

Einrichtung

1. Finde deine Stack-URL im Grafana Cloud-Portal, etwa https://yourstack.grafana.net.
2. Öffne in deinem Grafana-Stack Administration → Users and access → Service accounts.
3. Erstelle einen Service Account mit der Rolle Editor. Editor erlaubt Agents, Dashboards zu lesen, Datasources abzufragen und Annotationen anzulegen, und erlaubt Polylane, deine Grafana-Alerts zu abonnieren.
4. Füge dem Service Account einen Token hinzu und füge beide Werte in Polylane ein. Polylane prüft sie gegen deinen Stack und verbindet.

Dein Token wird vor dem Speichern verschlüsselt, und der Agent sieht ihn nie.

Stacks im kostenlosen Tarif von Grafana Cloud schlafen nach Inaktivität ein. Wenn die Prüfung meldet, der Stack sei nicht erreichbar, öffne ihn einmal im Browser und versuche es erneut.

Alerts und kontinuierliches Monitoring

Beim Verbinden richtet Polylane in deinem Stack einen Webhook-Contact-Point ein und fügt deinem Notification-Policy-Baum eine Catch-all-Route hinzu. Die Route matcht jeden Alert und reicht an deine bestehenden Routen weiter, deine aktuelle Zustellung bleibt also unangetastet, und später angelegte Alert-Regeln benachrichtigen Polylane automatisch. Auslösende Alerts landen in deinem Workspace, werden triagiert und können Untersuchungen starten.

Polylane liest außerdem jedes Dashboard und führt jede Panel-Abfrage kontinuierlich als Anomalie-Check aus, und es entdeckt Schlüsselabfragen für Signale, die deinen Dashboards fehlen.

Was Agents tun können

• Dashboards durchsuchen und ihre Panel-Definitionen und Abfragen lesen
• Datasources auflisten und Health Checks ausführen
• PromQL, LogQL, TraceQL und andere Datasource-native Abfragen über den Query-Proxy von Grafana ausführen
• Alert-Regeln, ihren Live-Zustand und ihre Gesundheit sowie die gerade auslösenden Alerts inspizieren
• Diagramm-Annotationen lesen und neue für Deploys und Incident-Fenster anlegen

Verbindung trennen

Trenne Grafana Cloud in Polylane; dabei werden der Contact Point und die Notification-Policy-Route entfernt, die es eingerichtet hat. Lösche dann den Service-Account-Token in Grafana. Wenn die Route in Terraform steht, nimm sie gleichzeitig heraus.

Ein stündlicher Abgleich hält den Contact Point polylane und seine Catch-all-Policy-Route in Position. Die Ressource grafana_notification_policy verwaltet den gesamten Policy-Baum, ein Terraform-Apply ohne die Route entfernt sie also, und der Abgleich fügt sie wieder hinzu. Führe die Route als erste Policy in deinem Baum, mit continue = true, damit deine eigenen Routen weiterhin alles erhalten, und überlasse den Contact Point selbst Polylane:

resource "grafana_notification_policy" "tree" {
  # ...

  policy {
    contact_point = "polylane"
    continue      = true
  }

  # your existing routes follow
}

Alert-Regeln brauchen keine Einrichtung pro Regel: Die Route matcht jeden Alert. Das Trennen der Integration entfernt den Contact Point und die Route, nimm die Route also gleichzeitig aus den Terraform-Konfigurationen.