Zum Hauptinhalt springen
API-Referenz

Grafana

Grafana ermöglicht es dir, schnell den aktuellen Status deines Clusters und deiner Deployments einzusehen.

Details​

Für Kunden, die den Status deines NKE Clusters visualisieren wollen, bietet Nine ein auf Grafana basierendes Standard-Dashboard.

Du kannst auch eigene Dashboards aufsetzen und diese in Ordnern verwalten, um verschiedene Hierarchien zu erstellen und ihnen Warnungen hinzuzufügen.

Verfügbarkeit​

Grafana ist als optionaler Service für NKE verfügbar und kann im Cockpit erstellt werden.

Einschränkungen​

Bitte beachte die folgenden Einschränkungen:

  • Grafana Alerting: Grafana Alerting wird derzeit bei Verwendung des Metrics Agent nicht unterstützt. Bitte verwende stattdessen den Alertmanager.

Nutzung​

Du kannst dich mit deinen Cockpit-Kontodaten einloggen.

Individuelle Dashboards und Warnungen​

Um eigene Dashboards zu erstellen, schau dir bitte die offizielle Grafana Dokumentation an.

Standardmässig gelten bei Nine Managed Grafana bestimmte Einschränkungen:

  • Aktuell ist es für dich nicht möglich, eigene Datenquellen hinzuzufügen.
  • Die Bearbeitung der Nine Standard-Dashboards ist nicht möglich, allerdings kannst du die JSON-Definition der Panels kopieren und diese in deinem eigenen Dashboard verwenden.
  • Es ist nicht möglich, Warnungen per E-Mail zu konfigurieren
  • Warnungen können nur über Dashboards & Panels definiert werden, die du selbst erstellt hast

Einige dieser Einschränkungen können durch die Aktivierung des Admin-Zugangs aufgehoben werden.

Admin-Zugang​

warnung

Wir raten dir, vorsichtig mit den Admin-Rechten umzugehen, da du möglicherweise deine Grafana-Instanz zerstören könntest. Nine behält sich das Recht vor, Admin Berechtigungen jederzeit zu entfernen, wenn der Admin-Zugang als Sicherheits- oder Betriebsrisiko angesehen wird.

Die Aktivierung des Admin-Zugangs gewährt allen Benutzern in deiner Organisation die Grafana-Admin-Rolle anstelle der standardmässigen Editor-Rolle. Dadurch werden die meisten der oben aufgeführten Standardeinschränkungen aufgehoben und du erhältst die volle Kontrolle über deine Grafana-Instanz, einschliesslich der Möglichkeit, Datenquellen hinzuzufügen und Benutzer zu verwalten.

Setze EnableAdminAccess in den Grafana-Parametern im Cockpit auf true.

Lokale Benutzer​

Standardmässig werden alle Grafana-Anmeldeversuche an den nine.ch OIDC-Provider weitergeleitet. Sobald du den Admin-Zugang aktiviert hast, kannst du lokale Grafana-Benutzer über die integrierte Benutzerverwaltung erstellen. Damit diese lokalen Benutzer das Anmeldeformular erreichen können, aktiviere AllowLocalUsers mit nctl. Ohne diese Einstellung werden lokale Benutzer sofort zur OAuth-Anmeldeseite weitergeleitet und können sich nicht einloggen.

nctl update grafana <name> --local-users
nctl update grafana <name> --no-local-users
warnung

Wenn AllowLocalUsers aktiviert ist, werden OIDC-Benutzer nicht mehr automatisch weitergeleitet und müssen im Anmeldeformular manuell auf Sign in with OAuth klicken.