Skip to content

Prometheus

Pulse verbindet sich als Datenquelle mit einem Prometheus-kompatiblen Metrik-Endpunkt. Pulse ruft den Endpunkt im eigenen Takt ab, speichert die zurückgegebenen Zeitreihen als Datenpunkte und macht sie für Conditions und Diagramme verfügbar.

Prometheus-Datenquelle hinzufügen

Formular für neue Prometheus-Datenquelle mit Verbindungsfeldern

  1. Navigieren Sie zu Datenquellen → Prometheus in der Seitenleiste und klicken Sie auf Neue Datenquelle
  2. Wählen Sie Prometheus
  3. Konfigurieren Sie die Datenquelle:
FeldBeschreibungBeispiel
NameEin beschreibender Name für die Datenquellenode_exporter der Appliance
Abruf-URLDie vollständige URL des Metrik-Endpunkts inklusive Pfadhttp://192.168.1.10:9100/metrics
Abrufintervall (Sekunden)Wie oft der Endpunkt abgerufen wird; eine Anfrage liefert alle Serien, die er bereitstellt15
Von dieser Datenquelle erfassenAusschalten, um den Abruf zu stoppen, ohne die Quelle zu löschen
AuthentifizierungWie Pulse sich am Endpunkt anmeldet (siehe unten)

Authentifizierung

Drei Modi stehen zur Verfügung:

ModusEinsatz
KeineDer Endpunkt ist offen oder durch Netzwerkkontrollen geschützt
Bearer-TokenDer Endpunkt erfordert einen Authorization: Bearer <token>-Header
Basic AuthDer Endpunkt erfordert Benutzername und Passwort

Geheimnisse (Tokens und Passwörter) werden nur zum Schreiben gespeichert: Pulse zeigt sie nach dem Speichern nicht mehr an. Lassen Sie das Feld beim Bearbeiten leer, um das gespeicherte Geheimnis beizubehalten; geben Sie einen neuen Wert ein, um es zu ersetzen.

Verbindung testen

Klicken Sie auf Verbindung testen, bevor Sie speichern. Pulse ruft den Endpunkt einmal ab und gibt an, wie viele Serien über wie viele Metriken gefunden wurden. Dieser Schritt ist wichtig: Eine Abrufanfrage kann Hunderte von Serien zurückliefern, und Sie möchten sehen, was Sie behalten, bevor die Erfassung beginnt.

Was diese Datenquelle erfasst

Jeder Prometheus-Abruf liefert alle Serien, die der Endpunkt bereitstellt. Der Metrikfilter entscheidet, welche dieser Serien als Datenpunkte gespeichert werden; abgelehnte Serien werden bereits beim Einlesen verworfen und werden nie zu Datenpunkten oder verbrauchen Speicher.

Der Filter hat zwei Listen:

ListeVerhalten
Diese Metriken erfassenEin Namensmuster pro Zeile. * steht für eine beliebige Zeichenfolge. Leer lassen, um alle Metriken des Endpunkts zu erfassen.
Außer diesenEin Namensmuster pro Zeile. Eine hier getroffene Metrik wird nie erfasst, auch wenn die obige Liste sie trifft.

Nachdem Sie Verbindung testen ausgeführt haben, zeigt das Filterpanel eine Live-Anzahl, wie viele Serien Ihr aktueller Filter von der Gesamtzahl behalten würde. Passen Sie die Muster an und beobachten Sie, wie sich die Anzahl ändert, bevor Sie speichern.

Erst weit, dann enger

Lassen Sie den Filter beim ersten Speichern leer, sehen Sie sich auf der Detailseite der Datenquelle an, was erfasst wird, und bearbeiten Sie die Quelle dann, um eine Ablehnliste für nicht benötigte Serien hinzuzufügen. Das ist einfacher als Muster für Metriken zu schreiben, die Sie noch nie gesehen haben.

Datenpunkte und Verlauf

Sobald eine Datenquelle erfasst, wird jede einzelne Zeitreihe zu einem Datenpunkt, der auf der Detailseite der Datenquelle angezeigt wird. Die Seite zeigt:

  • Den Metriknamen und etwaige Labels
  • Den zuletzt gelesenen Wert und den Zeitpunkt des letzten Lesens
  • Ob die Lesequalität Gut, Schlecht oder Keine Daten ist

Datenpunkte bauen nur dann einen Verlauf auf, wenn Sie sie aufbewahren. Verwenden Sie Aufbewahren auf der Detailseite der Datenquelle für Serien, die Sie langfristig grafisch darstellen oder abfragen möchten; die übrigen bleiben 24 Stunden lesbar und werden dann gelöscht.

Auf einen Wert aufmerksam machen

Um bei Überschreitung eines Prometheus-Schwellenwerts einen Alarm auszulösen, erstellen Sie eine Condition mit einem Sensor-Knoten, der auf den Datenpunkt zeigt. Eine Condition kann mehrere Datenpunkte in einer Regel kombinieren — zum Beispiel: Alarm, wenn die CPU-Auslastung den gelernten Normalwert überschreitet.

Metriktypen

Pulse speichert Prometheus-Metriktypen so, wie sie ankommen, und macht sie für Abfragen verfügbar:

TypBeschreibung
CounterEin monoton wachsender Zähler; verwenden Sie einen Anstiegsrate-Knoten in einer Condition, um ihn in eine Rate pro Sekunde umzuwandeln
GaugeEin Wert, der steigen und fallen kann
HistogramEine Stichprobenverteilung mit Anzahl-, Summen- und Bucket-Serien
SummaryEine vorberechnete Quantilverteilung
Ohne TypMetriken, die der Endpunkt nicht typisiert hat