Vorlage – Referenz - Amazon Managed Grafana

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

Receiver

Zeichenfolge

Name der Kontaktstelle, an die die Benachrichtigung gesendet wird.

Status

Zeichenfolge

wird ausgelöst, wenn mindestens ein Alarm ausgelöst wird, andernfalls behoben.

Alerts

Warnung

Liste der Alarmobjekte, die in dieser Benachrichtigung enthalten sind (siehe unten).

GroupLabels

KeyValue

Labels, nach denen diese Alerts gruppiert wurden.

CommonLabels

KeyValue

Bezeichnungen, die allen in dieser Benachrichtigung enthaltenen Warnungen gemeinsam sind.

CommonAnnotations

KeyValue

Anmerkungen, die allen in dieser Benachrichtigung enthaltenen Warnungen gemeinsam sind.

ExternalURL

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

firing oder resolved.

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

string

Der Name der Kontaktstelle, die die Benachrichtigung sendet.

{{ .Receiver }}

Status

string

Der Status ist firing if at least one alert is firing, otherwise resolved.

{{ .Status }}

Benachrichtigungen

[]Alert

Liste aller ausgelösten und gelösten Alarme in dieser Benachrichtigung.

There are {{ len .Alerts }} alerts

Auslösewarnungen

[]Alert

Liste aller Feuerwarnungen in dieser Benachrichtigung.

There are {{ len .Alerts.Firing }} firing alerts

Behobene Warnungen

[]Alert

Liste aller gelösten Warnungen in dieser Benachrichtigung.

There are {{ len .Alerts.Resolved }} resolved alerts

GroupLabels

KeyValue

Die Labels, die diese Warnungen in dieser Benachrichtigung gruppieren.

{{ .GroupLabels }}

CommonLabels

KeyValue

Die Bezeichnungen, die allen Benachrichtigungen in dieser Benachrichtigung gemeinsam sind.

{{ .CommonLabels }}

CommonAnnotations

KeyValue

Die Anmerkungen, die allen Warnungen in dieser Benachrichtigung gemeinsam sind.

{{ .CommonAnnotations }}

Externe URL

string

Ein Link zum Grafana-Workspace oder Alertmanager, der diese Benachrichtigung gesendet hat.

{{ .ExternalURL }}

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

{{ .Annotations.SortedPairs }}

Remove

[] Zeichenfolge

KeyValue

Gibt eine Kopie der Key/Value-Map ohne die angegebenen Schlüssel zurück.

{{ .Annotations.Remove "summary" }}

Namen

[] Zeichenfolge

Liste der Labelnamen

{{ .Names }}

Werte

[] Zeichenfolge

Liste der Labelwerte

{{ .Values }}

Time (Zeit)

Die Zeit stammt aus dem timeGo-Paket. Sie können eine Uhrzeit in verschiedenen Formaten drucken. Um beispielsweise die Uhrzeit zu drucken, zu der eine Warnung ausgelöst wurdeMonday, 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

humanize

Zahl oder Zeichenfolge

Zeichenfolge

Konvertiert eine Zahl mithilfe metrischer Präfixe in ein besser lesbares Format.

humanize1024

Zahl oder Zeichenfolge

Zeichenfolge

Wie Humanize, verwendet aber 1024 statt 1000 als Basis.

humanizeDuration

Zahl oder Zeichenfolge

Zeichenfolge

Konvertiert eine Dauer in Sekunden in ein besser lesbares Format.

humanizePercentage

Zahl oder Zeichenfolge

Zeichenfolge

Konvertiert einen Verhältniswert in einen Bruchteil von 100.

humanizeTimestamp

Zahl oder Zeichenfolge

Zeichenfolge

Konvertiert einen Unix-Zeitstempel in Sekunden in ein besser lesbares Format.

title

Zeichenfolge

Zeichenfolge

Strings.Title schreibt das erste Zeichen jedes Worts groß.

toUpper

Zeichenfolge

Zeichenfolge

Zeichenketten. ToUpper, wandelt alle Zeichen in Großbuchstaben um.

toLower

Zeichenfolge

Zeichenfolge

Zeichenketten. ToLower, wandelt alle Zeichen in Kleinbuchstaben um.

match

Muster, Text

Boolesch

Regexp. MatchString Testet auf eine nicht verankerte Regexp-Übereinstimmung.

reReplaceAll

Muster, Ersatz, Text

Zeichenfolge

Regexp. ReplaceAllString Regexp-Substitution, nicht verankert.

graphLink

string — JSON-Objekt mit Feldern und expr datasource

Zeichenfolge

Gibt den Pfad zur grafischen Ansicht in Explore für den angegebenen Ausdruck und die angegebene Datenquelle zurück.

tableLink

string — JSON-Objekt mit expr und datasource -Feldern

Zeichenfolge

Gibt den Pfad zur tabellarischen Ansicht in Explore für den angegebenen Ausdruck und die angegebene Datenquelle zurück.

args

[] 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.

externalURL

nichts

Zeichenfolge

Gibt eine Zeichenfolge zurück, die die externe URL darstellt.

pathPrefix

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