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.
Vorlage – Referenz
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die Grafana-Version 9.x unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 10.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 10
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 8
Dieser Abschnitt enthält Referenzinformationen für die Erstellung Ihrer Vorlagen.
Vorlagendaten
Die folgenden Daten werden an Nachrichtenvorlagen übergeben.
Name | Typ | Hinweise |
---|---|---|
|
Zeichenfolge |
Name der Kontaktstelle, an die die Benachrichtigung gesendet wird. |
|
Zeichenfolge |
wird ausgelöst, wenn mindestens ein Alarm ausgelöst wird, andernfalls behoben. |
|
Warnung |
Liste der Alarmobjekte, die in dieser Benachrichtigung enthalten sind (siehe unten). |
|
KeyValue |
Labels, nach denen diese Alerts gruppiert wurden. |
|
KeyValue |
Bezeichnungen, die allen in dieser Benachrichtigung enthaltenen Warnungen gemeinsam sind. |
|
KeyValue |
Anmerkungen, die allen in dieser Benachrichtigung enthaltenen Warnungen gemeinsam sind. |
|
Zeichenfolge |
Backlink zu der Grafana, die die Benachrichtigung gesendet hat. Wenn Sie einen externen Alertmanager verwenden, verlinken Sie zurück zu diesem Alertmanager. |
Der Alerts
Typ stellt zwei Funktionen zum Filtern der zurückgegebenen Warnungen zur Verfügung.
-
Alerts.Firing
— Gibt eine Liste von Auslösewarnungen zurück. -
Alerts.Resolved
— Gibt eine Liste der behobenen Alarme zurück.
Warnung (Typ)
Der Warnungstyp enthält die folgenden Daten.
Name | Typ | Hinweise |
---|---|---|
Status |
Zeichenfolge |
|
Labels |
KeyValue |
Eine Reihe von Bezeichnungen, die an die Warnung angehängt sind. |
Anmerkungen |
KeyValue |
Eine Reihe von Anmerkungen, die der Warnung beigefügt sind. |
Werte | KeyValue | Die Werte aller Ausdrücke, einschließlich der klassischen Bedingungen |
StartsAt |
Zeit.Zeit |
Uhrzeit, zu der der Alarm ausgelöst wurde. |
EndsAt |
Zeit. Zeit |
Wird nur gesetzt, wenn die Endzeit einer Warnung bekannt ist. Andernfalls wird ein konfigurierbarer Timeout-Zeitraum ab dem Zeitpunkt seit dem Empfang der letzten Warnung festgelegt. |
Generator-URL |
Zeichenfolge |
Ein Backlink zu Grafana oder einem externen Alertmanager. |
Silence-URL |
Zeichenfolge |
Ein Link zum Stummschalten der Warnung (mit bereits ausgefüllten Bezeichnungen für diese Warnung). Nur für von Grafana verwaltete Benachrichtigungen. |
Dashboard-URL |
Zeichenfolge |
Link zum Grafana-Dashboard, falls die Warnungsregel zu einer gehört. Nur für von Grafana verwaltete Benachrichtigungen. |
Panel-URL |
Zeichenfolge |
Link zum Grafana-Dashboard-Panel, falls die Warnungsregel zu einer gehört. Nur für von Grafana verwaltete Benachrichtigungen. |
Fingerabdruck |
Zeichenfolge |
Fingerabdruck, der zur Identifizierung der Warnung verwendet werden kann. |
ValueString |
Zeichenfolge |
Eine Zeichenfolge, die die Bezeichnungen und den Wert jedes reduzierten Ausdrucks in der Warnung enthält. |
ExtendedData
Das ExtendedData Objekt enthält die folgenden Eigenschaften.
Name | Art | Beschreibung | Beispiel |
---|---|---|---|
Empfänger |
|
Der Name der Kontaktstelle, die die Benachrichtigung sendet. |
|
Status |
|
Der Status ist |
|
Benachrichtigungen |
|
Liste aller ausgelösten und gelösten Alarme in dieser Benachrichtigung. |
|
Auslösewarnungen |
|
Liste aller Feuerwarnungen in dieser Benachrichtigung. |
|
Behobene Warnungen |
|
Liste aller gelösten Warnungen in dieser Benachrichtigung. |
|
GroupLabels |
|
Die Labels, die diese Warnungen in dieser Benachrichtigung gruppieren. |
|
CommonLabels |
|
Die Bezeichnungen, die allen Benachrichtigungen in dieser Benachrichtigung gemeinsam sind. |
|
CommonAnnotations |
|
Die Anmerkungen, die allen Warnungen in dieser Benachrichtigung gemeinsam sind. |
|
Externe URL |
|
Ein Link zum Grafana-Workspace oder Alertmanager, der diese Benachrichtigung gesendet hat. |
|
KeyValue geben Sie ein
Der KeyValue
Typ besteht aus einer Reihe von Schlüssel/Wert-Zeichenkettenpaaren, die Beschriftungen und Anmerkungen darstellen.
Neben dem direkten Zugriff auf die als gespeicherten Daten gibt es auch Methoden zum Sortieren, Entfernen und Transformieren der Daten. KeyValue
Name | Argumente | Rückgabewert | Hinweise | Beispiel |
---|---|---|---|---|
SortedPairs |
Sortierte Liste von Zeichenkettenpaaren aus Schlüssel und Wert |
|
||
Remove |
[] Zeichenfolge |
KeyValue |
Gibt eine Kopie der Key/Value-Map ohne die angegebenen Schlüssel zurück. |
|
Namen |
[] Zeichenfolge |
Liste der Labelnamen |
|
|
Werte |
[] Zeichenfolge |
Liste der Labelwerte |
|
Time (Zeit)
Die Zeit stammt aus dem time
Monday, 1st January 2022 at 10:00AM
, in diesem Format schreiben Sie die folgende Vorlage:
{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}
Eine Referenz für das Zeitformat von Go finden Sie hier
Funktionen der Vorlage
Mithilfe von Vorlagenfunktionen können Sie Beschriftungen und Anmerkungen verarbeiten, um dynamische Benachrichtigungen zu generieren. Die folgenden Funktionen sind verfügbar.
Name | Argumenttyp | Rückgabetyp | Beschreibung |
---|---|---|---|
|
Zahl oder Zeichenfolge |
Zeichenfolge |
Konvertiert eine Zahl mithilfe metrischer Präfixe in ein besser lesbares Format. |
|
Zahl oder Zeichenfolge |
Zeichenfolge |
Wie Humanize, verwendet aber 1024 statt 1000 als Basis. |
|
Zahl oder Zeichenfolge |
Zeichenfolge |
Konvertiert eine Dauer in Sekunden in ein besser lesbares Format. |
|
Zahl oder Zeichenfolge |
Zeichenfolge |
Konvertiert einen Verhältniswert in einen Bruchteil von 100. |
|
Zahl oder Zeichenfolge |
Zeichenfolge |
Konvertiert einen Unix-Zeitstempel in Sekunden in ein besser lesbares Format. |
|
Zeichenfolge |
Zeichenfolge |
Strings.Title schreibt das erste Zeichen jedes Worts groß. |
|
Zeichenfolge |
Zeichenfolge |
Zeichenketten. ToUpper, wandelt alle Zeichen in Großbuchstaben um. |
|
Zeichenfolge |
Zeichenfolge |
Zeichenketten. ToLower, wandelt alle Zeichen in Kleinbuchstaben um. |
|
Muster, Text |
Boolesch |
Regexp. MatchString Testet auf eine nicht verankerte Regexp-Übereinstimmung. |
|
Muster, Ersatz, Text |
Zeichenfolge |
Regexp. ReplaceAllString Regexp-Substitution, nicht verankert. |
|
string — JSON-Objekt mit Feldern und |
Zeichenfolge |
Gibt den Pfad zur grafischen Ansicht in Explore für den angegebenen Ausdruck und die angegebene Datenquelle zurück. |
|
string — JSON-Objekt mit |
Zeichenfolge |
Gibt den Pfad zur tabellarischen Ansicht in Explore für den angegebenen Ausdruck und die angegebene Datenquelle zurück. |
|
[] Schnittstelle {} |
map [string] Schnittstelle {} |
Konvertiert eine Liste von Objekten in eine Map mit Schlüsseln, zum Beispiel arg0, arg1. Verwenden Sie diese Funktion, um mehrere Argumente an Vorlagen zu übergeben. |
|
nichts |
Zeichenfolge |
Gibt eine Zeichenfolge zurück, die die externe URL darstellt. |
|
nichts |
Zeichenfolge |
Gibt den Pfad der externen URL zurück. |
Die folgende Tabelle zeigt Beispiele für die Verwendung der einzelnen Funktionen.
Funktion | TemplateString | Eingabe | Expected |
---|---|---|---|
humanisieren |
{$value humanisieren} |
1234567,0 |
1,235 M |
humanisieren Sie 1024 |
{humanise1024 $value} |
1048576,0 |
1 Minuten |
Dauer humanisieren |
{humanizeDuration $value} |
899,99 |
14 m 59 s |
Prozentsatz humanisieren |
{HumanizePercentage $value} |
0,1234567 |
12,35% |
Zeitstempel humanisieren |
{HumanizeTimestamp $value} |
1435065584,128 |
2015-06-23 13:19:44.128 +0000 UTC |
Titel |
{$wert | Titel} |
ein B C |
Ein Bb Cc |
toUpper |
{$value | toUpper} |
ein B C |
EIN B C |
toLower |
{$value | toLower} |
ein B C |
ein b c |
match |
{entspricht „a+“ $labels.instance} |
aa |
true |
reReplaceAll |
{{ reReplaceAll „localhost :( .*)“ „meine.domain: $1“ $labels.instance}} |
localhost: 3000 |
meine.domain: 3000 |
GraphLink |
{{GraphLink „{\" expr\“:\ "hoch\“,\ "Datenquelle\“:\ "gdev-prometheus\"}“} |
/erkunden? left= ["now-1h“, "now“, "gdev-prometheus“, {"datasource“ :"gdev-prometheus“, "expr“ :"up“, "instant“ :false, "range“ :true}] |
|
Link zur Tabelle |
{{TableLink „{\" expr\“:\ "nach oben\“,\ "Datenquelle\“:\ "gdev-prometheus\"}“}} |
/erkunden? left= ["now-1h“, "now“, "gdev-prometheus“, {"datasource“ :"gdev-prometheus“, "expr“ :"up“, "instant“ :true, "range“ :false}] |
|
args |
{{definiere „x"}} {{.arg0}} {{.arg1}} {{end}} {{Vorlage „x“ (Argumente 1 „2")}} |
1 2 |
|
Externe URL |
{externe URL} |
http://localhost/path/prefix |
|
Pfad-Präfix |
{Pfadpräfix} |
/Pfad/Präfix |