So fügen Sie Grafana ein Prometheus-Dashboard hinzu

Ein Artikel von Matt Toback von raintank, dem Unternehmen hinter Grafana

Einführung

Grafana ist der führende Hersteller von Diagrammen und Dashboards für die Visualisierung von Zeitreiheninfrastrukturen und Anwendungsmetriken. Viele verwenden ihn jedoch auch in anderen Bereichen, einschließlich Industriesensoren, Heimautomatisierung, Wetter und Prozesssteuerung. Es bietet eine leistungsstarke und elegante Möglichkeit, Dashboards und Daten für Ihr Team und die ganze Welt zu erstellen, zu erkunden und gemeinsam zu nutzen.

In diesem Tutorial erfahren Sie, wie Sie Prometheus als Datenquelle zu Ihrer Grafana-Instanz hinzufügen und ein vorkonfiguriertes Prometheus Server Statistics Dashboard installieren.

Voraussetzungen

Um diesem Tutorial zu folgen, benötigen Sie:

Ubuntu 14.04 Droplet
Benutzer mit Sudo-Zugriff (Details finden Sie im Tutorial Erstes Server-Setup mit Ubuntu 14.04)
Prometheus und Grafana 2.5+ installiert mit den Anweisungen von How To Install Prometheus using Docker auf Ubuntu 14.04

Schritt 1 - Hinzufügen von Prometheus als Grafana-Datenquelle

In diesem Abschnitt konfigurieren wir Grafana so, dass es als Datenquelle auf Ihren Prometheus-Server zugreift. Jeder Prometheus-Server ist eine separate Datenquelle. Wenn Sie mehr als einen Prometheus-Server konfigurieren, wiederholen Sie diesen Abschnitt für jeden Server.

Gehen Sie zur Grafana-Hauptansicht unter "+ http: //: 3000 / +" und melden Sie sich in Ihrem Administratorkonto an.

Klicken Sie oben links auf das Grafana-Symbol, um das Hauptmenü anzuzeigen. Wählen Sie * Datenquellen *, um zur Seite mit der Liste der Datenquellen zu navigieren. Klicken Sie in der oberen Navigationsleiste auf "Neu hinzufügen". Sie sollten Folgendes sehen:

image: https://assets.digitalocean.com/articles/grafana_prometheus/4ST1Bt3.png [Prometheus-Datenquelle]

Verwenden Sie die folgenden Werte, um eine neue Datenquelle zu erstellen:

+ Name +: Prometheus
+ Typ +: Prometheus
+ URL +: http: //, (Standardport ist 9090)
+ Access +: Proxy
+ Basic Auth +: Aktiviert oder deaktiviert, wenn Ihr Prometheus-Server konfiguriert ist.

Klicken Sie auf * Hinzufügen *, um Ihre Datenquelle hinzuzufügen, und klicken Sie dann auf * Verbindung testen *, um zu überprüfen, ob alles ordnungsgemäß funktioniert. Fahren Sie bei Erfolg mit dem nächsten Schritt fort, um Ihr Dashboard zu importieren.

Schritt 2 - Importieren des Prometheus Stats Dashboards

In diesem Abschnitt wird ein offizielles, vorgefertigtes Prometheus Stats-Dashboard heruntergeladen, und Sie erhalten Anweisungen zum Importieren in Grafana.

Laden Sie das neueste Prometheus Dashboard auf zwei Arten herunter:

Klicken Sie mit der rechten Maustaste und speichern Sie den folgenden Link: Prometheus Stats - Standard-Grafana-Dashboard
Navigieren Sie mit Ihrem Browser direkt zur Dashboard-JSON-Datei: + http: // grafana.org / assets / dashboards / prometheus-dash.json +

Die Importansicht finden Sie in der Dropdown-Liste "Dashboard-Auswahl" neben den Schaltflächen "Neues Dashboard" und "Wiedergabeliste".

