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.
# Nutze deinen Grafana-Workspace
'\$1 | Gibt eine Werteliste für ein Feld zurück, wobei die Begriffsaggregation und ein bestimmter Lucene-Abfragefilter verwendet werden. Query verwendet den aktuellen Dashboard-Zeitraum als Zeitbereich für die Abfrage. |
Für Begriffsabfragen gilt eine Standardgrößenbeschränkung von 500. Um ein benutzerdefiniertes Limit festzulegen, legen Sie die Größeneigenschaft in Ihrer Abfrage fest. Sie können andere Variablen in der Abfrage verwenden. Das folgende Codebeispiel zeigt die Abfragedefinition für eine Variable mit dem Namen`$host`.
```
{"find": "terms", "field": "@hostname", "query": "@source:$source"}
```
Im vorherigen Beispiel verwenden wir eine andere Variable, die `$source` innerhalb der Abfragedefinition benannt ist. Immer wenn Sie mithilfe der Dropdownliste den aktuellen Wert der `$source` Variablen ändern, wird eine Aktualisierung der `$host` Variablen initiiert. Nach der Aktualisierung enthält die `$host` Variable nur Hostnamen, die in diesem Fall nach der `@source` Dokumenteigenschaft gefiltert wurden.
Diese Abfragen geben standardmäßig Ergebnisse in der Reihenfolge der Begriffe zurück (die dann wie bei jeder Variablen alphabetisch oder numerisch sortiert werden können). Um eine Liste von Begriffen zu erstellen, die nach der Anzahl der Dokumente sortiert sind (eine Liste mit den wichtigsten N-Werten), fügen Sie eine `orderBy` Eigenschaft von hinzu. `doc_count` Dadurch wird automatisch eine absteigende Sortierung ausgewählt. Die Verwendung `asc` mit doc\$1count (einer Liste unter N) kann durch Einstellung erfolgen`order: "asc"`, aber davon wird abgeraten, da dadurch der Fehler bei der Anzahl der Dokumente zunimmt. ****Um Begriffe in der Reihenfolge der Anzahl der Dokumente beizubehalten, setzen Sie die Dropdownliste Sortieren der Variablen auf Deaktiviert.**** Alternativ können Sie auch weiterhin **Alphabetisch** verwenden, um sie neu zu sortieren.
```
{"find": "terms", "field": "@hostname", "orderBy": "doc_count"}
```
### Verwenden von Variablen in Abfragen
`Beispiel: @hostname: \$1hostname
+ `[[varname]]`Beispiel: @hostname: [[hostname]]
Warum zwei Möglichkeiten? Die erste Syntax ist einfacher zu lesen und zu schreiben, erlaubt es Ihnen jedoch nicht, eine Variable in der Mitte eines Wortes zu verwenden. Wenn die Optionen *Mehrwert* oder *Alle Werte einbeziehen* aktiviert sind, konvertiert Grafana die Beschriftungen von Klartext in eine Lucene-kompatible Bedingung.
Im vorherigen Beispiel haben wir eine Lucene-Abfrage, die Dokumente anhand der Eigenschaft mithilfe einer Variablen namens filtert. `@hostname` `$hostname` Sie verwendet auch eine Variable im Eingabefeld *Begriffe* gruppieren nach Feld. Auf diese Weise können Sie mithilfe einer Variablen schnell ändern, wie die Daten gruppiert sind.
## Anmerkungen
[${__range_s}s]) != )
Regex:
```
### Verwenden einer Variablen `$__rate_interval`
`Beispiel: rate (http\$1requests\$1total \$1job=\$1"\$1job "\$1 [5m])
+ `[[varname]]`Beispiel: rate (http\$1requests\$1total \$1job=\$1 "[[job]]"\$1 [5m])
Warum zwei Möglichkeiten? Die erste Syntax ist einfacher zu lesen und zu schreiben, erlaubt es Ihnen jedoch nicht, eine Variable in der Mitte eines Wortes zu verwenden. Wenn die Optionen *Mehrwert* oder *Alle Werte einbeziehen* aktiviert sind, konvertiert Grafana die Beschriftungen von Klartext in eine Regex-kompatible Zeichenfolge. Was bedeutet, dass Sie anstelle von verwenden müssen. `=~` `=`
## Anmerkungen
`Beispiel: apps.frontend. \$1server.requests.count
+ `${varname}`Beispiel: apps.frontend. \$1 \$1server\$1 .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 wie`my.server${serverNumber}.count`.
### Verwendung von Variablen in Tag-Abfragen
` Beispiel: `metric.label.$metric_label`
+ `[[varname]]` Beispiel: `metric.label.[[metric_label]]`
Warum zwei Möglichkeiten? Die erste Syntax ist einfacher zu lesen und zu schreiben, erlaubt es Ihnen jedoch nicht, eine Variable in der Mitte eines Wortes zu verwenden. Wenn die Optionen *Mehrwert* oder *Alle Werte einbeziehen* aktiviert sind, konvertiert Grafana die Labels von Klartext in eine Regex-kompatible Zeichenfolge, was bedeutet, dass Sie sie anstelle von verwenden müssen. `=~` `=`
## Anmerkungen
`Beispiel mit einer Vorlagenvariablen namens`hostname`:
```
SELECT
atimestamp time,
aint value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp
```
`[[varname]]`Beispiel mit einer Vorlagenvariablen namens`hostname`:
```
SELECT
atimestamp as time,
aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp
```
#### Ausschalten der Anführungszeichen für Variablen mit mehreren Werten
`Beispiel mit einer Template-Variablen namens`hostname`:
```
SELECT
UNIX_TIMESTAMP(atimestamp) as time,
aint as value,
avarchar as metric
FROM my_table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp ASC
```
`[[varname]]`Beispiel mit einer Vorlagenvariablen namens`hostname`:
```
SELECT
UNIX_TIMESTAMP(atimestamp) as time,
aint as value,
avarchar as metric
FROM my_table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp ASC
```
#### Ausschalten der Anführungszeichen für Variablen mit mehreren Werten
'\$1 | Gibt eine Werteliste für ein Feld zurück, wobei die Begriffsaggregation und ein bestimmter Lucene-Abfragefilter verwendet werden. Query verwendet den aktuellen Dashboard-Zeitraum als Zeitbereich für die Abfrage. |
Für Begriffsabfragen gilt eine Standardgrößenbeschränkung von 500. Um ein benutzerdefiniertes Limit festzulegen, legen Sie die Größeneigenschaft in Ihrer Abfrage fest. Sie können andere Variablen in der Abfrage verwenden. Das folgende Codebeispiel zeigt die Abfragedefinition für eine Variable mit dem Namen`$host`.
```
{"find": "terms", "field": "@hostname", "query": "@source:$source"}
```
Im vorherigen Beispiel verwenden wir eine andere Variable, die `$source` innerhalb der Abfragedefinition benannt ist. Immer wenn Sie den aktuellen Wert der Variablen über die Dropdownliste ändern, wird eine Aktualisierung der `$source` `$host` Variablen initiiert. Nach dem Update enthält die `$host` Variable nur Hostnamen, die in diesem Fall nach der `@source` Dokumenteigenschaft gefiltert wurden.
Diese Abfragen geben standardmäßig Ergebnisse in der Reihenfolge der Begriffe zurück (die dann wie bei jeder Variablen alphabetisch oder numerisch sortiert werden können). Um eine Liste von Begriffen zu erstellen, die nach der Anzahl der Dokumente sortiert sind (eine Liste mit den wichtigsten N-Werten), fügen Sie eine `orderBy` Eigenschaft von hinzu. `doc_count` Dadurch wird automatisch eine absteigende Sortierung ausgewählt. Die Verwendung `asc` mit doc\$1count (einer Liste unter N) kann durch Einstellung erfolgen`order: "asc"`, aber davon wird abgeraten, da dadurch der Fehler bei der Anzahl der Dokumente zunimmt. ****Um Begriffe in der Reihenfolge der Anzahl der Dokumente beizubehalten, setzen Sie die Dropdownliste Sortieren der Variablen auf Deaktiviert.**** Alternativ können Sie auch weiterhin **Alphabetisch** verwenden, um sie neu zu sortieren.
```
{"find": "terms", "field": "@hostname", "orderBy": "doc_count"}
```
#### Verwenden von Variablen in Abfragen
`Beispiel: @hostname: \$1hostname
+ `[[varname]]`Beispiel: @hostname: [[hostname]]
Warum zwei Möglichkeiten? Die erste Syntax ist einfacher zu lesen und zu schreiben, erlaubt es Ihnen jedoch nicht, eine Variable in der Mitte eines Wortes zu verwenden. Wenn die Optionen *Mehrwert* oder *Alle Werte einbeziehen* aktiviert sind, konvertiert Grafana die Beschriftungen von Klartext in eine Lucene-kompatible Bedingung.
Im vorherigen Beispiel haben wir eine Lucene-Abfrage, die Dokumente anhand der Eigenschaft mithilfe einer Variablen namens filtert. `@hostname` `$hostname` Sie verwendet auch eine Variable im Eingabefeld *Begriffe* gruppieren nach Feld. Auf diese Weise können Sie mithilfe einer Variablen schnell ändern, wie die Daten gruppiert sind.
### Anmerkungen
`Beispiel mit einer Template-Variablen namens`hostname`:
```
SELECT
atimestamp as time,
aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp ASC
```
`[[varname]]`Beispiel mit einer Vorlagenvariablen namens`hostname`:
```
SELECT
atimestamp as time,
aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp ASC
```
#### Ausschalten der Anführungszeichen für Variablen mit mehreren Werten
`(Jeder metrische Pfad kann angegeben werden)
## Tasten der Legende
` Variablen im Feld „Alias by“. Beispiel mit metrischem Ausdruck =`avg:system.load.5{*}`: „Alias by“ Feldeingabe: Feldeingabe `$1: $2 seconds` RegExp „Alias“: `avg:(.+)\.(\d)` Ergebnis: `system.load: 5 seconds`
+ Wird verwendet`$0`, um den gesamten Ausdruck abzurufen. Beispiel mit metrischem Ausdruck =`datadog.dogstatsd.packet.count{*}`: „Alias by“ Feldeingabe: Feldeingabe `Expression: $0` RegExp „Alias“: `DOGstatsd\.(.*)\.(.*){\*}/i` Ergebnis: `Expression: datadog.dogstatsd.packet.count{*}`
Hinweis: Sie erhalten eine Fehlermeldung, wenn Sie die Gruppennummer angeben, die nicht existiert.
#### Metrische Arithmetik
Server: $__nr_server Metric: $__nr_metric
```
### Vorlagen und Variablen
applications
```
Liste der verfügbaren Metriken für eine Anwendung:
```
applications/{application_id}/metrics
```
### NRQL-Makros
SELECT average(value) FROM $event_template_variable
$__timeFilter TIMESERIES
```
Weitere Hinweise zur Verwendung von Makros und Vorlagenvariablen finden Sie im Hilfebereich des Editors.
### Alarmereignisse
`Beispiel mit einer Template-Variablen namens`hostname`:
```
SELECT
"atimestamp" as time,
"aint" as value
FROM table
WHERE $__timeFilter("atimestamp") AND "hostname" IN('$hostname')
ORDER BY "atimestamp" ASC
```
`[[varname]]`Beispiel mit einer Vorlagenvariablen namens`hostname`:
```
SELECT
"atimestamp" as time,
"aint" as value
FROM table
WHERE $__timeFilter("atimestamp") AND "hostname" IN('[[hostname]]')
ORDER BY atimestamp ASC
```
# Stellen Sie eine Connect zu einer Salesforce-Datenquelle her
PASSWORD NO FORCE_FIRST_PASSWORD_CHANGE;
```
Erlauben Sie dem Benutzer anschließend, das System über Clients wie Grafana wie folgt zu verbinden:
```
ALTER USER ENABLE CLIENT CONNECT;
```
Geben Sie dem Benutzer abschließend Zugriff auf die erforderlichen Ansichten, Tabellen und Schemas.
```
ALTER USER GRANT ROLE PUBLIC;
GRANT SELECT ON SCHEMA TO ;
```
**Berechtigungen auf Benutzerebene**
Beschränken Sie den Zugriff auf SAP HANA, indem Sie auf der Datenquellenkonfigurationsseite auf die Registerkarte Berechtigungen klicken, um Datenquellenberechtigungen zu aktivieren. Auf der Berechtigungsseite können Administratoren Berechtigungen aktivieren und Abfrageberechtigungen auf bestimmte Benutzer und Teams beschränken.
## Abfrage-Editor
)`— Wendet den Zeitraum von Grafana auf die angegebene Spalte an, wenn er in der Rohabfrage verwendet wird. Gilt für date/timestamp/long Zeitspalten.
+ `$__timeFilter(, )`— Wie oben. Bietet jedoch die Möglichkeit, das Format der in der Datenbank gespeicherten time\$1column anzugeben.
+ `$__timeFilter(, "epoch", )`— Wie oben, kann aber verwendet werden, wenn sich Ihre Zeitspalte in der Epoche befindet. Das Format kann aus 's', 'ms' und 'ns' bestehen.
+ `$__fromTimeFilter()`— Wie oben, kann aber verwendet werden, wenn Ihre Zeitspalte im Epochenformat ist. Das Format kann aus 's', 'ms' und 'ns' bestehen.
+ `$__fromTimeFilter(, )`— Wie oben, kann aber comparison\$1predicate angeben.
+ `$__fromTimeFilter(, )`— Wie oben, kann aber das Format der Zeitspalte angeben.
+ `$__fromTimeFilter(, , )`— Wie oben, kann aber comparison\$1predicate angeben.
+ `$__toTimeFilter()`— Gibt die Zeitbedingung auf der Grundlage von Grafanas zur Zeit in einem Zeitfeld zurück.
+ `$__toTimeFilter(, )`— Wie oben, kann aber comparison\$1predicate angeben.
+ `$__toTimeFilter(, )`— Wie oben, kann aber das Format der Zeitspalte angeben.
+ `$__toTimeFilter(, )`— Wie oben, kann aber comparison\$1predicate angeben.
+ `$__timeGroup(, )`— Erweitert die Zeitspalte in Intervallgruppen. Gilt für date/timestamp/long Zeitspalten..
**Makro \$1\$1\$1timeFilter ()**
Das folgende Beispiel erklärt das Makro: `$__timeFilter()`
```
- In the following example, the query
select ts, temperature from weather where $__timeFilter(ts)
--- will be translated into
select ts, temperature from weather where ts > '2021-02-24T12:52:48Z' AND ts < '2021-03-24T12:52:48Z'
--- where you can see the grafana dashboard's time range is applied to the column ts in the query.
```
**Makro \$1\$1\$1timeFilter (,)**
In einigen Fällen werden Zeitspalten in der Datenbank in benutzerdefinierten Formaten gespeichert. Im folgenden Beispiel wird das `$__timeFilter(, )` Makro erklärt, mit dessen Hilfe benutzerdefinierte Zeitstempel auf der Grundlage der Zeitauswahl von grafana gefiltert werden können:
```
SELECT TO_TIMESTAMP("TS",'YYYYMMDDHH24MISS') AS METRIC_TIME , "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TS","YYYYMMDDHH24MISS") -- TS is in 20210421162012 format
SELECT TO_TIMESTAMP("TS",'YYYY-MON-DD') AS METRIC_TIME , "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TS","YYYY-MON-DD") -- TS is in 2021-JAN-15 format
```
Im Makro kann das Format eines der gültigen HANA-Formate sein, die Ihrer Zeitstempelspalte entsprechen. `YYYYMMDDHH24MISS`Ist beispielsweise ein gültiges Format, wenn Ihre Daten im `20210421162012` Format gespeichert werden.
**Makro \$1\$1\$1timeFilter (, „epoch“)**
In einigen Fällen werden Zeitstempel als Epochenzeitstempel in Ihrer Datenbank gespeichert. Das folgende Beispiel erklärt das `$__timeFilter(, "epoch" )` Makro, das hilft, Epochenzeitstempel auf der Grundlage von Grafanas Zeitauswahl zu filtern. Im Makro kann das Format ms, s oder ns sein. Wenn nicht angegeben, wird s als Standardformat behandelt.
```
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP") AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch") -- Example : TIMESTAMP field stored in epoch_second format 1257894000
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP") AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch","s") -- Example : TIMESTAMP field stored in epoch_second format 1257894000
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP"/1000) AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch","ms") -- Example : TIMESTAMP field stored in epoch_ms format 1257894000000
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP"/1000000000) AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch","ns") -- Example : TIMESTAMP field stored in epoch_nanoseconds format 1257894000000000000
```
Anstatt das dritte Argument für den \$1\$1\$1timeFilter zu verwenden, können Sie eines von epoch\$1s, epoch\$1ms oder epoch\$1ns als Ihr zweites Argument verwenden..
```
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP"/1000) AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch","ms")
-- is same as
SELECT ADD_SECONDS('1970-01-01', "TIMESTAMP"/1000) AS "METRIC_TIME", "VALUE" FROM "SCH"."TBL" WHERE $__timeFilter("TIMESTAMP","epoch_ms")
```
**fromTimeFilterDie toTimeFilter Makros \$1\$1\$1 () und \$1\$1\$1 ()**
Das `$__fromTimeFilter()` Makro wird auf eine Bedingung über ein Zeitfeld ausgedehnt, die auf der From-Zeit der Grafana-Zeitauswahl basiert.
Dies akzeptiert drei Parameter. Der erste Parameter ist der Name des Zeitfeldes. Sie können comparison\$1predicate oder das Format der Zeitspalte als zweites Argument übergeben. Wenn Sie beide übergeben möchten, ist format der zweite Parameter und Sie verwenden comparison\$1predicate als dritten Parameter.
****Wenn das Format nicht angegeben ist, geht das Plugin davon aus, dass es sich bei der Zeitspalte um einen Typ handelt. timestamp/date Wenn Ihre Zeitspalte in einem anderen Format als Zeitstempel/Datum gespeichert ist, übergeben Sie das Format als zweites Argument. kann eines der Formate epoch\$1s, epoch\$1ms, epoch\$1ns oder ein anderes benutzerdefiniertes Format sein. YYYY-MM-DD
****optionaler Parameter. Wenn nicht übergeben, verwendet das Plugin > als Vergleichsprädikat. kann einer von =,\$1 sein =, <>, <, <=, >, >=
`$__toTimeFilter()`funktioniert genauso wie fromTimeFilter \$1\$1\$1 (). Anstatt Grafanas from time zu verwenden, wird es to time verwenden. Außerdem wird das Standard-Vergleichsprädikat < sein.
**\$1\$1\$1timeGroup (,)**
Beispielsweise wird das Makro \$1\$1\$1timeGroup (timecol,1h) in der Abfrage zu SERIES\$1ROUND („timecol“, 'INTERVAL 1 HOUR') erweitert.
Das folgende Beispiel erklärt `$__timeGroup(, ) macro.`
```
SELECT $__timeGroup(timestamp,1h), "user", sum("value") as "value"
FROM "salesdata"
WHERE $__timeFilter("timestamp")
GROUP BY $__timeGroup(timestamp,1h), "user"
ORDER BY $__timeGroup(timestamp,1h) ASC
```
Dies wird in die folgende Abfrage übersetzt, in der `$__timeGroup(timestamp,1h)` es erweitert wird`SERIES_ROUND("timestamp", 'INTERVAL 1 HOUR')`.
```
SELECT SERIES_ROUND("timestamp", 'INTERVAL 1 HOUR') as "timestamp", "user", sum("value") as "value"
FROM "salesdata"
WHERE "timestamp" > '2020-01-01T00:00:00Z' AND "timestamp" < '2020-01-01T23:00:00Z'
GROUP BY SERIES_ROUND("timestamp", 'INTERVAL 1 HOUR'), "user"
ORDER BY "timestamp" ASC
```
**Anmerkung**
Wenn Sie das Makro „Gruppieren nach“ zusammen mit dem Makro „\$1\$1\$1timeGroup“ verwenden, stellen Sie sicher, dass das Feld „Auswählen, Sortieren nach“ denselben Namen hat wie das Makro „Gruppieren nach Feld“. Andernfalls erkennt HANA die Abfrage möglicherweise nicht.
Wenn Sie das Intervall in der Funktion \$1\$1\$1timeGroup () nicht fest codieren möchten, können Sie das Grafana überlassen, indem Sie \$1\$1\$1interval als Ihr Intervall angeben. Grafana berechnet dieses Intervall aus dem Dashboard-Zeitbereich. Beispielabfrage:
```
SELECT $__timeGroup(timestamp, $__interval), sum("value") as "value"
FROM "salesdata"
WHERE $__timeFilter("timestamp")
GROUP BY $__timeGroup(timestamp, $__interval)
ORDER BY $__timeGroup(timestamp, $__interval) ASC
```
Diese Abfrage wird basierend auf dem Dashboard-Zeitraum in die folgende Abfrage übersetzt.
```
SELECT SERIES_ROUND("timestamp", 'INTERVAL 1 MINUTE'), sum("value") as "value"
FROM "salesdata"
WHERE "timestamp" > '2019-12-31T23:09:14Z' AND "timestamp" < '2020-01-01T23:17:54Z'
GROUP BY SERIES_ROUND("timestamp", 'INTERVAL 1 MINUTE')
ORDER BY SERIES_ROUND("timestamp", 'INTERVAL 1 MINUTE') ASC
```
### Warnfunktion
FROM
```
Im folgenden Beispiel hat eine Tabelle vier Felder mit den Namen Benutzername, Alter, Stadt und Rolle. Diese Tabelle hat kein Zeitfeld. Wir möchten Sie benachrichtigen, wenn die Anzahl der Benutzer mit Entwicklerrolle unter drei liegt.
```
SELECT TO_TIMESTAMP('${__to:date}'), count(*) as "count" FROM (
SELECT 'John' AS "username", 32 AS "age", 'Chennai' as "city", 'dev' as "role" FROM dummy
UNION ALL SELECT 'Jacob' AS "username", 32 AS "age", 'London' as "city", 'accountant' as "role" FROM dummy
UNION ALL SELECT 'Ali' AS "username", 42 AS "age", 'Delhi' as "city", 'admin' as "role" FROM dummy
UNION ALL SELECT 'Raja' AS "username", 12 AS "age", 'New York' as "city", 'ceo' as "role" FROM dummy
UNION ALL SELECT 'Sara' AS "username", 35 AS "age", 'Cape Town' as "city", 'dev' as "role" FROM dummy
UNION ALL SELECT 'Ricky' AS "username", 25 AS "age", 'London' as "city", 'accountant' as "role" FROM dummy
UNION ALL SELECT 'Angelina' AS "username", 31 AS "age", 'London' as "city", 'cxo' as "role" FROM dummy
) WHERE "role" = 'dev'
```
# Connect zu einer ServiceNow Datenquelle herstellen
`Beispiel mit einer Template-Variablen namens`hostname`:
`[[varname]]`Beispiel mit einer Vorlagenvariablen namens`hostname`:
## Warnfunktion
,
,
,
<...>
from
where
$__timeFilter() // predefined where clause for time range
and $ = 1 // custom variables start with dollar sign
```
#### SQL-Abfrageformat für Zeitreihen, gruppiert nach Intervall
,
,
from
where
$__timeFilter() // predefined where clause for time range
and $ = 1 // custom variables start with dollar sign
group by
```
#### SQL-Abfrageformat für Tabellen
, // optional if result format option is table
from
where
$__timeFilter(time_column) // macro for time range, optional if format as option is table
and $ = 1 // custom variables start with dollar sign
```
### Schritt 3: Vorlagenvariablen erstellen und verwenden
from
WHERE column >= '$variable'
```
Das folgende Beispiel zeigt die Verwendung von Variablen mit mehreren Werten in einer Abfrage.
```
select
from
WHERE regexp '${variable:regex}'
```
#### Verwenden der Snowflake-Datenquelle zum Erstellen von Variablen
` Zum Beispiel `-1w`. [Die Zeiteinheit](https://docs.splunk.com/Documentation/Splunk/latest/Search/Specifytimemodifiersinyoursearch) kann sein`s, m, h, d, w, mon, q, y`.
#### Suchmodus für Variablen
): ts (...)
**Hinweise**
+ Das s am Ende jedes Abfragetyps ist optional
+ Support für alle Kleinbuchstaben. Sie können Tagnamen oder TagNames verwenden, aber keine TAGNAMES.
+ Die Verwendung von Leerzeichen um das: ist optional
**WARNUNG**
`Multi-value`und `Include All option` werden derzeit nicht vom Wavefront-Plugin unterstützt.
#### Verwenden von Vorlagenvariablen
` an das Ende an. Um Geschäftsperioden, Nutzungs `fQ (fiscal quarter)` - und `fy (fiscal year)` Zeiteinheiten anzuzeigen.
Mit dem Plus-Operator können Sie im Vergleich zur aktuellen Zeit einen Schritt vorwärts machen. Sie können diese Funktion beispielsweise verwenden, um sich die prognostizierten Daten für die future anzusehen.
Die folgende Tabelle enthält Beispiele für relative Bereiche.
| Beispiel für einen relativen Bereich | Aus | Bis |
| --- | --- | --- |
| Letzte 5 Minuten | `now-5m` | `now` |
| Der Tag bis jetzt | `now/d` | `now` |
| Diese Woche | `now/w` | `now/w` |
| Diese Woche bis jetzt | `now/w` | `now` |
| In diesem Monat | `now/M` | `now/M` |
| Bisher in diesem Monat | `now/M` | `now` |
| Voriger Monat | `now-1M/M` | `now-1M/M` |
| Bisher in diesem Jahr | `now/Y` | `now` |
| Dieses Jahr | `now/Y` | `now/Y` |
| Vorheriges Geschäftsjahr | `now-1y/fy` | `now-1y/fy` |
**Anmerkung**
Grafana Alerting unterstützt die folgenden Syntaxen nicht:
`now+n`für future Zeitstempel.
`now-1n/n`für *Anfang von n bis Ende von n*, weil dies ein absoluter Zeitstempel ist.
**Allgemeine Steuerelemente für den Zeitbereich**
Die Zeitsteuerungen im Dashboard und im Panel haben eine gemeinsame Benutzeroberfläche. Im Folgenden werden allgemeine Steuerelemente für den Zeitbereich beschrieben.
+ Der aktuelle Zeitraum, auch *Zeitauswahl genannt, zeigt den Zeitraum* an, der aktuell in dem Dashboard oder Panel angezeigt wird, das Sie gerade betrachten. Bewegen Sie den Mauszeiger über das Feld, um die genauen Zeitstempel im Bereich und deren Quelle (z. B. die lokale Browserzeit) zu sehen. Klicken Sie auf den *aktuellen Zeitraum*, um ihn zu ändern. Sie können die aktuelle Uhrzeit anhand eines *relativen Zeitbereichs*, z. B. der letzten 15 Minuten, oder eines absoluten Zeitbereichs, z. B. `2020-05-14 00:00:00` bis, ändern`2020-05-15 23:59:59`.
+ Der **relative Zeitraum** kann aus der Liste **Relative Zeitbereiche** ausgewählt werden. Sie können die Liste mithilfe des Eingabefeldes oben filtern. Einige Beispiele für Zeiträume sind *Letzte 30 Minuten*, *Letzte 12 Stunden*, *Letzte 7 Tage*, *Letzte 2 Jahre*, *Gestern*, *Vorgestern*, Heute *letzte Woche*, *Heute bis jetzt*, *Diese Woche bis* jetzt und *Dieser Monat bisher*.
+ Der **absolute Zeitraum** kann auf zwei Arten festgelegt werden: Geben Sie exakte Zeitwerte oder relative Zeitwerte in die Felder **Von** und Bis ein und klicken Sie **auf** **Zeitbereich übernehmen**, oder klicken Sie auf ein Datum oder einen Datumsbereich aus dem Kalender, der angezeigt wird, wenn Sie auf das Feld **Von** oder **Bis** klicken. Um Ihre Auswahl zu übernehmen, klicken Sie auf **Zeitbereich übernehmen**. Sie können auch aus einer Liste der zuletzt verwendeten absoluten Zeitbereiche wählen.
+ **Ein halbrelativer Zeitraum** kann in den Einstellungen für den absoluten Zeitbereich ausgewählt werden. Um beispielsweise Aktivitäten seit einem bestimmten Datum anzuzeigen, können Sie eine absolute Zeit für die Startzeit und eine relative Zeit (z. B.`now`) für die Endzeit wählen.
Wenn Sie einen halbreativen Zeitraum verwenden, wird Ihr Dashboard im Laufe der Zeit automatisch und schrittweise verkleinert, sodass mehr Verlauf und weniger Details angezeigt werden. Gleichzeitig werden historische Trends über den gesamten Zeitraum deutlicher, wenn die hohe Datenauflösung abnimmt.
**Anmerkung**
Semirelative Zeitbereiche werden von Warnmeldungen nicht unterstützt.
+ **Verkleinern** Sie die Ansicht, indem Sie das Verkleinern-Symbol auswählen (oder indem Sie Cmd\$1Z oder Strg\$1Z als Tastenkombination verwenden). Dadurch wird die Ansicht vergrößert und ein größerer Zeitraum im Dashboard oder in der Bedienfeldvisualisierung angezeigt.
+ **Vergrößern** Sie die Ansicht, indem Sie einen Zeitraum auswählen, den Sie im Diagramm in der Visualisierung anzeigen möchten.
**Anmerkung**
Das Vergrößern ist nur für Grafikvisualisierungen verfügbar.
**Aktualisieren Sie die Dashboards**
Klicken Sie auf das Symbol „**Dashboard aktualisieren**“, um sofort jede Abfrage im Dashboard auszuführen und die Visualisierungen zu aktualisieren. Grafana storniert alle ausstehenden Anfragen, wenn Sie eine Aktualisierung auslösen.
Standardmäßig aktualisiert Grafana das Dashboard nicht automatisch. Abfragen werden gemäß den Panel-Einstellungen nach ihrem eigenen Zeitplan ausgeführt. Wenn Sie das Dashboard jedoch regelmäßig aktualisieren möchten, klicken Sie auf den Abwärtspfeil neben dem Symbol „**Dashboard aktualisieren**“ und wählen Sie dann ein Aktualisierungsintervall aus.
**Steuern Sie den Zeitraum mithilfe einer URL**
Sie können den Zeitraum eines Dashboards steuern, indem Sie die folgenden Abfrageparameter in der Dashboard-URL angeben.
+ `from`definiert die Untergrenze des Zeitbereichs, angegeben in ms, Epoche oder [relativer Zeit](#v10-dash-setting-dashboard-time-range).
+ `to`definiert die Obergrenze des Zeitbereichs, angegeben in ms Epoche oder relativer Zeit.
+ `time`und `time.window` definiert einen Zeitbereich von `time-time.window/2` bis`time+time.window/2`. Beide Parameter sollten in ms angegeben werden. Zum Beispiel `?time=1500000000000&time.window=10000` ergibt sich ein 10s-Zeitbereich von 1499999995000 bis 1500000005000.
# Dashboards erstellen
Vergleichsansicht **auf die** Schaltfläche In Version wiederherstellen** klicken. Wenn Sie eine dieser Optionen auswählen, werden Sie aufgefordert, die Wiederherstellung zu bestätigen.
Nach der Wiederherstellung auf eine frühere Version wird eine neue Version erstellt, die genau dieselben Daten wie die vorherige Version enthält, nur mit einer anderen Versionsnummer. Dies wird in der **Spalte „Hinweise“** für die Zeile in der neuen Dashboard-Version angezeigt. Dadurch wird sichergestellt, dass Ihre vorherigen Dashboard-Versionen von der Änderung nicht betroffen sind.
# Dashboard-Links verwalten
.
In der Playlist werden alle Dashboards für die im `Interval` Feld angegebene Zeit angezeigt, die beim Erstellen oder Bearbeiten einer Playlist festgelegt wurde. Nachdem eine Playlist gestartet wurde, kannst du sie über die Navigationsleiste am oberen Bildschirmrand steuern.
| Mode | Description |
| --- | --- |
| Normaler Modus | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v10-dash-managing-playlists.html) |
| TV-Modus | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v10-dash-managing-playlists.html) |
| TV-Modus (mit Panels zur auto Anpassung) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v10-dash-managing-playlists.html) |
| Kiosk-Modus | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v10-dash-managing-playlists.html) |
| Kioskmodus (mit Panels zur auto Anpassung) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/v10-dash-managing-playlists.html) |
**Steuerung einer Playlist**
Sie können eine Playlist nach dem Start im **Normal** - oder **TV-Modus** steuern, indem Sie die Navigationsleiste oben auf dem Bildschirm verwenden. Drücken Sie die `Esc` Taste auf Ihrer Tastatur, um die Playlist zu beenden.
| Button | Action |
| --- | --- |
| Weiter (Doppelpfeil nach rechts) | Wechselt zum nächsten Dashboard. |
| Zurück (linker Pfeil) | Kehrt zum vorherigen Dashboard zurück. |
| Stopp (quadratisch) | Beendet die Playlist und wechselt zum aktuellen Dashboard. |
| Modus „Zyklusansicht“ (Monitorsymbol) | Dreht die Anzeige der Dashboards in verschiedenen Ansichtsmodi. |
| Zeitraum | Zeigt Daten innerhalb eines Zeitbereichs an. Es kann so eingestellt werden, dass die letzten 5 Minuten vor bis zu 5 Jahren oder ein benutzerdefinierter Zeitraum mit dem Abwärtspfeil angezeigt werden. |
| Aktualisieren (Kreispfeil) | Lädt das Dashboard neu, um die aktuellen Daten anzuzeigen. Über den Dropdown-Pfeil kann es so eingestellt werden, dass es automatisch alle 5 Sekunden bis 1 Tag neu geladen wird. |
## Eine Playlist erstellen
Variablenwerte werden immer mit der Syntax var- =value mit der URL synchronisiert.
**Beispiele**
Variablen werden in Dropdownlisten oben auf dem Bildschirm aufgeführt. Wählen Sie verschiedene Variablen aus, um zu sehen, wie sich die Visualisierungen ändern.
Um die Variableneinstellungen zu sehen, navigieren Sie zu **Dashboard-Einstellungen >** Variablen. Klicken Sie in der Liste auf eine Variable, um ihre Einstellungen zu sehen.
Variablen können in Titeln, Beschreibungen, Textfeldern und Abfragen verwendet werden. Abfragen mit Text, der mit 1 beginnt, `$` sind Vorlagen. Nicht alle Panels werden über Vorlagenabfragen verfügen.
**Bewährte Methoden für verschiedene Varianten**
+ Variablen-Dropdownlisten werden in der Reihenfolge angezeigt, in der sie in der Variablenliste in den **Dashboard-Einstellungen** aufgeführt sind.
+ Platzieren Sie die Variablen, die Sie häufig ändern werden, ganz oben, sodass sie zuerst angezeigt werden (ganz links im Dashboard).
+ Variablen wählen standardmäßig den obersten Wert in der Drop-down-Liste aus. Wenn Sie stattdessen einen leeren Wert wählen möchten, ändern Sie die Variableneinstellungen wie folgt:
1. Aktivieren Sie das Kontrollkästchen „**Alle Optionen einbeziehen**“.
1. Geben Sie im Feld **Alle Werte benutzerdefiniert** den Wert ein`+`.
**Topics**
+ [Variablen hinzufügen und verwalten](v10-dash-variable-add.md)
+ [Variablen untersuchen](v10-dash-variable-add-inspect.md)
+ [Syntax von Variablen](v10-dash-variable-syntax.md)
# Variablen hinzufügen und verwalten
[ ^ " ] + ) |chip=" (?[ ^ " ] + )/g
```
Würde die folgende Drop-down-Liste erzeugen:
```
Display Name Value
------------ -------------------------
enp216s0f0np0 0000:d7:00_0_0000:d8:00_0
enp216s0f0np1 0000:d7:00_0_0000:d8:00_1
enp216s0f0np2 0000:d7:00_0_0000:d8:00_2
enp216s0f0np3 0000:d7:00_0_0000:d8:00_3
```
Nur Gruppennamen `text` und `value` Capture-Namen werden unterstützt.
# Variablen untersuchen
}`— Dieses Format gibt Ihnen mehr Kontrolle darüber, wie Grafana Werte interpretiert. Weitere Informationen finden Sie unter *Erweiterte Optionen für das Variablenformat*, der dieser Liste folgt.
+ `[[varname]]`— Nicht verwenden. Diese Syntax ist alt und veraltet. Es wird in einer future Version entfernt.
Bevor Abfragen an Ihre Datenquelle gesendet werden, wird die Abfrage *interpoliert*, was bedeutet, dass die Variable durch ihren aktuellen Wert ersetzt wird. Während der Interpolation kann der Variablenwert maskiert *werden*, um der Syntax der Abfragesprache und dem Verwendungszweck zu entsprechen. Beispielsweise wird eine Variable, die in einem Regex-Ausdruck in einer InfluxDB- oder Prometheus-Abfrage verwendet wird, mit Regex-Escapes versehen.
**Erweiterte Optionen für das Variablenformat**
Die Formatierung der Variableninterpolation hängt von der Datenquelle ab, es gibt jedoch Situationen, in denen Sie möglicherweise die Standardformatierung ändern möchten.
Die Standardeinstellung für die MySQL-Datenquelle besteht beispielsweise darin, mehrere Werte durch Kommas getrennt durch Anführungszeichen zu verbinden:. `'server01','server02'` In einigen Fällen möchten Sie vielleicht eine durch Kommas getrennte Zeichenfolge ohne Anführungszeichen verwenden:. `server01,server02` Sie können dies mit den unten aufgeführten erweiterten Optionen zur Formatierung von Variablen erreichen.
**Allgemeine Syntax**
Syntax: `${var_name:option}`
Wenn eine ungültige Formatierungsoption angegeben ist, dann `glob` ist dies die default/fallback Option.
**CSV**
Formatiert Variablen mit mehreren Werten als kommagetrennte Zeichenfolge.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:csv}'
Interpolation result: 'test1,test2'
```
**Verteilt - OpenTSDB**
Formatiert Variablen mit mehreren Werten in einem benutzerdefinierten Format für OpenTSDB.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:distributed}'
Interpolation result: 'test1,servers=test2'
```
**Doppeltes Anführungszeichen**
Formatiert ein- und mehrwertige Variablen in eine durch Kommas getrennte Zeichenfolge, maskiert jeden Wert mit `\"` und setzt jeden Wert mit `"` in Anführungszeichen. `"`
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:doublequote}'
Interpolation result: '"test1","test2"'
```
**Glob - Graphit**
Formatiert Variablen mit mehreren Werten in einen Glob (für Graphite-Abfragen).
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:glob}'
Interpolation result: '{test1,test2}'
```
**JSON**
Formatiert Variablen mit mehreren Werten als kommagetrennte Zeichenfolge.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:json}'
Interpolation result: '["test1", "test2"]'
```
**Lucene - Elasticsearch**
Formatiert Variablen mit mehreren Werten im Lucene-Format für Elasticsearch.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:lucene}'
Interpolation result: '("test1" OR "test2")'
```
**Prozentualer Code**
Formatiert ein- und mehrwertige Variablen zur Verwendung in URL-Parametern.
```
servers = [ 'foo()bar BAZ', 'test2' ]
String to interpolate: '${servers:percentencode}'
Interpolation result: 'foo%28%29bar%20BAZ%2Ctest2'
```
**Pfeife**
Formatiert Variablen mit mehreren Werten in eine durch Pipe getrennte Zeichenfolge.
```
servers = [ 'test1.', 'test2' ]
String to interpolate: '${servers:pipe}'
Interpolation result: 'test1.|test2'
```
**Roh**
Deaktiviert datenquellenspezifische Formatierungen, z. B. einfache Anführungszeichen in einer SQL-Abfrage.
```
servers = [ 'test.1', 'test2' ]
String to interpolate: '${var_name:raw}'
Interpolation result: 'test.1,test2'
```
**Regex**
Formatiert Variablen mit mehreren Werten in eine Regex-Zeichenfolge.
```
servers = [ 'test1.', 'test2' ]
String to interpolate: '${servers:regex}'
Interpolation result: '(test1\.|test2)'
```
**Einfaches Anführungszeichen**
Formatiert ein- und mehrwertige Variablen in eine durch Kommas getrennte Zeichenfolge, maskiert jeden Wert mit und setzt jeden Wert mit `'` in `\'` Anführungszeichen. `'`
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:singlequote}'
Interpolation result: "'test1','test2'"
```
**SQL-String**
Formatiert ein- und mehrwertige Variablen in eine durch Kommas getrennte Zeichenfolge, maskiert jeden Wert mit `''` und setzt jeden Wert mit `'` in Anführungszeichen. `'`
```
servers = [ "test'1", "test2" ]
String to interpolate: '${servers:sqlstring}'
Interpolation result: "'test''1','test2'"
```
**Text**
Formatiert ein- und mehrwertige Variablen in ihre Textdarstellung. Für eine einzelne Variable wird nur die Textdarstellung zurückgegeben. Bei Variablen mit mehreren Werten wird die Textdarstellung in Kombination mit `+` zurückgegeben.
```
servers = [ "test1", "test2" ]
String to interpolate: '${servers:text}'
Interpolation result: "test1 + test2"
```
**Abfrageparameter**
Formatiert ein- und mehrwertige Variablen in ihre Darstellung der Abfrageparameter. Beispiel: `var-foo=value1&var-foo=value2`
```
servers = [ "test1", "test2" ]
String to interpolate: '${servers:queryparam}'
Interpolation result: "var-servers=test1&var-servers=test2"
```
# Bewertung der Dashboard-Nutzung
[${__range_s}s]) != )
```
**Spezielle Datenquellen**
**Grafana umfasst auch drei spezielle Datenquellen: **Grafana**, **Mixed** und Dashboard.** Weitere Informationen finden Sie unter [Verbinden zu Datenquellen](AMG-data-sources.md).
## Navigieren Sie auf der Registerkarte „Abfrage“
Zahl = Zahl
+ Zahlenreihe = Serie
+ Serie Serie = Serie
Da Ausdrücke mit mehreren Reihen oder Zahlen arbeiten, die durch eine einzige Variable repräsentiert werden, führen binäre Operationen auch eine Vereinigung (Verknüpfung) zwischen den beiden Variablen durch. Dies erfolgt auf der Grundlage der identifizierenden Bezeichnungen, die jeder einzelnen Reihe oder Zahl zugeordnet sind.
Wenn Sie also Zahlen mit Beschriftungen wie `{host=web01}` in `$A` und eine weitere Zahl `$B` mit denselben Beschriftungen haben, wird die Operation zwischen diesen beiden Elementen innerhalb jeder Variablen ausgeführt, und das Ergebnis verwendet dieselben Beschriftungen. Die Regeln für das Verhalten dieser Vereinigung lauten wie folgt:
+ Ein Objekt ohne Beschriftungen lässt sich mit allem verbinden.
+ Wenn beide `$A` nur ein Objekt enthalten (eine Serie oder eine Zahl), werden sie zusammengefügt. `$B`
+ Wenn die Beschriftungen exakt übereinstimmen, werden sie zusammengefügt.
+ Wenn es sich bei den Beschriftungen um eine Teilmenge der anderen handelt, z. B. wenn ein Element in beschriftet `$A` ist `{host=A,dc=MIA}` und ein Element in beschriftet `$B` ist, werden `{host=A}` sie zusammengefügt.
+ Wenn innerhalb einer Variablen beispielsweise für jedes Element unterschiedliche Tag-Schlüssel `$A` vorhanden sind, ist das Verbindungsverhalten undefiniert.
Die relationalen und logischen Operatoren geben 0 für falsch und 1 für wahr zurück.
**Mathematische Funktionen**
Während die meisten Funktionen in eigenen Ausdrucksoperationen existieren, hat die mathematische Operation einige Funktionen, die mathematischen Operatoren oder Symbolen ähneln. Wenn Funktionen entweder Zahlen oder Reihen annehmen können, wird derselbe Typ wie das Argument zurückgegeben. Handelt es sich um eine Reihe, wird die Operation für den Wert jedes Punktes in der Reihe ausgeführt.
*Bauchmuskeln*
abs gibt den absoluten Wert seines Arguments zurück, der eine Zahl oder eine Reihe sein kann. Zum Beispiel `abs(-1)` oder `abs($A)`.
*is\$1inf*
is\$1inf nimmt eine Zahl oder eine Reihe und gibt `1` für `Inf` Werte (negativ oder positiv) und `0` für andere Werte zurück. Zum Beispiel `is_inf($A)`.
**Anmerkung**
Wenn Sie beispielsweise gezielt nach negativer Unendlichkeit suchen müssen, können Sie einen Vergleich wie durchführen. `$A == infn()`
*is\$1nan*
is\$1nan nimmt eine Zahl oder eine Reihe und gibt `1` für `NaN` Werte und `0` für andere Werte zurück. Zum Beispiel `is_nan($A)`. Diese Funktion ist für diese Prüfung erforderlich, da sie nicht gleich `NaN` ist. `NaN`
*is\$1null*
is\$1null nimmt eine Zahl oder eine Reihe und gibt `1` für `null` Werte und `0` für andere Werte zurück. Zum Beispiel `is_null($A)`.
*ist\$1Zahl*
is\$1number nimmt eine Zahl oder eine Reihe und gibt `1` für alle reellen Zahlenwerte und `0` für andere Werte (die`null`,`Inf+`, `Inf-` und sind) zurück. `NaN` Zum Beispiel `is_number($A)`.
*log*
Log gibt den natürlichen Logarithmus seines Arguments zurück, der eine Zahl oder eine Reihe sein kann. Wenn der Wert kleiner als 0 ist, `NaN` wird zurückgegeben. Zum Beispiel `log(-1)` oder `log($A)`.
*inf, infn, nan und null*
Die Funktionen inf, infn, nan und null geben alle einen einzelnen Wert des Namens zurück. Sie existieren hauptsächlich zum Testen. Beispiel: `null()`.
*round*
Round gibt einen gerundeten Ganzzahlwert zurück. Zum Beispiel `round(3.123)` oder `round($A)`.
*ceil*
Ceil rundet die Zahl auf den nächsten ganzzahligen Wert auf. Beispielsweise gibt `ceil(3.123)` `4` zurück.
*floor*
Floor rundet die Zahl auf den nächsten ganzzahligen Wert ab. Beispiel:`floor(3.123`) gibt zurück`3`.
**Reduzieren**
Reduce verwendet eine oder mehrere Zeitreihen, die von einer Abfrage oder einem Ausdruck zurückgegeben wurden, und wandelt jede Reihe in eine einzelne Zahl um. Die Beschriftungen der Zeitreihen werden als Beschriftungen für jede ausgegebene reduzierte Zahl beibehalten.
*Felder:*
+ **Funktion** — Die zu verwendende Reduktionsfunktion
+ **Eingabe** — Die Variable (RefID (z. B.`A`)), die neu berechnet werden soll
+ **Modus** — Ermöglicht die Steuerung des Verhaltens der Reduktionsfunktion, wenn eine Reihe nicht numerische Werte enthält (Null, NaN, \$1-Inf)
**Reduktionsfunktionen**
*Count*
Count gibt die Anzahl der Punkte in jeder Reihe zurück.
*Meint*
Der Mittelwert gibt die Summe aller Werte in jeder Reihe geteilt durch die Anzahl der Punkte in dieser Reihe zurück. Wenn im `strict` Modus irgendwelche Werte in der Reihe Null oder Nan sind oder wenn die Reihe leer ist, wird NaN zurückgegeben.
*Min und Max*
Min und Max geben den kleinsten bzw. größten Wert in der Reihe zurück. Wenn im `strict` Modus irgendwelche Werte in der Reihe Null oder Nan sind oder wenn die Reihe leer ist, wird NaN zurückgegeben.
*Sum (Summe)*
Sum gibt die Summe aller Werte in der Reihe zurück. Wenn die Reihe die Länge Null hat, ist die Summe 0. Wenn im `strict` Modus NaN- oder Null-Werte in der Reihe vorhanden sind, wird NaN zurückgegeben.
*Zuletzt*
Last gibt die letzte Zahl in der Reihe zurück. Wenn die Serie keine Werte hat, wird NaN zurückgegeben.
**Reduktionsmodi**
*Streng*
Im Strict-Modus wird die Eingangsserie unverändert verarbeitet. Wenn Werte in der Reihe nicht numerisch sind (Null, NaN oder \$1-Inf), wird NaN zurückgegeben.
*Löschen Sie nicht-numerische Werte*
In diesem Modus werden alle nicht numerischen Werte (Null, NaN oder \$1-Inf) in der Eingangsserie herausgefiltert, bevor die Reduktionsfunktion ausgeführt wird.
*Ersetzt nicht-numerisch*
In diesem Modus werden alle nicht numerischen Werte durch einen vordefinierten Wert ersetzt.
**Stichprobe neu berechnen**
Bei Resampling werden die Zeitstempel in jeder Zeitreihe so geändert, dass ein konsistentes Zeitintervall entsteht. Der Hauptanwendungsfall besteht darin, dass Sie Zeitreihen, die nicht dieselben Zeitstempel haben, neu berechnen können, sodass Berechnungen zwischen ihnen durchgeführt werden können. Dies kann erreicht werden, indem jede der beiden Serien neu berechnet wird, und dann in einer mathematischen Operation auf die neu abgetasteten Variablen verwiesen wird.
*Felder:*
+ **Eingabe** — Die Variable der Zeitreihendaten (RefID (z. B.`A`)), für die ein Resampling durchgeführt werden soll
+ **Resampling** to — Die Zeitdauer, für die beispielsweise das Resampling durchgeführt werden soll. `10s` Einheiten können `s` Sekunden, `m` Minuten, `h` Stunden, `d` Tage, `w` Wochen und `y` Jahre sein.
+ **Downsample** — Die Reduktionsfunktion, die verwendet werden soll, wenn pro Fensterstichprobe mehr als ein Datenpunkt vorhanden ist. Einzelheiten zum Verhalten finden Sie in der Reduktionsoperation.
+ **Upsample** — Die Methode, die verwendet werden soll, um eine Fensterprobe ohne Datenpunkte zu füllen.
+ **Das Pad** füllt mit dem letzten bekannten Wert
+ mit dem nächsten **bekannten Wert auffüllen**
+ **fillna** zum Füllen leerer Beispielfenster mit NaNs
## Schreiben Sie einen Ausdruck
für eine benutzerdefinierte Einheit, die hinter dem Wert stehen soll.
+ **Präfix:** für eine benutzerdefinierte Einheit, die vor dem Wert stehen sollte.
+ **Zeit:** Geben Sie für benutzerdefinierte Datums- und Uhrzeitformate beispielsweise ein`time:YYYY-MM-DD`. Informationen zur [Formatsyntax](https://momentjs.com/docs/#/displaying/) und zu den Optionen finden Sie unter Format in der *Dokumentation zu Moment.js*.
+ **si:** für benutzerdefinierte SI-Einheiten. Beispiel: `si: mF`. Dies ist etwas fortgeschrittener, da Sie sowohl eine Einheit als auch die Skala der Quelldaten angeben können. Wenn Ihre Quelldaten also als Milli (Tausende von) etwas dargestellt werden, stellen Sie der Einheit dieses SI-Skalenzeichen voran.
+ **Anzahl:** für eine benutzerdefinierte Zähleinheit.
+ **Währung:** für benutzerdefinierte Angaben eine Währungseinheit.
Sie können auch ein systemeigenes Emoji in die Einheitenauswahl einfügen und es als benutzerdefinierte Einheit auswählen.
### Zeichenketteneinheiten
`— Der Wert des Labels für die URL. Wenn Ihr Etikett Punkte enthält, verwenden Sie die `__field.labels[""]` Syntax.
### Wertvariablen
/explore?panes=&schemaVersion=&orgId=
```
Wobei:
+ `org_id`ist die Organisations-ID
+ `schema_version`ist die Schemaversion (sollte auf die neueste Version gesetzt werden, nämlich`1`.
+ `panes`ist ein URL-codiertes JSON-Objekt von Bereichen, wobei jeder Schlüssel die Bereichs-ID und jeder Wert ein Objekt ist, das dem folgenden Schema entspricht:
```
{
datasource: string; // the pane's root datasource UID, or `-- Mixed --` for mixed datasources
queries: {
refId: string; // an alphanumeric identifier for this query, must be unique within the pane, i.e. "A", "B", "C", etc.
datasource: {
uid: string; // the query's datasource UID ie: "AD7864H6422"
type: string; // the query's datasource type-id, i.e: "loki"
}
// ... any other datasource-specific query parameters
}[]; // array of queries for this pane
range: {
from: string; // the start time, in milliseconds since epoch
to: string; // the end time, in milliseconds since epoch
}
}
```
**Anmerkung**
Die `to` Felder `from` und akzeptieren auch relative Bereiche, wie im Thema beschrieben. [Zeitbereich für das Dashboard einstellen](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range)
## Verkürzten Link teilen
/public/emails/ng_alert_notification.html` Sie können diese Datei bearbeiten, um das Erscheinungsbild aller Warn-E-Mails zu ändern.
# Alert-Manager
auth =
}
```
## Stellen Sie Kontaktpunkte und Vorlagen bereit
* durch deine Slack-Webhook-URL (oder andere Kontaktpunktdetails).
In diesem Beispiel wird eine Kontaktstelle erstellt, die Warnmeldungen an Slack sendet.
```
resource "grafana_contact_point" "my_slack_contact_point" {
name = "Send to My Slack Channel"
slack {
url =
text = <
Benachrichtigungsrichtlinien teilen Grafana mit, wie Alarminstanzen weitergeleitet werden sollen, und nicht wohin. Sie verbinden ausgelöste Alarme mithilfe eines Systems von Labels und Matchern mit Ihren zuvor definierten Kontaktpunkten.
**Zur Bereitstellung von Benachrichtigungsrichtlinien und Routing**
1. Kopieren Sie diesen Codeblock in eine .tf-Datei auf Ihrem lokalen Computer.
In diesem Beispiel werden die Benachrichtigungen nach gruppiert`alertname`, was bedeutet, dass alle Benachrichtigungen, die von Benachrichtigungen stammen, die denselben Namen haben, in derselben Slack-Nachricht gruppiert werden.
Wenn du bestimmte Benachrichtigungen unterschiedlich weiterleiten möchtest, kannst du Unterrichtlinien hinzufügen. Mithilfe von Unterrichtlinien können Sie das Routing auf verschiedene Benachrichtigungen anwenden, die auf der Zuordnung von Bezeichnungen basieren. In diesem Beispiel wenden wir eine Stummschaltung auf alle Alarme mit der Bezeichnung a=b an.
```
resource "grafana_notification_policy" "my_policy" {
group_by = ["alertname"]
contact_point = grafana_contact_point.my_slack_contact_point.name
group_wait = "45s"
group_interval = "6m"
repeat_interval = "3h"
policy {
matcher {
label = "a"
match = "="
value = "b"
}
group_by = ["..."]
contact_point = grafana_contact_point.a_different_contact_point.name
mute_timings = [grafana_mute_timing.my_mute_timing.name]
policy {
matcher {
label = "sublabel"
match = "="
value = "subvalue"
}
contact_point = grafana_contact_point.a_third_contact_point.name
group_by = ["..."]
}
}
}
```
1. Verknüpfen Sie im Feld mute\$1timings einen Zeitpunkt der Stummschaltung mit Ihrer Benachrichtigungsrichtlinie.
1. Führen Sie den Befehl `terraform apply` aus.
1. Gehen Sie zur Grafana-Benutzeroberfläche und überprüfen Sie die Details Ihrer Benachrichtigungsrichtlinie.
**Anmerkung**
Sie können die von Terraform bereitgestellten Ressourcen nicht über die Benutzeroberfläche bearbeiten. Dadurch wird sichergestellt, dass Ihr Alert-Stack immer mit Ihrem Code synchron bleibt.
1. Klicken Sie auf **Test**, um zu überprüfen, ob der Benachrichtigungspunkt ordnungsgemäß funktioniert.
## Stellen Sie Zeiten zur Stummschaltung bereit
****
Dieses Dokumentationsthema wurde für Grafana-Workspaces entwickelt, die **Grafana-Version 10.x** unterstützen.
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 9.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 9](using-grafana-v9.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Sie können überprüfen, ob Ihre Warnressourcen in Grafana erstellt wurden.
**So zeigen Sie Ihre bereitgestellten Ressourcen in Grafana an**
1. Öffnen Sie Ihre Grafana-Instanz.
1. Navigieren Sie zu Alerting.
1. Klicken Sie auf einen Ressourcenordner für Warnmeldungen, z. B. auf Warnungsregeln.
Bereitgestellte Ressourcen werden als **Bereitgestellt** gekennzeichnet, sodass deutlich wird, dass sie nicht manuell erstellt wurden.
**Anmerkung**
Sie können bereitgestellte Ressourcen nicht von Grafana aus bearbeiten. Sie können die Ressourceneigenschaften nur ändern, indem Sie die Provisioning-Datei ändern und Grafana neu starten oder einen Hot-Reload durchführen. Dadurch wird verhindert, dass Änderungen an der Ressource vorgenommen werden, die überschrieben würden, wenn eine Datei erneut bereitgestellt oder ein Hot-Reload durchgeführt würde.
# Warnmeldungen konfigurieren
` an das Ende an. Um Geschäftsperioden, Nutzungs `fQ (fiscal quarter)` - und `fy (fiscal year)` Zeiteinheiten anzuzeigen.
Mit dem Plus-Operator können Sie im Vergleich zur aktuellen Zeit einen Schritt vorwärts machen. Sie können diese Funktion beispielsweise verwenden, um sich die prognostizierten Daten für die future anzusehen.
Die folgende Tabelle enthält Beispiele für relative Bereiche.
| Beispiel für einen relativen Bereich | Aus | Bis |
| --- | --- | --- |
| Letzte 5 Minuten | `now-5m` | `now` |
| Der Tag bis jetzt | `now/d` | `now` |
| Diese Woche | `now/w` | `now/w` |
| Diese Woche bis jetzt | `now/w` | `now` |
| In diesem Monat | `now/M` | `now/M` |
| Bisher in diesem Monat | `now/M` | `now` |
| Voriger Monat | `now-1M/M` | `now-1M/M` |
| Bisher in diesem Jahr | `now/Y` | `now` |
| Dieses Jahr | `now/Y` | `now/Y` |
| Vorheriges Geschäftsjahr | `now-1y/fy` | `now-1y/fy` |
**Anmerkung**
Grafana Alerting unterstützt `now+n` keine future Zeitstempel und keinen *Start von n bis `now-1n/n` zum Ende von n* Zeitstempeln.
**Allgemeine Steuerungen für den Zeitbereich**
Die Zeitsteuerungen im Dashboard und im Bedienfeld haben eine gemeinsame Benutzeroberfläche. Im Folgenden werden allgemeine Steuerelemente für den Zeitbereich beschrieben.
+ Der aktuelle Zeitraum, auch *Zeitauswahl genannt, zeigt den Zeitraum* an, der aktuell in dem Dashboard oder Panel angezeigt wird, das Sie gerade betrachten. Bewegen Sie den Mauszeiger über das Feld, um die genauen Zeitstempel im Bereich und deren Quelle (z. B. den lokalen Browser) zu sehen. Klicken Sie auf den *aktuellen Zeitraum*, um ihn zu ändern. Sie können die aktuelle Uhrzeit anhand eines *relativen Zeitbereichs*, z. B. der letzten 15 Minuten, oder eines absoluten Zeitbereichs, z. B. `2020-05-14 00:00:00` bis, ändern`2020-05-15 23:59:59`.
+ Der **relative Zeitraum** kann aus der Liste **Relative Zeitbereiche** ausgewählt werden. Sie können die Liste mithilfe des Eingabefeldes oben filtern. Einige Beispiele für Zeiträume sind *Letzte 30 Minuten*, *Letzte 12 Stunden*, *Letzte 7 Tage*, *Letzte 2 Jahre*, *Gestern*, *Vorgestern*, Heute *letzte Woche*, *Heute bis jetzt*, *Diese Woche bis* jetzt und *Dieser Monat bisher*.
+ Der **absolute Zeitraum** kann auf zwei Arten festgelegt werden: Geben Sie exakte Zeitwerte oder relative Zeitwerte in die Felder **Von** und Bis ein und klicken Sie **auf** **Zeitbereich übernehmen**, oder klicken Sie auf ein Datum oder einen Datumsbereich aus dem Kalender, der angezeigt wird, wenn Sie auf das Feld **Von** oder **Bis** klicken. Um Ihre Auswahl zu übernehmen, klicken Sie auf **Zeitbereich übernehmen**.
*Weitere Funktionen für den Zeitbereich*
1. **Um die Ansicht zu verkleinern, klicken Sie auf **Cmd\$1Z oder Strg\$1Z**.** Klicken Sie auf das Symbol, um einen größeren Zeitraum im Dashboard oder in der Panel-Visualisierung anzuzeigen.
1. Um die Funktion zum Vergrößern zu verwenden, klicken und ziehen Sie, um den Zeitraum in der Visualisierung auszuwählen, den Sie anzeigen möchten.
**Anmerkung**
Das Vergrößern ist nur für Grafikvisualisierungen verfügbar.
*Dashboards aktualisieren*
Klicken Sie auf das Symbol „**Dashboard aktualisieren**“, um sofort jede Abfrage im Dashboard auszuführen und die Visualisierungen zu aktualisieren. Grafana storniert alle ausstehenden Anfragen, wenn Sie eine Aktualisierung auslösen.
Standardmäßig aktualisiert Grafana das Dashboard nicht automatisch. Abfragen werden gemäß den Panel-Einstellungen nach ihrem eigenen Zeitplan ausgeführt. Wenn Sie das Dashboard jedoch regelmäßig aktualisieren möchten, klicken Sie auf den Abwärtspfeil neben dem Symbol „**Dashboard aktualisieren**“ und wählen Sie dann ein Aktualisierungsintervall aus.
**Steuern Sie den Zeitraum mithilfe einer URL**
Sie können den Zeitraum eines Dashboards steuern, indem Sie die folgenden Abfrageparameter in der Dashboard-URL angeben.
+ `from`definiert die Untergrenze des Zeitbereichs, angegeben in ms, Epoche oder [relativer Zeit](#v9-dash-setting-dashboard-time-range).
+ `to`definiert die Obergrenze des Zeitbereichs, angegeben in ms Epoche oder relativer Zeit.
+ `time`und `time.window` definiert einen Zeitbereich von `time-time.window/2` bis`time+time.window/2`. Beide Parameter sollten in ms angegeben werden. Zum Beispiel `?time=1500000000000&time.window=10000` ergibt sich ein 10s-Zeitbereich von 1499999995000 bis 1500000005000.
# Dashboards erstellen
oben rechts auf die Schaltfläche „In **Version wiederherstellen**“ klicken.
**Eine zuvor gespeicherte Dashboard-Version wiederherstellen**
Wenn Sie eine zuvor gespeicherte Dashboard-Version wiederherstellen möchten, können Sie entweder auf die Schaltfläche **Wiederherstellen** rechts neben einer Zeile in der Liste der Dashboard-Versionen klicken oder auf die Schaltfläche In Version **wiederherstellen** klicken, die in der Vergleichsansicht angezeigt wird. Wenn Sie auf die Schaltfläche klicken, wird das folgende Popup-Fenster geöffnet, in dem Sie aufgefordert werden, die Wiederherstellung zu bestätigen.
Nach der Wiederherstellung auf eine frühere Version wird eine neue Version erstellt, die genau dieselben Daten wie die vorherige Version enthält, nur mit einer anderen Versionsnummer. Dies wird in der **Spalte „Hinweise“** für die Zeile in der neuen Dashboard-Version angezeigt. Dies geschieht lediglich, um sicherzustellen, dass Ihre vorherigen Dashboard-Versionen von der Änderung nicht betroffen sind.
# Dashboard-Links verwalten
Variablenwerte werden immer mit der Syntax var- =value mit der URL synchronisiert.
**Beispiele**
Variablen werden in Dropdownlisten oben auf dem Bildschirm aufgeführt. Wählen Sie verschiedene Variablen aus, um zu sehen, wie sich die Visualisierungen ändern.
Um die Variableneinstellungen zu sehen, navigieren Sie zu **Dashboard-Einstellungen >** Variablen. Klicken Sie in der Liste auf eine Variable, um ihre Einstellungen zu sehen.
Variablen können in Titeln, Beschreibungen, Textfeldern und Abfragen verwendet werden. Abfragen mit Text, der mit 1 beginnt, `$` sind Vorlagen. Nicht alle Panels werden über Vorlagenabfragen verfügen.
**Verschiedene bewährte Methoden**
+ Variablen-Dropdownlisten werden in der Reihenfolge angezeigt, in der sie in der Variablenliste in den **Dashboard-Einstellungen** aufgeführt sind.
+ Platzieren Sie die Variablen, die Sie häufig ändern werden, ganz oben, sodass sie zuerst angezeigt werden (ganz links im Dashboard).
# Variablen hinzufügen und verwalten
[ ^ " ] + ) |chip=" (?[ ^ " ] + )/g
```
Würde die folgende Drop-down-Liste erzeugen:
```
Display Name Value
------------ -------------------------
enp216s0f0np0 0000:d7:00_0_0000:d8:00_0
enp216s0f0np1 0000:d7:00_0_0000:d8:00_1
enp216s0f0np2 0000:d7:00_0_0000:d8:00_2
enp216s0f0np3 0000:d7:00_0_0000:d8:00_3
```
Nur Gruppennamen `text` und `value` Capture-Namen werden unterstützt.
##
}`— Dieses Format gibt Ihnen mehr Kontrolle darüber, wie Grafana Werte interpretiert. Weitere Informationen finden Sie unter *Erweiterte Optionen für das Variablenformat*.
+ `[[varname]]`— Nicht verwenden. Diese Syntax ist alt und veraltet. Es wird in einer future Version entfernt.
Bevor Abfragen an Ihre Datenquelle gesendet werden, wird die Abfrage *interpoliert*, was bedeutet, dass die Variable durch ihren aktuellen Wert ersetzt wird. Während der Interpolation kann der Variablenwert maskiert *werden*, um der Syntax der Abfragesprache und dem Verwendungszweck zu entsprechen. Beispielsweise wird eine Variable, die in einem Regex-Ausdruck in einer InfluxDB- oder Prometheus-Abfrage verwendet wird, mit Regex-Escapes versehen.
**Erweiterte Optionen für das Variablenformat**
Die Formatierung der Variableninterpolation hängt von der Datenquelle ab, es gibt jedoch Situationen, in denen Sie möglicherweise die Standardformatierung ändern möchten.
Die Standardeinstellung für die MySQL-Datenquelle besteht beispielsweise darin, mehrere Werte durch Kommas getrennt durch Anführungszeichen zu verbinden:. `'server01','server02'` In einigen Fällen möchten Sie vielleicht eine durch Kommas getrennte Zeichenfolge ohne Anführungszeichen verwenden:. `server01,server02` Sie können dies mit den unten aufgeführten erweiterten Optionen zur Formatierung von Variablen erreichen.
**Allgemeine Syntax**
Syntax: `${var_name:option}`
Wenn eine ungültige Formatierungsoption angegeben ist, `glob` ist dies die default/fallback Option.
**CSV**
Formatiert Variablen mit mehreren Werten als kommagetrennte Zeichenfolge.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:csv}'
Interpolation result: 'test1,test2'
```
**Verteilt - OpenTSDB**
Formatiert Variablen mit mehreren Werten in einem benutzerdefinierten Format für OpenTSDB.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:distributed}'
Interpolation result: 'test1,servers=test2'
```
**Doppeltes Anführungszeichen**
Formatiert ein- und mehrwertige Variablen in eine durch Kommas getrennte Zeichenfolge, maskiert jeden Wert mit `\"` und setzt jeden Wert mit `"` in Anführungszeichen. `"`
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:doublequote}'
Interpolation result: '"test1","test2"'
```
**Glob - Graphit**
Formatiert Variablen mit mehreren Werten in einen Glob (für Graphite-Abfragen).
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:glob}'
Interpolation result: '{test1,test2}'
```
**JSON**
Formatiert Variablen mit mehreren Werten als kommagetrennte Zeichenfolge.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:json}'
Interpolation result: '["test1", "test2"]'
```
**Lucene - Elasticsearch**
Formatiert Variablen mit mehreren Werten im Lucene-Format für Elasticsearch.
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:lucene}'
Interpolation result: '("test1" OR "test2")'
```
**Prozentualer Code**
Formatiert ein- und mehrwertige Variablen zur Verwendung in URL-Parametern.
```
servers = [ 'foo()bar BAZ', 'test2' ]
String to interpolate: '${servers:percentencode}'
Interpolation result: 'foo%28%29bar%20BAZ%2Ctest2'
```
**Pfeife**
Formatiert Variablen mit mehreren Werten in eine durch Pipe getrennte Zeichenfolge.
```
servers = [ 'test1.', 'test2' ]
String to interpolate: '${servers:pipe}'
Interpolation result: 'test1.|test2'
```
**Roh**
Deaktiviert datenquellenspezifische Formatierungen, z. B. einfache Anführungszeichen in einer SQL-Abfrage.
```
servers = [ 'test.1', 'test2' ]
String to interpolate: '${var_name:raw}'
Interpolation result: 'test.1,test2'
```
**Regex**
Formatiert Variablen mit mehreren Werten in eine Regex-Zeichenfolge.
```
servers = [ 'test1.', 'test2' ]
String to interpolate: '${servers:regex}'
Interpolation result: '(test1\.|test2)'
```
**Einfaches Anführungszeichen**
Formatiert ein- und mehrwertige Variablen in eine durch Kommas getrennte Zeichenfolge, maskiert jeden Wert mit und setzt jeden Wert mit `'` in `\'` Anführungszeichen. `'`
```
servers = [ 'test1', 'test2' ]
String to interpolate: '${servers:singlequote}'
Interpolation result: "'test1','test2'"
```
**SQL-String**
Formatiert ein- und mehrwertige Variablen in eine durch Kommas getrennte Zeichenfolge, maskiert jeden Wert mit `''` und setzt jeden Wert mit `'` in Anführungszeichen. `'`
```
servers = [ "test'1", "test2" ]
String to interpolate: '${servers:sqlstring}'
Interpolation result: "'test''1','test2'"
```
**Text**
Formatiert ein- und mehrwertige Variablen in ihre Textdarstellung. Für eine einzelne Variable wird nur die Textdarstellung zurückgegeben. Bei Variablen mit mehreren Werten wird die Textdarstellung in Kombination mit `+` zurückgegeben.
```
servers = [ "test1", "test2" ]
String to interpolate: '${servers:text}'
Interpolation result: "test1 + test2"
```
**Abfrageparameter**
Formatiert ein- und mehrwertige Variablen in ihre Darstellung der Abfrageparameter. Beispiel: `var-foo=value1&var-foo=value2`
```
servers = [ "test1", "test2" ]
String to interpolate: '${servers:queryparam}'
Interpolation result: "var-servers=test1&var-servers=test2"
```
# Bewertung der Dashboard-Nutzung
für eine benutzerdefinierte Einheit, die hinter dem Wert stehen soll.
+ **Präfix:** für eine benutzerdefinierte Einheit, die vor dem Wert stehen soll.
+ **Zeit:** Geben Sie für benutzerdefinierte Datums- und Uhrzeitformate beispielsweise **time:yyyy-MM-DD** ein. Die Formatsyntax und die [Optionen finden Sie unter Formate](https://momentjs.com/docs/#/displaying/).
+ **si:** für benutzerdefinierte SI-Einheiten. Zum Beispiel: **si: mF**. Dieser ist etwas fortgeschrittener, da Sie sowohl eine Einheit als auch die Skala der Quelldaten angeben können. Wenn Ihre Quelldaten also als Milli (Tausende von) etwas dargestellt werden, stellen Sie der Einheit dieses SI-Skalenzeichen voran.
+ **Anzahl:** für eine benutzerdefinierte Zähleinheit.
+ **Währung:** für benutzerdefinierte Angaben eine Währungseinheit.
Sie können auch ein systemeigenes Emoji in die Einheitenauswahl einfügen und es als benutzerdefinierte Einheit auswählen.
#### Zeichenketteneinheiten
[${__range_s}s]) != )
```
**Spezielle Datenquellen**
**Grafana umfasst auch drei spezielle Datenquellen: **Grafana**, **Mixed** und Dashboard.** Einzelheiten finden Sie unter Datenquellen
## Navigieren Sie zur Registerkarte „Abfrage“
- Der Wert des Labels für die URL. Wenn Ihr Etikett Punkte enthält, verwenden Sie die Syntax **\$1\$1field.labels [“ „**].
## Wertvariablen
/public/emails/ng_alert_notification.html` Sie können diese Datei bearbeiten, um das Erscheinungsbild aller Warn-E-Mails zu ändern.
# Warnmeldungen bei numerischen Daten
auth =
}
```
## Stellen Sie Kontaktpunkte und Vorlagen bereit
* durch deine Slack-Webhook-URL (oder einen anderen Kontakt).
In diesem Beispiel wird eine Kontaktstelle erstellt, die Warnmeldungen an Slack sendet.
```
resource "grafana_contact_point" "my_slack_contact_point" {
name = "Send to My Slack Channel"
slack {
url =
text = <
Benachrichtigungsrichtlinien teilen Grafana mit, wie Alarminstanzen weitergeleitet werden sollen, und nicht wohin. Sie verbinden ausgelöste Alarme mithilfe eines Systems von Labels und Matchern mit Ihren zuvor definierten Kontaktpunkten.
**Zur Bereitstellung von Benachrichtigungsrichtlinien und Routing**
1. Kopieren Sie diesen Codeblock in eine .tf-Datei auf Ihrem lokalen Computer.
In diesem Beispiel werden die Benachrichtigungen nach gruppiert`alertname`, was bedeutet, dass alle Benachrichtigungen, die von Benachrichtigungen stammen, die denselben Namen haben, in derselben Slack-Nachricht gruppiert werden.
Wenn du bestimmte Benachrichtigungen unterschiedlich weiterleiten möchtest, kannst du Unterrichtlinien hinzufügen. Mithilfe von Unterrichtlinien können Sie das Routing auf verschiedene Benachrichtigungen anwenden, die auf der Zuordnung von Bezeichnungen basieren. In diesem Beispiel wenden wir eine Stummschaltung auf alle Alarme mit der Bezeichnung a=b an.
```
resource "grafana_notification_policy" "my_policy" {
group_by = ["alertname"]
contact_point = grafana_contact_point.my_slack_contact_point.name
group_wait = "45s"
group_interval = "6m"
repeat_interval = "3h"
policy {
matcher {
label = "a"
match = "="
value = "b"
}
group_by = ["..."]
contact_point = grafana_contact_point.a_different_contact_point.name
mute_timings = [grafana_mute_timing.my_mute_timing.name]
policy {
matcher {
label = "sublabel"
match = "="
value = "subvalue"
}
contact_point = grafana_contact_point.a_third_contact_point.name
group_by = ["..."]
}
}
}
```
1. Verknüpfen Sie im Feld mute\$1timings einen Zeitpunkt der Stummschaltung mit Ihrer Benachrichtigungsrichtlinie.
1. Führen Sie den Befehl `terraform apply` aus.
1. Gehen Sie zur Grafana-Benutzeroberfläche und überprüfen Sie die Details Ihrer Benachrichtigungsrichtlinie.
**Anmerkung**
Sie können die von Terraform bereitgestellten Ressourcen nicht über die Benutzeroberfläche bearbeiten. Dadurch wird sichergestellt, dass Ihr Benachrichtigungsstapel immer mit Ihrem Code synchron bleibt.
1. Klicken Sie auf **Test**, um zu überprüfen, ob der Benachrichtigungspunkt ordnungsgemäß funktioniert.
## Stellen Sie Zeiten zur Stummschaltung bereit
****
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](using-grafana-v10.md)
Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. [Arbeitet in Grafana-Version 8](using-grafana-v8.md)
Sie können überprüfen, ob Ihre Warnressourcen in Grafana erstellt wurden.
**So zeigen Sie Ihre bereitgestellten Ressourcen in Grafana an**
1. Öffnen Sie Ihre Grafana-Instanz.
1. Navigieren Sie zu Alerting.
1. Klicken Sie auf einen Ressourcenordner für Warnmeldungen, z. B. auf Warnungsregeln.
Bereitgestellte Ressourcen werden als **Bereitgestellt** gekennzeichnet, sodass deutlich wird, dass sie nicht manuell erstellt wurden.
**Anmerkung**
Sie können bereitgestellte Ressourcen nicht von Grafana aus bearbeiten. Sie können die Ressourceneigenschaften nur ändern, indem Sie die Provisioning-Datei ändern und Grafana neu starten oder einen Hot-Reload durchführen. Dadurch wird verhindert, dass Änderungen an der Ressource vorgenommen werden, die überschrieben würden, wenn eine Datei erneut bereitgestellt oder ein Hot-Reload durchgeführt würde.
# Migration klassischer Dashboard-Benachrichtigungen zu Grafana-Benachrichtigungen
[${__range_s}s]) != )
```
Weitere Informationen zum Schreiben einer Abfrage für Ihre Datenquelle finden Sie in der Dokumentation zu dieser Datenquelle. Datenquellen sind unter aufgeführt[Verbinden zu Datenquellen](AMG-data-sources.md).
## Benutzeroberfläche der Registerkarte „Abfrage“
`für eine benutzerdefinierte Einheit, die hinter dem Wert stehen soll.
+ `time:`für benutzerdefinierte date/time Formate; zum Beispiel`time:YYYY-MM-DD`. Informationen zur Formatsyntax und zu den Optionen finden Sie unter [Anzeige](https://momentjs.com/docs/#/displaying/).
+ `si:`für benutzerdefinierte SI-Einheiten, zum Beispiel`si: mF`. Diese Option ist etwas anspruchsvoller, da Sie sowohl eine Einheit als auch die Skala der Quelldaten angeben können. Wenn Ihre Quelldaten beispielsweise als Milli (Tausende von) Einheiten dargestellt werden, stellen Sie der Einheit dieses SI-Skalenzeichen voran.
+ `count:`für eine benutzerdefinierte Zähleinheit.
+ `currency:`für benutzerdefinierte eine Währungseinheit.
Sie können auch ein systemeigenes Emoji in die Einheitenauswahl einfügen und es als benutzerdefinierte Einheit auswählen.
##### Zeichenketteneinheiten
` Sie den Befehl hinzu.
Verwenden Sie den Plus-Operator, um im Vergleich zum Jetzt in der Zeit einen Schritt vorwärts zu machen. Sie können diese Funktion verwenden, um sich vorhergesagte Daten für die future anzusehen.
Hier sind einige Beispiele:
| Beispiel für einen relativen Bereich | Aus | Bis |
| --- | --- | --- |
| Letzte 5 Minuten | now-5m | now |
| Der Tag bis jetzt | now/d | now |
| Diese Woche | now/w | now/w |
| Woche bis heute | now/w | now |
| Voriger Monat | now-1M/M | now-1M/M |
## Allgemeine Steuerungen für den Zeitbereich
“.
## Eine zuvor gespeicherte Dashboard-Version wiederherstellen
in der Vergleichsansicht die Option Auf **Version wiederherstellen** klicken. Nachdem Sie sich für die Wiederherstellung entschieden haben, werden Sie in einem Popup-Fenster aufgefordert, die Wiederherstellung zu bestätigen.
Nach der Wiederherstellung auf eine frühere Version wird eine neue Version erstellt, die genau dieselben Daten wie die vorherige Version enthält, jedoch mit einer anderen Versionsnummer. Dies ist in der Spalte „**Hinweise**“ angegeben. Auf diese Weise können Sie sicherstellen, dass Ihre vorherigen Dashboard-Versionen von der Änderung nicht betroffen sind.
# Tastenkombinationen
`— Fügt der URL den Wert des Labels hinzu. Wenn Ihr Etikett Punkte enthält, verwenden Sie die `__series.labels[""]` Syntax.
### Feldvariablen
=value` mit der URL synchronisiert.
## Bewährte Methoden für Variablen
}`Dieses Format gibt Ihnen mehr Kontrolle darüber, wie Grafana Werte interpoliert. Weitere Informationen finden Sie unter [Erweiterte Optionen für das Variablenformat](#advanced-variable-format-options).
Bevor Abfragen an Ihre Datenquelle gesendet werden, wird die Abfrage *interpoliert*, was bedeutet, dass die Variable durch ihren aktuellen Wert ersetzt wird. Während der Interpolation kann der Variablenwert maskiert werden*,* um der Syntax der Abfragesprache und dem Verwendungszweck zu entsprechen. Beispielsweise wird eine Variable, die in einem Regex-Ausdruck in einer Prometheus-Abfrage verwendet wird, mit Regex-Escapes versehen. Einzelheiten zur Umgehung von Werten bei der Interpolation finden Sie in der datenquellenspezifischen Dokumentation.
Informationen zur erweiterten Syntax zum Überschreiben der Standardformatierung von Datenquellen finden Sie unter. [Erweiterte Optionen für das Variablenformat](#advanced-variable-format-options)
# Typen von Variablen
[^"]+)|chip="(?[^"]+)/g
```
Die folgende Drop-down-Liste wird erstellt.
```
Display Name Value
------------ -------------------------
enp216s0f0np0 0000:d7:00_0_0000:d8:00_0
enp216s0f0np1 0000:d7:00_0_0000:d8:00_1
enp216s0f0np2 0000:d7:00_0_0000:d8:00_2
enp216s0f0np3 0000:d7:00_0_0000:d8:00_3
```
**Hinweis:** Nur Gruppennamen `text` und `value` Capture-Namen werden unterstützt.
### Wiederholte Panels oder Zeilen
, alles Kleinbuchstaben, kein Leerzeichen) oder eine Kanalreferenz (\$1, alles Kleinbuchstaben, kein Leerraum) angeben. Wenn du den chat.postMessage Slack-API-Endpunkt verwendest, ist dies erforderlich. |
| Symbol Emoji | Geben Sie ein Emoji an, das als Symbol für die Nachricht des Bots verwendet werden soll. Zum Beispiel:smile: |
| URL des Symbols | Geben Sie eine URL zu einem Bild an, das als Symbol für die Nachricht des Bots verwendet werden soll. |
| Erwähnen Sie Benutzer | Erwähnen Sie optional einen oder mehrere Benutzer in der von Grafana gesendeten Slack-Benachrichtigung. Um Benutzer durch Kommas getrennt über ihren entsprechenden Slack zu sehen IDs, wähle die Overflow-Schaltfläche in den Slack-Profilen jedes Benutzers. |
| Erwähnen Sie Gruppen | Erwähnen Sie optional eine oder mehrere Gruppen in der von Grafana gesendeten Slack-Benachrichtigung. Du kannst Gruppen, durch Kommas getrennt, über ihren entsprechenden Slack sehen IDs (den du über die Slack-Profil-URL jeder Gruppe abrufen kannst). |
| Erwähnen Sie den Kanal | Erwähnen Sie optional entweder alle Kanalmitglieder oder nur aktive. |
| Token | Falls angegeben, lädt Amazon Managed Grafana das generierte Bild über den API-Vorgang file.upload von Slack hoch, nicht über das externe Image-Ziel. Wenn Sie den chat.postMessage Slack-API-Endpunkt verwenden, ist dies erforderlich. |
Wenn du das Token für einen Slack-Bot verwendest, musst du den Bot in den Channel einladen, an den du Benachrichtigungen senden möchtest. Fügen Sie dann den Kanal zum Empfängerfeld hinzu.
### PagerDuty