Stellen Sie eine Connect zu einer Graphite-Datenquelle her

Grafana verfügt über einen fortschrittlichen Graphite-Abfrageeditor, mit dem Sie schnell im metrischen Raum navigieren, Funktionen hinzufügen, Funktionsparameter ändern und vieles mehr können. Der Editor kann alle Arten von Graphite-Abfragen verarbeiten. Mithilfe von Abfragereferenzen kann er sogar komplexe verschachtelte Abfragen verarbeiten.

Graphite-Einstellungen

Um auf die Graphite-Einstellungen zuzugreifen, klicken Sie auf das Konfigurationssymbol (Zahnrad), wählen Sie dann Datenquellen und dann die Graphite-Datenquelle aus.

Name	Beschreibung
Name	Der Name der Datenquelle. So sehen Sie die Datenquelle in Bedienfeldern und Abfragen.
Default	Die Standarddatenquelle bedeutet, dass sie für neue Panels vorab ausgewählt wird.
URL	Das HTTP-Protokoll, die IP und der Port Ihrer Graphite-Web- oder Graphite-API-Installation.
Access	Server (Standard) = Die URL muss vom Grafana-Backend/-Server aus zugänglich sein.
Auth
Basic Auth	Aktivieren Sie die Standardauthentifizierung für die Datenquelle.
User	Benutzername für die Standardauthentifizierung.
Password	Passwort für die Standardauthentifizierung.
Custom HTTP Headers	Wählen Sie Header hinzufügen, um einen benutzerdefinierten HTTP-Header hinzuzufügen.
Header	Geben Sie den Namen des benutzerdefinierten Headers ein.
Value	Geben Sie den benutzerdefinierten Header-Wert ein.
Graphite details
Version	Wählen Sie Ihre Version von Graphite aus.
Type	Wählen Sie Ihren Graphittyp aus.

Der Zugriffsmodus steuert, wie Anfragen an die Datenquelle behandelt werden. Der Server sollte der bevorzugte Weg sein, wenn nichts anderes angegeben ist.

Serverzugriffsmodus (Standard)

Alle Anfragen werden vom Browser an Amazon Managed Grafana gestellt, das die Anfragen an die Datenquelle weiterleitet, wodurch mögliche CORS-Anforderungen (Cross-Origin Resource Sharing) umgangen werden. Wenn Sie diesen Zugriffsmodus wählen, muss die URL von Amazon Managed Grafana aus zugänglich sein.

Browser-Zugriffsmodus

Amazon Managed Grafana unterstützt keinen direkten Browserzugriff auf die Graphite-Datenquelle.

Graphite-Abfrageeditor

Grafana enthält einen Graphite-spezifischen Abfrage-Editor, mit dem Sie Ihre Abfragen erstellen können.

Um den Rohtext der Abfrage zu sehen, die an Graphite gesendet wird, wählen Sie das Symbol Textbearbeitungsmodus umschalten (Stift).

Auswahl der abzufragenden Metriken

Wählen Sie Metrik auswählen, um im Metrikbereich zu navigieren. Nachdem Sie begonnen haben, können Sie mit dem Zeiger oder den Pfeiltasten der Tastatur weitermachen. Sie können ein Platzhalterzeichen auswählen und trotzdem fortfahren.

Funktionen

Um eine Funktion hinzuzufügen, wählen Sie das Plussymbol neben Funktion. Sie können nach der Funktion suchen oder sie aus dem Menü auswählen. Nachdem eine Funktion ausgewählt wurde, wird sie hinzugefügt und Ihr Fokus befindet sich im Textfeld des ersten Parameters. Um einen Parameter zu bearbeiten oder zu ändern, wählen Sie ihn aus und er wird zu einem Textfeld. - Um eine Funktion zu löschen, wählen Sie den Funktionsnamen gefolgt vom X-Symbol.

Einige Funktionen, wie z. B.aliasByNode, unterstützen ein optionales zweites Argument. Um ein Argument hinzuzufügen, halten Sie beim ersten Argument an und wählen Sie dann das angezeigte + Symbol aus. Um den zweiten optionalen Parameter zu entfernen, wählen Sie ihn aus und lassen Sie ihn leer. Der Editor wird ihn entfernen.