Um ein Dashboard aus einer lokalen JSON-Datei zu importieren, klicken Sie auf die Schaltfläche * Datei auswählen * im Abschnitt * Datei importieren *. Suchen Sie die heruntergeladene Datei "+ prometheus-dash.json +" in Ihrem lokalen Dateisystem und importieren Sie sie.

image: https://assets.digitalocean.com/articles/grafana_prometheus/HGL0BSi.gif [Import]

Hinweis: * Wenn Sie Ihrer Datenquelle einen anderen Namen als "+ Prometheus " gegeben haben, müssen Sie den Namen der Datenquelle in der Datei " .json +" suchen und ersetzen. Öffne es mit:

nano prometheus-dash.json

Finden Sie Folgendes und ändern Sie den Dateinamen der Datenquelle von in den Namen, den Sie angegeben haben:

prometheus-dash.json

"datasource": "",

Nach dem Importieren des Prometheus-Dashboards werden Sie sofort zum Prometheus-Statistik-Dashboard weitergeleitet. Wenn alles richtig konfiguriert ist, werden Statistiken von Ihrem Prometheus-Server angezeigt.

image: https://assets.digitalocean.com/articles/grafana_prometheus/TuWTZpv.png [Prom Stats Dash]

Wichtig *: Klicken Sie im oberen Menü auf die Schaltfläche Speichern, um Ihr Dashboard in Ihrer Grafana-Instanz zu speichern. Wenn Sie Ihr Dashboard nicht speichern, wird es nach dem Schließen des Browsers nicht in Ihrem Grafana angezeigt.

Schritt 3 - Anzeigen des Prometheus Stats Dashboards

Nach einem erfolgreichen Import werden Sie sofort zu Ihrem neuen, ungespeicherten Dashboard weitergeleitet. Dieses Dashboard wurde mit Hilfe des Prometheus-Teams erstellt und zeigt die grundlegenden Metriken auf, die häufig zur Fehlerbehebung bei Ihrem Prometheus-Server verwendet werden.

image: https://assets.digitalocean.com/articles/grafana_prometheus/prom_dash.png [Prometheus Dashboard]

Die einzelnen Panels und gemeldeten Metriken lauten wie folgt:

Einzelne Statistikdiagramme

* Uptime *: Diese Grafik zeigt die Betriebszeit oder die Zeit, seit der Prometheus-Server online geschaltet wurde. Auf einen Blick ist diese Statistik hilfreich, um festzustellen, ob Ihr Server kürzlich neu gestartet wurde.
* Local Storage Memory Series *: In diesem Bereich wird die aktuelle Anzahl der im Speicher abgelegten Serien ab dem im Dashboard-Zeitbereich angegebenen Wert "+ From " angezeigt. Standardmäßig ist dies " now".
* Länge der internen Speicherwarteschlange *: Idealerweise sollte diese Warteschlangenlänge leer (0) oder niedrig sein.
* Sample Ingested *: Dieses Diagramm zeigt die Anzahl der vom Prometheus-Server aufgenommenen Proben, gemessen in den letzten 5 Minuten, pro Zeitreihe im Bereichsvektor. Bei der Behebung eines Problems im IRC oder Github ist dies häufig die erste vom Prometheus-Team angeforderte Statistik. Diese Zahl sollte mit der Anzahl der Metriken übereinstimmen, die Sie Ihrer Meinung nach einnehmen.

Die Abfrage * Samples Ingested * lautet wie folgt:

rate(prometheus_local_storage_ingested_samples_total[5m])

Kratzer

Prometheus berechnet Metriken aus instrumentierten Jobs, entweder direkt oder über ein intermediäres Push-Gateway für kurzlebige Jobs. Das Diagramm * Target Scrapes * zeigt, wie oft in den letzten 5 Minuten gemessene Ziele pro Zeitreihe im Bereichsvektor abgekratzt wurden. Das Diagramm * Kratzdauer * zeigt, wie lange die Kratzer mit den als Serie verfügbaren Perzentilen dauern. Die Kratzdauer zeigt das 50. Perzentil (0,5), das 90. Perzentil (0,9). und 99. Perzentil (0,99) als drei separate Reihen, um Ausreißer zu identifizieren, die die Daten möglicherweise verzerren.

