Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
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.g
cpu.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).