Beschriftungen sortieren

Wenn Sie eine einheitliche Reihenfolge wünschen, verwenden SiesortByName. Dies kann lästig sein, wenn Sie dieselben Beschriftungen in mehreren Diagrammen haben und beide unterschiedlich sortiert sind und unterschiedliche Farben verwenden. Um dieses Problem zu beheben, verwenden SiesortByName().

Verschachtelte Abfragen

Sie können Abfragen anhand des Zeilenbuchstabens referenzieren, in dem sie sich befinden (ähnlich wie in Microsoft Excel). Wenn Sie einem Diagramm eine zweite Abfrage hinzufügen, können Sie auf die erste Abfrage verweisen, indem Sie #A eingeben. Dies bietet eine bequeme Möglichkeit, zusammengesetzte Abfragen zu erstellen.

Vermeiden Sie viele Abfragen durch die Verwendung von Platzhalterzeichen

Gelegentlich möchten Sie vielleicht mehrere Zeitreihen in derselben Grafik dargestellt sehen. Möglicherweise möchten Sie beispielsweise sehen, wie die CPU auf einem Computer verwendet wird. Sie können das Diagramm zunächst erstellen, indem Sie für jede Zeitreihe eine Abfrage hinzufügen cpu.percent.user.gcpu.percent.system.g, z. B., usw. Dies führt dazu, dass n Abfragen an die Datenquelle gestellt werden, was ineffizient ist.

Um effizienter zu sein, können Sie bei Ihrer Suche Platzhalterzeichen verwenden, sodass alle Zeitreihen in einer Abfrage zurückgegeben werden. z. B. cpu.percent.*.g.

Ändern des Metriknamens in Tabellen oder Diagrammen

Verwenden Sie alias Funktionen, um Metriknamen in Grafana-Tabellen oder -Grafiken zu ändern, z. B. aliasByNode() oderaliasSub().

Punktkonsolidierung

Alle Graphite-Metriken werden konsolidiert, sodass Graphite nicht mehr Datenpunkte zurückgibt, als Pixel im Diagramm vorhanden sind. Standardmäßig erfolgt diese Konsolidierung mithilfe der avg Funktion. Sie können steuern, wie Graphite Metriken konsolidiert, indem Sie die Graphite ConsolidateBy-Funktion hinzufügen.

Anmerkung

Das bedeutet, dass die Zusammenfassungswerte der Legende (max., min, total) nicht alle gleichzeitig korrekt sein können. Sie werden clientseitig von Grafana berechnet. Und je nach Ihrer Konsolidierungsfunktion können nur eine oder zwei gleichzeitig korrekt sein.

Kombinieren von Zeitreihen

Um Zeitreihen zu kombinieren, wählen Sie in der Liste Funktionen die Option Kombinieren aus.

Datenerkundung und Tags

In Graphite ist alles ein Tag.

Beim Erkunden von Daten werden zuvor ausgewählte Tags verwendet, um den verbleibenden Ergebnissatz zu filtern. Um Daten auszuwählen, verwenden Sie die seriesByTag Funktion, die Tag-Ausdrücke (=,,!=,!=~) verwendet=~, um Zeitreihen zu filtern.

Der Grafana-Abfragegenerator erledigt dies automatisch für Sie, wenn Sie ein Tag auswählen.

Anmerkung

Tipp: Die Suche mit regulären Ausdrücken kann bei Tags mit hoher Kardinalität langsam sein. Versuchen Sie daher, zuerst andere Tags zu verwenden, um den Gültigkeitsbereich zu reduzieren. Wenn Sie mit einem bestimmten Namen oder Namespace beginnen, können Sie die Ergebnisse reduzieren.

Vorlagenvariablen

Anstatt Dinge wie Server-, Anwendungs- und Sensornamen in Ihren metrischen Abfragen fest zu codieren, können Sie stattdessen Variablen verwenden. Variablen werden als Drop-down-Auswahlfelder oben im Dashboard angezeigt. Sie können diese Dropdown-Felder verwenden, um die in Ihrem Dashboard angezeigten Daten zu ändern.

Weitere Informationen zu Vorlagen und Vorlagenvariablen finden Sie unter. Vorlagen und Variablen