Die Abfrage * Target Scrapes * lautet wie folgt:

rate(prometheus_target_interval_length_seconds_count[5m])

Die Abfrage * Scrape Duration * lautet wie folgt:

prometheus_target_interval_length_seconds{quantile!="0.01", quantile!="0.05"}

Regelbewertungsdauer

In diesem Diagrammfeld wird die Dauer aller durchzuführenden Auswertungen dargestellt. Das 50. Perzentil (0,5), das 90. Perzentil (0,9) und das 99. Perzentil (0,99) werden als drei separate Reihen angezeigt, um Ausreißer zu identifizieren, die die Daten möglicherweise verzerren.

Schritt 4 - Analysieren der Daten vom Prometheus-Dashboard

Für einen neu laufenden Prometheus-Server sollten Ihre Grafiken ziemlich flach und klein erscheinen.

Langfristig variieren diese Diagramme stark in Abhängigkeit von Ihrem speziellen Anwendungsfall und Ihrer Arbeitslast. Im Allgemeinen möchten Sie, dass alle diese Diagramme stabil bleiben. Wenn mehr Ziele abgekratzt werden und / oder mehr Metriken exportiert werden, steigt die Anzahl der aufgenommenen Samples, Speicherserien und Ziel-Scrapes pro Sekunde - das ist zu erwarten.

Wenn Ihre Ziel-Scrapes unerwartet abfallen oder die Scrape-Latenzzeit steigt, sollten Sie die Ursache ermitteln. Beispielsweise kann ein Client mit dem Export von 1 Million Metriken anstelle der üblichen 10.000 Metriken beginnen, oder jemand kann für jeden Benutzer eine Zeitreihe mit einer anderen Bezeichnung exportieren. Beides würde zu einer erhöhten Kratzlatenz führen. Wenn ein Diagramm plötzlich aufsteigt, sollten Sie untersuchen, ob eine Anwendung nur erheblich vergrößert wurde oder ob sie möglicherweise schlecht instrumentiert ist.

Die langsame Regelauswertung ist auch ein guter Indikator dafür, dass der Knoten, auf dem der Prometheus-Server ausgeführt wird, für die Last einfach nicht ausreicht.

Schritt 5 - Anpassen von Diagrammen und Metriken

Sie haben jetzt ein Prometheus-Dashboard mit einer Reihe vorkonfigurierter Prometheus-Serverstatistiken zu Ihrer Grafana-Instanz hinzugefügt.

Mit Grafana können Sie jede auf Ihrem Prometheus-Server verfügbare Metrik visualisieren - und das alles in einem speziellen Prometheus-Abfrage-Editor. Um auf den Abfrageeditor in einem beliebigen Bereich zuzugreifen, klicken Sie auf den Bereich mit dem Paneltitel, um das Panel-Menü anzuzeigen. Klicken Sie auf * Bearbeiten *. Die Registerkarte * Metriken * ist für Sie vorgewählt und bietet direkten Zugriff auf die Abfrage und die verfügbaren Optionen für die Prometheus-Datenquelle.

Bild: https: //assets.digitalocean.com/articles/grafana_prometheus/graf-prom-animated.gif [Animated Gif]

Wenn Änderungen im Abfrageeditor vorgenommen werden, wird das Diagramm sofort aktualisiert und zeigt Ihre Änderungen an.

Fazit

Eine vollständige Liste der verfügbaren Metriken finden Sie unter http: // ++ / metrics (standardmäßig Port 9090).

Jede dieser Metriken kann kopiert und in den Grafana-Abfrageeditor eingefügt werden. Bis Sie Ihr Dashboard speichern, wird das vorhandene Dashboard durch keine Ihrer Änderungen überschrieben.

Also experimentieren Sie, haben Sie Spaß und beginnen Sie zu visualisieren!

TOC