Warnmeldungen bei numerischen Daten

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

Informationen zu Grafana-Arbeitsbereichen, die Grafana-Version 8.x unterstützen, finden Sie unter. Arbeitet in Grafana-Version 8

In diesem Thema wird beschrieben, wie Grafana mit Benachrichtigungen bei numerischen Daten und nicht bei Zeitreihendaten umgeht.

Bei bestimmten Datenquellen können numerische Daten, bei denen es sich nicht um Zeitreihen handelt, direkt gemeldet oder an Server Side Expressions (SSE) übergeben werden. Dies ermöglicht eine bessere Verarbeitung und damit eine höhere Effizienz innerhalb der Datenquelle und kann auch die Warnungsregeln vereinfachen. Bei Warnmeldungen für numerische Daten anstelle von Zeitreihendaten ist es nicht erforderlich, jede beschriftete Zeitreihe auf eine einzelne Zahl zu reduzieren. Stattdessen werden beschriftete Zahlen stattdessen an Grafana zurückgegeben.

Tabellendaten

Diese Funktion wird bei Backend-Datenquellen unterstützt, die Tabellendaten abfragen:

• SQL-Datenquellen wie MySQL, Postgres, MSSQL und Oracle.

• Die auf Azure Kusto basierenden Dienste: Azure Monitor (Logs), Azure Monitor (Azure Resource Graph) und Azure Data Explorer.

Eine Abfrage mit von Grafana verwalteten Benachrichtigungen oder SSE wird bei diesen Datenquellen als numerisch betrachtet, wenn:

• Die Option „Format AS“ ist in der Datenquellenabfrage auf „Tabelle“ eingestellt.

• Die von der Abfrage an Grafana zurückgegebene Tabellenantwort enthält nur eine numerische Spalte (z. B. int, double, float) und optional zusätzliche Zeichenkettenspalten.

Wenn es Zeichenkettenspalten gibt, werden diese Spalten zu Beschriftungen. Der Name einer Spalte wird zum Labelnamen, und der Wert für jede Zeile wird zum Wert der entsprechenden Bezeichnung. Wenn mehrere Zeilen zurückgegeben werden, sollte jede Zeile mit ihren Beschriftungen eindeutig identifiziert werden.

Beispiel

Für eine MySQL-Tabelle namens „DiskSpace“:

Zeit	Host	Festplatte	PercentFree
2021-Juni-7	Netz 1	/usw	3
2021-Juni-7	Netz 2	/var	4
2021-Juni-7	Netz 3	/var	8
...	...	...	...

Sie können die Datenfilterung rechtzeitig abfragen, ohne jedoch die Zeitreihe an Grafana zurückzugeben. Zum Beispiel eine Warnung, die pro Host und Festplatte ausgelöst wird, wenn weniger als 5% freier Speicherplatz zur Verfügung steht:

SELECT Host , Disk , CASE WHEN PercentFree  < 5.0 THEN PercentFree  ELSE 0 END FROM ( 
       SELECT
          Host, 
          Disk, 
          Avg(PercentFree) 
       FROM DiskSpace
       Group By
          Host, 
          Disk 
       Where __timeFilter(Time)

Diese Abfrage gibt die folgende Tabellenantwort an Grafana zurück:

Host	Festplatte	PercentFree
web1	/usw	3
web2	/var	4
web3	/var	0

Wenn diese Abfrage als Bedingung in einer Warnungsregel verwendet wird, wird ein Wert ungleich Null als Warnung verwendet. Infolgedessen werden drei Warnungsinstanzen erzeugt:

Labels	Status
{host=WEB1, DISK=/etc}	Warnfunktion
{Host=Web2, Festplatte=/var}	Warnfunktion
{host=WEB3, Festplatte=/var}	Normal