Um eine Variable mit Tag-Werten zu erstellen, verwenden Sie die Grafana-Funktionen tags undtag_values.

Abfrage	Beschreibung
tags()	Gibt alle Tags zurück.
tags(server=~backend\*)	Gibt nur Tags zurück, die in einer Reihe vorkommen, die dem Filterausdruck entsprechen.
tag_values(server)	Gibt Tagwerte für das angegebene Tag zurück.
tag_values(server, server=~backend\*)	Gibt gefilterte Tag-Werte zurück, die für das angegebene Tag in einer Reihe vorkommen, die diesen Ausdrücken entsprechen.
tag_values(server, server=~backend\*, app=~${apps:regex})	Mehrere Filterausdrücke und Ausdrücke können andere Variablen enthalten.

Weitere Informationen finden Sie in den Graphite-Dokumenten zur Autocomplete-API für Tags.

Variable abfragen

Bei der Abfrage, die Sie im Abfragefeld angeben, sollte es sich um eine Abfrage vom Typ Metriksuche handeln. Beispielsweise füllt eine Abfrage die Variable mit allen möglichen Werten, die in der Platzhalterposition vorhanden sind. prod.servers.*

Sie können auch verschachtelte Variablen erstellen, die andere Variablen in ihrer Definition verwenden. apps.$app.servers.*Verwendet beispielsweise die Variable $app in ihrer Abfragedefinition.

Wird verwendet__searchFilter, um Ergebnisse von Abfragevariablen zu filtern

Durch die Verwendung __searchFilter im Abfragefeld wird das Abfrageergebnis auf der Grundlage dessen gefiltert, was Sie in das Drop-down-Auswahlfeld eingeben. Wenn Sie nichts eingeben, __searchFilter ist der Standardwert für * und ``, wenn es als Teil eines regulären Ausdrucks verwendet wird.

Das folgende Beispiel zeigt, wie Sie es __searchFilter als Teil des Abfragefelds verwenden können, um die Suche nach Text zu ermöglichen, server während der Benutzer Text in das Dropdownauswahlfeld eingibt.

Abfrage

apps.$app.servers.$__searchFilter

TagValues

tag_values(server, server=~${__searchFilter:regex})

Verwendung von Variablen

Sie können eine Variable in einem metrischen Knotenpfad oder als Parameter für eine Funktion verwenden.

Es gibt zwei Syntaxen:

• $<varname>Beispiel: apps.frontend. $server.requests.count

• ${varname}Beispiel: apps.frontend. $ {server} .requests.count

Warum auf zwei Arten? Die erste Syntax ist einfacher zu lesen und zu schreiben, erlaubt es Ihnen jedoch nicht, eine Variable in der Mitte eines Wortes zu verwenden. Verwenden Sie die zweite Syntax in Ausdrücken wiemy.server${serverNumber}.count.

Verwendung von Variablen in Tag-Abfragen

Variablen mit mehreren Werten in Tag-Abfragen verwenden die erweiterte Formatierungssyntax, die in Grafana 5.0 für Variablen eingeführt wurde:. {var:regex} Abfragen, die keine Tags enthalten, verwenden die Standard-Glob-Formatierung für Variablen mit mehreren Werten.

Das folgende Codebeispiel zeigt einen Tag-Ausdruck mit Regex-Formatierung und Verwendung des Equal Tilde-Operators,. =~

server=~${servers:regex}

Weitere Informationen finden Sie unter Erweiterte Optionen für das Variablenformat.

Anmerkungen

Anmerkungen ermöglichen es Ihnen, umfangreiche Ereignisinformationen über Grafiken zu legen. Sie fügen Annotationsabfragen über das Dashboard-Menü /die Ansicht Anmerkungen hinzu. Weitere Informationen finden Sie unter Anmerkungen.

Graphite unterstützt zwei Möglichkeiten, Anmerkungen abzufragen:

• Eine reguläre metrische Abfrage. Dazu verwenden Sie das Graphite-Abfragetextfeld.

• Eine Graphite-Ereignisabfrage. Dazu verwenden Sie das Graphite event tags Textfeld und geben ein Tag oder ein Platzhalterzeichen an (es sollte auch funktionieren, es leer zu lassen).