Verwendung mathematischer Ausdrücke mit CloudWatch Metriken - Amazon CloudWatch
Fügen Sie einem CloudWatch Diagramm einen mathematischen Ausdruck hinzuSyntax und Funktionen von MetrikberechnungenVerwenden von IF-AusdrückenAnomalieerkennung bei Metrikberechnungen

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.

Verwendung mathematischer Ausdrücke mit CloudWatch Metriken

Mit metrischer Mathematik können Sie mehrere CloudWatch Metriken abfragen und mithilfe mathematischer Ausdrücke neue Zeitreihen auf der Grundlage dieser Metriken erstellen. Sie können die resultierenden Zeitreihen auf der CloudWatch Konsole visualisieren und sie zu Dashboards hinzufügen. Am Beispiel von AWS Lambda Metriken könnten Sie die Errors Metrik durch die Invocations Metrik dividieren, um eine Fehlerquote zu erhalten. Fügen Sie dann die resultierende Zeitreihe zu einem Diagramm auf Ihrem CloudWatch Dashboard hinzu.

Mithilfe der Operation können Sie metrische Berechnungen auch programmgesteuert durchführen. GetMetricData API Weitere Informationen finden Sie unter. GetMetricData

Fügen Sie einem CloudWatch Diagramm einen mathematischen Ausdruck hinzu

Sie können einem Diagramm auf Ihrem CloudWatch Dashboard einen mathematischen Ausdruck hinzufügen. Jedes Diagramm ist auf die Nutzung von maximal 500 Metriken und Ausdrücke begrenzt. Daher können Sie einen mathematischen Ausdruck nur dann hinzufügen, wenn das Diagramm 499 oder weniger Metriken aufweist. Dies gilt auch dann, wenn nicht alle Metriken im Diagramm angezeigt werden.

So fügen Sie einem Diagramm einen mathematischen Ausdruck hinzu

  1. Öffnen Sie die CloudWatch Konsole unter https://console.aws.amazon.com/cloudwatch/.

  2. Erstellen oder bearbeiten Sie ein Diagramm. Es muss mindestens eine Metrik im Diagramm vorhanden sein.

  3. Wählen Sie Graphed metrics (Grafisch dargestellte Metrik) aus.

  4. Wählen Sie die Option Math expression (mathematischer Ausdruck), Start with empty expression (Mit leerem Ausdruck beginnen) aus. Eine neue Zeile wird für den Ausdruck angezeigt.

  5. Geben Sie in der neuen Zeile unter der Spalte Details den mathematischen Ausdruck ein. In den Tabellen im Abschnitt Metriken Mathematische Syntax und Funktionen werden die Funktionen aufgeführt, die Sie in dem Ausdruck verwenden können.

    Um eine Metrik oder das Ergebnis eines anderen Ausdrucks als Teil der Formel für diesen Ausdruck zu verwenden, verwenden Sie den Wert in der ID-Spalte: zum Beispiel m1+m2 oder e1- MIN (e1).

    Sie können den Wert von Id (ID) ändern. Er kann Ziffern, Buchstaben und Unterstriche enthalten und muss mit einem Kleinbuchstaben beginnen. Sie können das Diagramm leichter lesbar machen, indem Sie den ID-Wert umbenennen, zum Beispiel von m1 und m2 zu errors (Fehler) und requests (Anfragen).

    Tipp

    Wählen Sie den Pfeil nach unten neben Math Expression (Mathematischer Ausdruck), um eine Liste der unterstützten Funktionen anzuzeigen, die Sie beim Erstellen des Ausdrucks verwenden können.

  6. Geben Sie in der Spalte Label (Bezeichnung) des Ausdrucks einen Namen ein, der beschreibt, was der Ausdruck berechnet.

    Wenn das Ergebnis eines Ausdrucks ein Array von Zeitreihen ist, wird jede dieser Zeitreihen in dem Diagramm als eigene Zeile in einer eigenen Farbe angezeigt. Direkt unterhalb des Diagramms wird für jede Zeile im Diagramm eine Legende angezeigt. Bei einem einzelnen Ausdruck, der mehrere Zeitreihen erzeugt, haben die Legendenbeschriftungen für diese Zeitreihen das folgende Format Expression-Label Metric-Label. Wenn das Diagramm beispielsweise eine Metrik mit der Bezeichnung „Fehler“ und einen Ausdruck FILL(METRICS(), 0) mit der Bezeichnung „Gefüllt mit 0:“ enthält, würde eine Zeile in der Legende „Gefüllt mit 0: Fehler“ lauten. Damit in der Legende nur die ursprünglichen Metrikbeschriftungen angezeigt werden, legen Sie fest Expression-Label leer sein.

    Wenn ein Ausdruck ein Array mit Zeitreihen in dem Diagramm erzeugt, können Sie die Farben der einzelnen Zeitreihen nicht ändern.

  7. Nachdem Sie die gewünschten Ausdrücke hinzugefügt haben, können Sie optional das Diagramm vereinfachen, indem Sie einen Teil der ursprünglichen Metriken ausblenden. Um eine Metrik oder einen Ausdruck auszublenden, deaktivieren Sie das Kontrollkästchen links neben dem Feld Id (ID).

Syntax und Funktionen von Metrikberechnungen

In den folgenden Abschnitten werden die für Metrikberechnungen verfügbaren Funktionen erläutert. Alle Funktionen müssen in Großbuchstaben geschrieben werden (z. B. AVG), und das ID-Feld für alle Metriken und mathematischen Ausdrücke muss mit einem Kleinbuchstaben beginnen.

Das Endergebnis jedes mathematischen Ausdrucks muss eine einzelne Zeitreihe oder ein Array von Zeitreihen sein. Einige Funktionen erzeugen eine skalare Zahl. Sie können diese Funktionen innerhalb einer größeren Funktion verwenden, die letztendlich eine Zeitreihe generiert. Wenn Sie beispielsweise AVGaus einer einzigen Zeitreihe eine Skalarzahl nehmen, kann es sich nicht um das endgültige Ausdrucksergebnis handeln. Sie könnten es jedoch in der Funktion m1- AVG (m1) verwenden, um eine Zeitreihe der Differenz zwischen jedem einzelnen Datenpunkt und dem Durchschnittswert in der Zeitreihe anzuzeigen.

Datentypabkürzungen

Einige Funktionen sind nur für bestimmte Arten von Daten gültig. Die Abkürzungen in der folgenden Liste werden in den Tabellen der Funktionen verwendet, um die Datentypen darzustellen, die für jede Funktion unterstützt werden:

  • S stellt eine skalare Zahl dar, wie etwa 2, -5 oder 50,25.

  • TS ist eine Zeitreihe (eine Reihe von Werten für eine einzelne CloudWatch Metrik im Zeitverlauf): zum Beispiel die CPUUtilization Metrik für die i-1234567890abcdef0 letzten drei Tage.

  • TS [] ist ein Array von Zeitreihen, z. B. die Zeitreihe für mehrere Metriken.

  • String[] ist ein Array von Zeichenfolgen.

Die Funktion METRICS ()

Die Funktion METRICS() gibt alle Metriken in der Anfrage zurück. Mathematische Ausdrücke sind nicht enthalten.

Sie können METRICS() innerhalb eines größeren Ausdrucks verwenden, der eine einzelne Zeitreihe oder ein Array von Zeitreihen erzeugt. Beispielsweise gibt der Ausdruck SUM(METRICS()) eine Zeitreihe (TS) zurück, die die Summe der Werte aller grafisch dargestellten Metriken darstellt. METRICS() /100 gibt ein Array von Zeitreihen zurück, von denen jede eine Zeitreihe ist, die jeden Datenpunkt einer der Metriken geteilt durch 100 zeigt.

Sie können die Funktion METRICS() mit einer Zeichenfolge verwenden, um nur die grafisch dargestellten Metriken zurückzugeben, die diese Zeichenfolge in ihrem ID-Feld enthalten. Beispielsweise gibt der Ausdruck SUM(METRICS(„errors“)) eine Zeitreihe zurück, die die Summe der Werte aller grafisch dargestellten Metriken darstellt, deren ID-Feld „Fehler“ enthält. Sie können auch SUM([METRICS(„4xx“), METRICS („5xx“)]) verwenden, um mehrere Zeichenketten zuzuordnen.

Grundlegende arithmetische Funktionen

In der folgenden Tabelle sind die unterstützten grundlegenden arithmetischen Funktionen aufgeführt. Fehlende Werte in Zeitreihen werden als 0 (Null) behandelt. Wenn der Wert eines Datenpunkts dazu führt, dass eine Funktion versucht, durch Null zu teilen, wird dieser Datenpunkt verworfen.

Operation Argumente Beispiele

Arithmetische Operatoren: + - * / ^

S, S

S, TS

TS, TS

S, TS[]

TS, TS[]

PERIOD(m1) /60

5 * m1

m1 - m2

SUM(100/ [m1, m2])

AVG(METRICS())

METRICS() *100

Unäre Subtraktion –

S

TS

TS[]

-5*m1

-m1

SUM(- [m1, m2])

Vergleichs- und logische Operatoren

Sie können Vergleichs- und logische Operatoren entweder mit einem Paar von Zeitreihen oder einem Paar einzelner Skalarwerte verwenden. Wenn Sie einen Vergleichsoperator mit einem Paar von Zeitreihen verwenden, geben die Operatoren eine Zeitreihe zurück, bei der jeder Datenpunkt entweder 0 (false) oder 1 (true) ist. Wenn Sie einen Vergleichsoperator für ein Paar von skalaren Werten verwenden, wird ein einzelner skalarer Wert zurückgegeben, entweder 0 oder 1.

Wenn Vergleichsoperatoren zwischen zwei Zeitreihen verwendet werden und nur eine der Zeitreihen einen Wert für einen bestimmten Zeitstempel aufweist, behandelt die Funktion den fehlenden Wert in der anderen Zeitreihe als 0.

Sie können logische Operatoren in Verbindung mit Vergleichsoperatoren verwenden, um komplexere Funktionen zu erstellen.

In der folgenden Tabelle sind die unterstützten Operatoren aufgeführt.

Art des Operators Unterstützte Operatoren

Vergleichsoperatoren

==

!=

<=

>=

<

>

Logische Operatoren

ANDoder &&

ODER oder ||

Um zu sehen, wie diese Operatoren verwendet werden, nehmen wir an, wir haben zwei Zeitreihen: metric1 hat Werte von [30, 20, 0, 0] und metric2 hat Werte von [20, -, 20, -], wobei - anzeigt, dass es keinen Wert für diesen Zeitstempel gibt.

Expression Output

(metric1 < metric2)

0, 0, 1, 0

(metric1 >= 30)

1, 0, 0, 0

(metric1 > 15 AND metric2 > 15)

1, 0, 0, 0

Für Metrikberechnungen unterstützte Funktionen

In der folgenden Tabelle werden die Funktionen beschrieben, die Sie in mathematischen Ausdrücken verwenden können. Geben Sie alle Funktionen in Großbuchstaben ein.

Das Endergebnis jedes mathematischen Ausdrucks muss eine einzelne Zeitreihe oder ein Array von Zeitreihen sein. Einige Funktionen in Tabellen in den folgenden Abschnitten erzeugen skalare Zahlen. Sie können diese Funktionen innerhalb einer größeren Funktion verwenden, die letztendlich eine Zeitreihe generiert. Wenn Sie beispielsweise AVGaus einer einzigen Zeitreihe eine Skalarzahl nehmen, kann es sich nicht um das endgültige Ausdrucksergebnis handeln. Sie könnten es jedoch in der Funktion m1- AVG (m1) verwenden, um eine Zeitreihe der Differenz zwischen jedem einzelnen Datenpunkt und dem Durchschnittswert dieses Datenpunkts anzuzeigen.

In der folgenden Tabelle ist jedes Beispiel in der Spalte Examples (Beispiele) ein Ausdruck, der eine einzelne Zeitreihe oder ein Array von Zeitreihen erzeugt. Dies zeigt, wie Funktionen, die skalare Zahlen zurückgeben, in einem gültigen Ausdruck verwendet werden können, der eine einzelne Zeitreihe erzeugt.

Funktion Argumente Typ der Rückgabe* Beschreibung Beispiele Kontoübergreifender Support?

ABS

TS

TS[]

TS

TS[]

Gibt den absoluten Wert des einzelnen Datenpunkts zurück.

ABS(m1-m2)

MINABS([m1, m2])

ABS(METRICS())

 ✓

ANOMALY_DETECTION_BAND

TS

TS, S

TS[]

Gibt ein Anomalieerkennungsband für die angegebene Metrik zurück. Das Band besteht aus zwei Zeitreihen, einer für die Obergrenze des "normalen" erwarteten Wertes der Metrik und die andere für die Untergrenze. Die Funktion besitzt zwei mögliche Argumente. Das erste ist die ID der Metrik, für die das Band erstellt werden soll. Das zweite Argument ist die Anzahl der für das Band zu verwendenden Standardabweichungen. Wenn Sie dieses Argument nicht angeben, wird der Standardwert 2 verwendet wird. Weitere Informationen finden Sie unter Verwendung der CloudWatch Anomalieerkennung.

ANOMALYDETECTION_ BAND (m1)

ANOMALY_ DETECTION _ BAND (m1,4)

AVG

TS

TS[]

S

TS

Der Wert AVGeiner einzelnen Zeitreihe gibt einen Skalar zurück, der den Durchschnitt aller Datenpunkte in der Metrik darstellt. Der AVGWert einer Reihe von Zeitreihen gibt eine einzelne Zeitreihe zurück. Fehlende Werte werden als 0 (Null) behandelt.

Anmerkung

Wir empfehlen, diese Funktion nicht in CloudWatch Alarmen zu verwenden, wenn Sie möchten, dass die Funktion einen Skalar zurückgibt. Beispiel, AVG(m2). Immer wenn ein Alarm auswertet, ob der Status geändert werden soll, CloudWatch versucht er, eine höhere Anzahl von Datenpunkten abzurufen als die als Bewertungszeiträume angegebene Zahl. Diese Funktion wirkt anders, wenn zusätzliche Daten angefordert werden.

Um diese Funktion mit Alarmen zu verwenden, insbesondere mit Alarmen, die über Auto-Scaling-Aktionen verfügen, empfehlen wir Ihnen, den Alarm so einzustellen, dass er M von N Datenpunkten verwendet, wobei M < N ist.

SUM([m1, m2])/AVG(m2)

AVG(METRICS())

 ✓

CEIL

TS

TS[]

TS

TS[]

Gibt die Obergrenze jeder Metrik zurück. Die Obergrenze ist die kleinste Ganzzahl, die größer oder gleich jedem Wert ist.

CEIL(m1)

CEIL(METRICS())

SUM(CEIL(METRICS()))

 ✓

DATAPOINT_COUNT

TS

TS[]

S

TS

Gibt die Anzahl der Datenpunkte zurück, die Werte gemeldet haben. Dies ist nützlich für die Berechnung von Durchschnittswerten für spärlichere Metriken.

Anmerkung

Wir empfehlen, diese Funktion nicht bei CloudWatch Alarmen zu verwenden. Immer wenn ein Alarm auswertet, ob der Status geändert werden soll, CloudWatch versucht er, eine höhere Anzahl von Datenpunkten abzurufen als die als Bewertungszeiträume angegebene Anzahl. Diese Funktion wirkt anders, wenn zusätzliche Daten angefordert werden.

SUM(m1)/DATAPOINT_ COUNT (m1)

DATAPOINT_COUNT(METRICS())

 ✓

DB_ PERF INSIGHTS

Zeichenkette, Zeichenkette, Zeichenkette

String, String, String[]

TS (wenn eine einzelne Zeichenfolge angegeben wird)

TS [] (wenn ein Array von Zeichenketten angegeben wird)

Liefert Zählermetriken von Performance Insights für Datenbanken wie Amazon Relational Database Service und Amazon DocumentDB (mit MongoDB-Kompatibilität). Diese Funktion gibt dieselbe Datenmenge zurück, die Sie durch direkte Abfrage der Performance Insights APIs abrufen können. Sie können diese Metriken CloudWatch für die grafische Darstellung und Erstellung von Alarmen verwenden.

Wichtig

Wenn Sie diese Funktion verwenden, müssen Sie die eindeutige Datenbankressourcen-ID der Datenbank angeben. Dies unterscheidet sich von der Datenbank-ID. Um die Datenbankressourcen-ID in der RDS Amazon-Konsole zu finden, wählen Sie die DB-Instance aus, um ihre Details zu sehen. Wechseln Sie zur Registerkarte Konfiguration. Die Ressourcen-ID wird im Abschnitt Konfiguration angezeigt.

DB_ PERF _ fügt die DBLoad Metrik INSIGHTS auch in Intervallen unter einer Minute ein.

Mit dieser Funktion abgerufene Performance Insights Insights-Metriken werden nicht in gespeichert CloudWatch. Daher funktionieren einige CloudWatch Funktionen wie kontoübergreifende Observability, Anomalieerkennung, Metrik-Streams, Metrik-Explorer und Metric Insights nicht mit Performance Insights Insights-Metriken, die Sie mit DB_ _ abrufen. PERF INSIGHTS

Eine einzelne Anfrage mit der INSIGHTS Funktion DB_ PERF _ kann die folgende Anzahl von Datenpunkten abrufen.

  • 1080 Datenpunkte für Zeiträume mit hoher Auflösung (1s, 10s, 30s)

  • 1440 Datenpunkte für Zeiträume mit Standardauflösung (1 m, 5 m, 1 Stunde, 1 Tag)

Die INSIGHTS Funktion DB_ PERF _ unterstützt nur die folgenden Periodenlängen:

  • 1 Sekunde

  • 10 Sekunden

  • 30 Sekunden

  • 1 Minute

  • 5 Minuten

  • 1 Stunde

  • 1 Tag

Weitere Informationen zu Amazon RDS Performance Insights Insights-Zählermetriken finden Sie unter Performance Insights Insights-Zählermetriken.

Weitere Informationen zu den Zählermetriken aus Erkenntnissen zur Amazon-DocumentDB-Leistung finden Sie unter Zählermetriken für Performance Insights.

Anmerkung

Hochauflösende Metriken mit einer Granularität von unter einer Minute, die von DB_ PERF _ abgerufen INSIGHTS werden, gelten nur für die DBLoadMetrik oder für Betriebssystemmetriken, wenn Sie Enhanced Monitoring mit einer höheren Auflösung aktiviert haben. Weitere Informationen zu Amazon RDS Enhanced Monitoring finden Sie unter Überwachen von Betriebssystem-Metriken mit Enhanced Monitoring.

Sie können mit der INSIGHTS Funktion DB_ PERF _ einen Alarm mit hoher Auflösung für einen Zeitraum von maximal drei Stunden erstellen. Sie können die CloudWatch Konsole verwenden, um mit der INSIGHTS Funktion DB_ PERF _ abgerufene Metriken für einen beliebigen Zeitraum grafisch darzustellen.

DB_ PERF _ INSIGHTS ('RDS', 'db- ABCDEFGHIJKLMNOPQRSTUVWXY1 ', 'os. cpuUtilization.benutzer.avg')

DB_ PERF _ INSIGHTS ('DOCDB, 'db-', ['os. ABCDEFGHIJKLMNOPQRSTUVWXY1 cpuUtilization.idle.avg', 'os. cpuUtilization.user.max'])

DIFF

TS

TS[]

TS

TS[]

Gibt die Differenz zwischen jedem Wert in der Zeitreihe und dem vorhergehenden Wert aus dieser Zeitreihe zurück.

DIFF(m1)

 ✓

DIFF_TIME

TS

TS[]

TS

TS[]

Gibt die Differenz in Sekunden zwischen dem Zeitstempel jedes Wertes in der Zeitreihe und dem Zeitstempel des vorhergehenden Wertes aus dieser Zeitreihe zurück.

DIFF_TIME(METRICS())

 ✓

FILL

TS, [S | REPEAT |LINEAR]

TS [], [TS | S | REPEAT |LINEAR]

TS

TS[]

Füllt die fehlenden Werte einer Zeitreihe. Es gibt mehrere Optionen für die Werte, die als Füllstoff für fehlende Werte verwendet werden sollen:

  • Sie können einen Wert angeben, der als Füllwert verwendet werden soll.

  • Sie können eine Metrik angeben, die als Füllungswert verwendet werden soll.

  • Sie können das REPEATSchlüsselwort verwenden, um fehlende Werte mit dem neuesten tatsächlichen Wert der Metrik vor dem fehlenden Wert zu füllen.

  • Sie können das LINEARSchlüsselwort verwenden, um die fehlenden Werte mit Werten zu füllen, die eine lineare Interpolation zwischen den Werten am Anfang und Ende der Lücke erzeugen.

Anmerkung

Wenn Sie diese Funktion in einem Alarm verwenden, kann ein Problem auftreten, wenn Ihre Metriken mit einer leichten Verzögerung veröffentlicht werden und die letzte Minute keine Daten enthält. FILLErsetzt in diesem Fall den fehlenden Datenpunkt durch den angeforderten Wert. Das führt dazu, dass der letzte Datenpunkt für die Metrik immer der FILL Wert ist, was dazu führen kann, dass der Alarm entweder im Status OK oder ALARM im Status hängen bleibt. Sie können dies umgehen, indem Sie einen M-aus-N-Alarm verwenden. Weitere Informationen finden Sie unter Auswerten eines Alarms.

FILL(m1,10)

FILLMETRICS(), 0)

FILLMETRICS(), m1)

FILL(m1, MIN (m1))

FILL(m1,REPEAT)

FILL(METRICS(), LINEAR)

 ✓

FIRST

LAST

TS[]

TS

Gibt die erste oder letzte Zeitreihe aus einem Array von Zeitreihen zurück. Dies ist nützlich, wenn es mit der SORTFunktion verwendet wird. Es kann auch verwendet werden, um die hohen und niedrigen Schwellenwerte aus der BAND Funktion ANOMALY_ DETECTION _ abzurufen.

IF (FIRST(SORTMETRICS(),AVG,DESC)) >100, 1, 0) Betrachtet die oberste Metrik aus einem Array, sortiert nach. AVG Es gibt dann eine 1 oder 0 für jeden Datenpunkt zurück, je nachdem, ob dieser Datenpunktwert über 100 liegt.

LAST(ANOMALY_ DETECTION _ BAND (m1)) gibt die Obergrenze des Prognosebandes für Anomalien zurück.

 ✓

FLOOR

TS

TS[]

TS

TS[]

Gibt die Untergrenze jeder Metrik zurück. Die Untergrenze ist die größte Ganzzahl, die kleiner oder gleich jedem Wert ist.

FLOOR(m1)

FLOOR(METRICS())

 ✓

IF

IF-Ausdruck

TS

Verwenden Sie IF zusammen mit einem Vergleichsoperator, um Datenpunkte aus einer Zeitreihe herauszufiltern oder eine gemischte Zeitreihe zu erstellen, die aus mehreren sortierten Zeitreihen besteht. Weitere Informationen finden Sie unter Verwenden von IF-Ausdrücken.

Beispiele finden Sie unter Verwenden von IF-Ausdrücken.

 ✓

INSIGHT_RULE_METRIC

INSIGHT_RULE_METRIC(ruleName, metricName)

TS

Verwenden Sie INSIGHT_ RULE _ METRIC, um Statistiken aus einer Regel in Contributor Insights zu extrahieren. Weitere Informationen finden Sie unter Grafische Darstellung von Metriken, die durch Regeln generiert wurden, in CloudWatch.

LAMBDA

LAMBDA(LambdaFunctionName [, optionales Argument] *)

TS

TS[]

Ruft eine Lambda-Funktion auf, um Metriken aus einer Datenquelle abzufragen, die dies nicht CloudWatch ist. Weitere Informationen finden Sie unter So übergeben Sie Argumente an Ihre Lambda-Funktion.

LOG

TS

TS[]

TS

TS[]

Der Wert LOGeiner Zeitreihe gibt den natürlichen Logarithmuswert jedes Werts in der Zeitreihe zurück.

LOG(METRICS())

 ✓

LOG10

TS

TS[]

TS

TS[]

Die LOG10 einer Zeitreihe gibt den Logarithmuswert zur Basis 10 für jeden Wert in der Zeitreihe zurück.

LOG10 (m1)

 ✓

MAX

TS

TS[]

S

TS

Der Wert MAXeiner einzelnen Zeitreihe gibt einen Skalar zurück, der den Maximalwert aller Datenpunkte in der Metrik darstellt.

Wenn Sie ein Array von Zeitreihen eingeben, erstellt die MAXFunktion eine Zeitreihe und gibt sie zurück, die aus dem höchsten Wert für jeden Datenpunkt unter den Zeitreihen besteht, die als Eingabe verwendet wurden.

Anmerkung

Wir empfehlen, diese Funktion nicht in CloudWatch Alarmen zu verwenden, wenn Sie möchten, dass die Funktion einen Skalar zurückgibt. MAX(m2)Wenn ein Alarm beispielsweise auswertet, ob der Status geändert werden soll, CloudWatch versucht er, eine höhere Anzahl von Datenpunkten abzurufen als die als Bewertungszeiträume angegebene Zahl. Diese Funktion wirkt anders, wenn zusätzliche Daten angefordert werden.

MAX(m1) /m1

MAX(METRICS())

 ✓

METRIC_COUNT

TS[]

S

Gibt die Anzahl der Metriken im Zeitreihen-Array zurück.

m1/ METRIC _ COUNT () METRICS

 ✓

METRICS

Null

Zeichenfolge

TS[]

Die Funktion METRICS() gibt alle CloudWatch Metriken in der Anfrage zurück. Mathematische Ausdrücke sind nicht enthalten.

Sie können METRICS() innerhalb eines größeren Ausdrucks verwenden, der eine einzelne Zeitreihe oder ein Array von Zeitreihen erzeugt.

Sie können die Funktion METRICS() mit einer Zeichenfolge verwenden, um nur die grafisch dargestellten Messwerte zurückzugeben, die diese Zeichenfolge in ihrem ID-Feld enthalten. Beispielsweise gibt der Ausdruck SUM(METRICS(„errors“)) eine Zeitreihe zurück, die die Summe der Werte aller grafisch dargestellten Metriken darstellt, deren ID-Feld „Fehler“ enthält. Sie können auch SUM([METRICS(„4xx“), METRICS („5xx“)]) verwenden, um mehrere Zeichenketten zuzuordnen.

AVG(METRICS())

SUM(METRICS(„Fehler“))

 ✓

MIN

TS

TS[]

S

TS

Der Wert MINeiner einzelnen Zeitreihe gibt einen Skalar zurück, der den Minimalwert aller Datenpunkte in der Metrik darstellt.

Wenn Sie ein Array von Zeitreihen eingeben, erstellt die MINFunktion eine Zeitreihe und gibt sie zurück, die aus dem niedrigsten Wert für jeden Datenpunkt unter den Zeitreihen besteht, die als Eingabe verwendet wurden.

Wenn Sie ein Array von Zeitreihen eingeben, erstellt die MINFunktion eine Zeitreihe und gibt sie zurück, die aus dem niedrigsten Wert für jeden Datenpunkt unter den Zeitreihen besteht, die als Eingabe verwendet wurden.

Anmerkung

Wir empfehlen, diese Funktion nicht in CloudWatch Alarmen zu verwenden, wenn Sie möchten, dass die Funktion einen Skalar zurückgibt. MIN(m2)Wenn ein Alarm beispielsweise auswertet, ob der Status geändert werden soll, CloudWatch versucht er, eine höhere Anzahl von Datenpunkten abzurufen als die als Bewertungszeiträume angegebene Zahl. Diese Funktion wirkt anders, wenn zusätzliche Daten angefordert werden.

m1- MIN (m1)

MIN(METRICS())

 ✓

MINUTE

HOUR

DAY

DATE

MONTH

YEAR

EPOCH

TS

TS

Diese Funktionen nehmen den Zeitraum und den Bereich der Zeitreihe und geben eine neue nicht-spärliche Zeitreihe zurück, bei der jeder Wert auf seinem Zeitstempel basiert.

  • MINUTEgibt eine Zeitreihe mit ganzen Zahlen zwischen 0 und 59 zurück, die die UTC Minute jedes Zeitstempels in der ursprünglichen Zeitreihe darstellen.

  • HOURgibt eine Zeitreihe mit ganzen Zahlen zwischen 0 und 23 zurück, die die UTC Stunde jedes Zeitstempels in der ursprünglichen Zeitreihe darstellen.

  • DAYgibt eine Zeitreihe mit ganzen Zahlen zwischen 1 und 7 zurück, die UTC den Wochentag jedes Zeitstempels in der ursprünglichen Zeitreihe darstellen. 1 steht für Montag und 7 für Sonntag.

  • DATEgibt eine Zeitreihe mit ganzen Zahlen zwischen 1 und 31 zurück, die den UTC Tag des Monats jedes Zeitstempels in der ursprünglichen Zeitreihe darstellen.

  • MONTHgibt eine Zeitreihe mit ganzen Zahlen zwischen 1 und 12 zurück, die den UTC Monat jedes Zeitstempels in der ursprünglichen Zeitreihe darstellen. 1 steht für Januar und 12 für Dezember.

  • YEARgibt eine Zeitreihe von Ganzzahlen zurück, bei der es sich nicht um dünn besetzte Zahlen handelt, die das UTC Jahr jedes Zeitstempels in der ursprünglichen Zeitreihe darstellen.

  • EPOCHgibt eine Zeitreihe von ganzen Zahlen zurück, die keine geringe Dichte aufweisen und die UTC Zeit in Sekunden seit der Epoche jedes Zeitstempels in der ursprünglichen Zeitreihe darstellen. Die Epoche ist der 1. Januar 1970.

MINUTE(m1)

IF (DAY(m1) <6, m1) gibt nur Messwerte von Montag bis Freitag zurück.

IF (MONTH(m1) == 4, m1) gibt nur Messwerte zurück, die im April veröffentlicht wurden.

 ✓

PERIOD

TS

S

Gibt den Zeitraum der Metrik in Sekunden zurück. Als Eingabe sind Metriken, jedoch nicht die Ergebnisse anderer Ausdrücke zulässig.

m1/ PERIOD (m1)

 ✓

RATE

TS

TS[]

TS

TS[]

Gibt die Änderungsrate der Metrik pro Sekunde zurück. Dieser Wert wird als Differenz zwischen dem letzten Datenpunktwert und dem vorherigen Datenpunktwert, geteilt durch die zeitliche Differenz in Sekunden zwischen den beiden Werten berechnet.

Wichtig

Das Setzen von Alarmen für Ausdrücke, die die RATE Funktion für Metriken mit spärlichen Daten verwenden, kann sich unvorhersehbar verhalten, da der Bereich der bei der Auswertung des Alarms abgerufenen Datenpunkte je nach dem Zeitpunkt der letzten Veröffentlichung der Datenpunkte variieren kann.

RATE(m1)

RATE(METRICS())

 ✓

REMOVE_EMPTY

TS[]

TS[]

Entfernt alle Zeitreihen, die keine Datenpunkte haben, aus einem Array von Zeitreihen. Das Ergebnis ist ein Array von Zeitreihen, in dem jede Zeitreihe mindestens einen Datenpunkt enthält.

Anmerkung

Wir empfehlen, diese Funktion nicht bei CloudWatch Alarmen zu verwenden. Immer wenn ein Alarm auswertet, ob der Status geändert werden soll, CloudWatch versucht er, eine höhere Anzahl von Datenpunkten abzurufen als die als Bewertungszeiträume angegebene Anzahl. Diese Funktion wirkt anders, wenn zusätzliche Daten angefordert werden.

REMOVE_EMPTY(METRICS())

✓

RUNNING_SUM

TS

TS[]

TS

TS[]

Gibt eine Zeitreihe mit der laufenden Summe der Werte in der ursprünglichen Zeitreihe zurück.

Anmerkung

Wir empfehlen, diese Funktion nicht für CloudWatch Alarme zu verwenden. Immer wenn ein Alarm auswertet, ob der Status geändert werden soll, CloudWatch versucht er, eine höhere Anzahl von Datenpunkten abzurufen als die als Bewertungszeiträume angegebene Anzahl. Diese Funktion wirkt anders, wenn zusätzliche Daten angefordert werden.

RUNNING_ SUM ([m1, m2])

 ✓

SEARCH

Suchausdruck

Eine oder mehrere Zeitreihen

Gibt eine oder mehrere Zeitreihen zurück, die den angegebenen Suchkriterien entsprechen. Mit dieser SEARCHFunktion können Sie einem Diagramm mit einem Ausdruck mehrere verwandte Zeitreihen hinzufügen. Das Diagramm wird dynamisch aktualisiert, um die später hinzugefügten Metriken einzuschließen und den Suchkriterien zu entsprechen. Weitere Informationen finden Sie unter Suchausdrücke in Diagrammen verwenden.

Sie können keinen Alarm auf der Grundlage eines SEARCHAusdrucks erstellen. Dies liegt daran, dass Suchausdrücke mehrere Zeitreihen zurückgeben und ein auf einem mathematischen Ausdruck basierender Alarm nur eine Zeitreihe anzeigen kann.

Wenn Sie bei einem Überwachungskonto mit CloudWatch kontenübergreifender Observability angemeldet sind, sucht die SEARCHFunktion nach Metriken in den Quellkonten und im Monitoring-Konto.

 ✓

SERVICE_QUOTA

TS, das eine Nutzungsmetrik ist

TS

Gibt das Servicekontingent für die angegebene Nutzungsmetrik zurück. Sie können dies verwenden, um Ihre aktuelle Nutzung im Vergleich zum Kontingent zu visualisieren, und um Alarme einzustellen, die Sie warnen, wenn Sie sich dem Kontingent nähern. Weitere Informationen finden Sie unter AWS Nutzungsmetriken.

 ✓

SLICE

(TS[], S, S) oder (TS[], S)

TS[]

TS

Ruft einen Teil eines Arrays von Zeitreihen ab. Dies ist besonders nützlich, wenn es mit kombiniert wird. SORT Beispielsweise können Sie das oberste Ergebnis aus einem Array von Zeitreihen ausschließen.

Sie können zwei skalare Argumente verwenden, um den Satz von Zeitreihen zu definieren, die zurückgegeben werden sollen. Die beiden Skalare definieren den Anfang (inklusive) und Ende (exklusiv) des auszugebenden Arrays. Das Array ist null-indiziert, so dass die erste Zeitreihe im Array Zeitreihe 0 ist. Sie können auch nur einen Wert angeben und alle Zeitreihen CloudWatch zurückgeben, die mit diesem Wert beginnen.

SLICE(SORTMETRICS(),,DESC)SUM, 0, 10) gibt die 10 Metriken aus dem Array von Metriken in der Anfrage zurück, die den höchsten SUM Wert haben.

SLICE(SORTMETRICS(),,ASC)AVG, 5) sortiert das Array der Metriken nach der AVG Statistik und gibt dann alle Zeitreihen zurück, mit Ausnahme der 5 mit dem niedrigstenAVG.

 ✓

SORT

(TS [],FUNCTION, SORT _ORDER)

(TS []FUNCTION, SORT _ORDER, S)

TS[]

Sortiert ein Array von Zeitreihen entsprechend der von Ihnen angegebenen Funktion. Die Funktion, die Sie verwenden können AVG, MINMAX, oder sein SUM. Die Sortierreihenfolge kann entweder ASCaufsteigend (niedrigste Werte zuerst) oder DESCdie höheren Werte zuerst sortiert werden. Sie können optional eine Zahl nach der Sortierreihenfolge angeben, die als Grenzwert fungiert. Wenn Sie beispielsweise einen Grenzwert von 5 angeben, werden nur die fünf wichtigsten Zeitreihen der Sortierung zurückgegeben.

Wenn diese mathematische Funktion in einem Diagramm angezeigt wird, werden die Beschriftungen für jede Metrik in dem Diagramm ebenfalls sortiert und nummeriert.

SORTMETRICS(),, AVGDESC, 10) berechnet den Durchschnittswert jeder Zeitreihe, sortiert die Zeitreihe mit den höchsten Werten zu Beginn der Sortierung und gibt nur die 10 Zeitreihen mit den höchsten Durchschnittswerten zurück.

SORTMETRICS(),MAX,ASC) sortiert das Array der Metriken nach der MAX Statistik und gibt dann alle Metriken in aufsteigender Reihenfolge zurück.

 ✓

STDDEV

TS

TS[]

S

TS

Der Wert STDDEVeiner einzelnen Zeitreihe gibt einen Skalar zurück, der die Standardabweichung aller Datenpunkte in der Metrik darstellt. Der STDDEVWert einer Reihe von Zeitreihen gibt eine einzelne Zeitreihe zurück.

Anmerkung

Wir empfehlen, diese Funktion nicht in CloudWatch Alarmen zu verwenden, wenn Sie möchten, dass die Funktion einen Skalar zurückgibt. STDDEV(m2)Wenn ein Alarm beispielsweise auswertet, ob der Status geändert werden soll, CloudWatch versucht er, eine höhere Anzahl von Datenpunkten abzurufen als die als Bewertungszeiträume angegebene Zahl. Diese Funktion wirkt anders, wenn zusätzliche Daten angefordert werden.

m1/ STDDEV (m1)

STDDEV(METRICS())

 ✓

SUM

TS

TS[]

S

TS

Der Wert SUMeiner einzelnen Zeitreihe gibt einen Skalar zurück, der die Summe der Werte aller Datenpunkte in der Metrik darstellt. Der SUMWert einer Reihe von Zeitreihen gibt eine einzelne Zeitreihe zurück.

Anmerkung

Wir empfehlen, diese Funktion nicht in CloudWatch Alarmen zu verwenden, wenn Sie möchten, dass die Funktion einen Skalar zurückgibt. Beispiel, SUM(m1). Immer wenn ein Alarm auswertet, ob der Status geändert werden soll, CloudWatch versucht er, eine höhere Anzahl von Datenpunkten abzurufen als die als Bewertungszeiträume angegebene Zahl. Diese Funktion wirkt anders, wenn zusätzliche Daten angefordert werden.

SUMMETRICS()/SUM(m1)

SUM([m1, m2])

SUM(METRICS(„Fehler“))/SUM(METRICS(„Anfragen“)) *100

 ✓

TIME_SERIES

S

TS

Gibt eine nicht-spärliche Zeitreihe zurück, bei der jeder Wert auf ein skalares Argument gesetzt wird.

TIME_ SERIES (MAX(m1))

TIME_ SERIES (5* AVG (m1))

TIME_ SERIES (10)

 ✓

*Das Verwenden einer Funktion, die nur eine skalare Zahl zurückgibt, ist nicht gültig, da alle finalen Ergebnisse von Ausdrücken eine einzelne Zeitreihe oder ein Array von Zeitreihen sein müssen. Verwenden Sie stattdessen diese Funktionen als Teil eines größeren Ausdrucks, der eine Zeitreihe zurückgibt.

Verwenden von IF-Ausdrücken

Verwenden Sie IF zusammen mit einem Vergleichsoperator, um Datenpunkte aus einer Zeitreihe herauszufiltern oder eine gemischte Zeitreihe zu erstellen, die aus mehreren sortierten Zeitreihen besteht.

IF verwendet die folgenden Argumente:

IF(condition, trueValue, falseValue)

Die Bedingung wird dahingehend ausgewertet, FALSE ob der Wert des Bedingungsdatenpunkts 0 ist, und TRUE ob der Wert der Bedingung ein anderer Wert ist, unabhängig davon, ob dieser Wert positiv oder negativ ist. Wenn es sich bei der Bedingung um eine Zeitreihe handelt, wird sie für jeden Zeitstempel separat ausgewertet.

Im Folgenden werden die gültigen Syntaxregeln aufgeführt. Für jede dieser Syntaxregeln ist die Ausgabe eine einzelne Zeitreihe.

  • WENN (TS) Comparison Operator S, S | TS, S | TS)

    Anmerkung

    Wenn das TS comparison operator S istTRUE, aber metric2 keinen entsprechenden Datenpunkt hat, ist die Ausgabe 0.

  • IF(TS, TS, TS)

  • IF(TS, S, TS)

  • IF(TS, TS, S)

  • IF(TS, S, S)

  • IF(S, TS, TS)

In den folgenden Abschnitten finden Sie weitere Details und Beispiele für diese Syntaxregeln.

WENN (TS) Comparison Operator S, skalar2 | metrisch2, skalar3 | metrisch3)

Der entsprechende Ausgabezeitreihenwert:

  • hat den Wert von scalar2 oder metric2, falls TS Comparison Operator S ist TRUE

  • hat den Wert von scalar3 oder metric3, falls TS Comparison Operator S ist FALSE

  • hat den Wert 0, wenn TS Comparison Operatorist TRUE und der entsprechende Datenpunkt in metric2 existiert nicht.

  • hat den Wert 0, wenn der TS Comparison Operatorist FALSE und der entsprechende Datenpunkt in metric3 existiert nicht.

  • ist eine leere Zeitreihe, wenn der entsprechende Datenpunkt von nicht in metric3, vorhanden ist oder wenn scalar3/metric3 im Ausdruck weggelassen wird

IF(metric1, metric2, metric3)

Für jeden Datenpunkt von metric1, der entsprechende Ausgabezeitreihenwert:

  • hat den Wert von metric2, falls der entsprechende Datenpunkt von metric1 TRUE

  • hat den Wert von metric3, falls der entsprechende Datenpunkt von metric1 ist. FALSE

  • hat den Wert 0, wenn der entsprechende Datenpunkt von metric1 ist TRUE und der entsprechende Datenpunkt in metric2 nicht existiert.

  • wird gelöscht, wenn der entsprechende Datenpunkt von metric1 ist FALSE und der entsprechende Datenpunkt nicht in metric3 existiert

  • wird gelöscht, wenn der entsprechende Datenpunkt von metric1 ist FALSE und metric3 im Ausdruck weggelassen wird.

  • wird gelöscht, wenn der entsprechende Datenpunkt von metric1 fehlt.

Die folgende Tabelle zeigt ein Beispiel für diese Syntax.

Metrik oder Funktion Werte

(metric1)

[1, 1, 0, 0, -]

(metric2)

[30, -, 0, 0, 30]

(metric3)

[0, 0, 20, -, 20]

IF(metric1, metric2, metric3)

[30, 0, 20, 0, -]

IF(metric1, scalar2, metric3)

Für jeden Datenpunkt von metric1, der entsprechende Ausgabezeitreihenwert:

  • hat den Wert von scalar2, falls der entsprechende Datenpunkt von metric1 TRUE

  • hat den Wert von metric3, falls der entsprechende Datenpunkt von metric1 ist. FALSE

  • wird gelöscht, wenn der entsprechende Datenpunkt von metric1 ist FALSE und der entsprechende Datenpunkt auf metric3 nicht existiert, oder wenn metric3 im Ausdruck weggelassen wird.

Metrik oder Funktion Werte

(metric1)

[1, 1, 0, 0, -]

scalar2

5

(metric3)

[0, 0, 20, -, 20]

IF(metric1, scalar2, metric3)

[5, 5, 20, -, -]

IF(metric1, metric2, scalar3)

Für jeden Datenpunkt von metric1, der entsprechende Ausgabezeitreihenwert:

  • hat den Wert von metric2, falls der entsprechende Datenpunkt von metric1 ist. TRUE

  • hat den Wert von scalar3, falls der entsprechende Datenpunkt von metric1 ist. FALSE

  • hat den Wert 0, wenn der entsprechende Datenpunkt von metric1 ist TRUE und der entsprechende Datenpunkt in metric2 nicht existiert.

  • wird gelöscht, wenn der entsprechende Datenpunkt in metric1 nicht vorhanden ist.

Metrik oder Funktion Werte

(metric1)

[1, 1, 0, 0, -]

(metric2)

[30, -, 0, 0, 30]

scalar3

5

IF(metric1, metric2, scalar3)

[30, 0, 5, 5, -]

IF(scalar1, metric2, metric3)

Der entsprechende Ausgabezeitreihenwert:

  • hat den Wert metric2, falls scalar1 ist. TRUE

  • hat den Wert von metric3, falls scalar1 ist. FALSE

  • ist eine leere Zeitreihe, wenn metric3 im Ausdruck weggelassen wird.

Anwendungsbeispiele für IF-Ausdrücke

Die folgenden Beispiele veranschaulichen die mögliche Verwendung der IF-Funktion .

  • So zeigen Sie nur die niedrigen Werte einer Metrik an:

    IF(metric1<400, metric1)

  • So ändern Sie jeden Datenpunkt in einer Metrik in einen von zwei Werten, um relative Höhen und Tiefen der ursprünglichen Metrik anzuzeigen:

    IF(metric1<400,10,2)

  • So zeigen Sie eine 1 für jeden Zeitstempel an, bei dem die Latenz über dem Schwellenwert liegt, und eine 0 für alle anderen Datenpunkte:

    IF(latency>threshold, 1, 0)

Verwenden Sie metrische Mathematik für die Operation GetMetricData API

Sie können GetMetricData damit Berechnungen mit mathematischen Ausdrücken durchführen und auch große Stapel metrischer Daten in einem API Aufruf abrufen. Weitere Informationen finden Sie unter GetMetricData.

Anomalieerkennung bei Metrikberechnungen

Die Anomalieerkennung bei Metrikberechnungen ist ein Feature, mit dem Sie Alarme für die Anomalieerkennung basierend auf einzelnen Metriken und metrischen mathematischen Ausdrücken erstellen können. Sie können diese Ausdrücke verwenden, um Diagramme zu erstellen, die Anomalieerkennungsbänder visualisieren. Das Feature unterstützt grundlegende arithmetische Funktionen, Vergleichs- und logische Operatoren sowie die meisten anderen Funktionen.

Die Anomalieerkennung bei Metrikberechnungen unterstützt die folgenden Funktionen nicht:

  • Ausdrücke, die mehr als ein ANOMALY_ DETECTION _ BAND in derselben Zeile enthalten.

  • Ausdrücke, die mehr als 10 Metriken oder mathematische Ausdrücke enthalten.

  • Ausdrücke, die den METRICSAusdruck enthalten.

  • Ausdrücke, die die SEARCHFunktion enthalten.

  • Ausdrücke, die die INSIGHTS Funktion DP_ PERF _ verwenden.

  • Ausdrücke, die Metriken mit verschiedenen Perioden verwenden.

  • Metrische mathematische Anomaliedetektoren, die hochauflösende Metriken als Eingabe verwenden.

Weitere Informationen zu dieser Funktion finden Sie unter Verwenden der CloudWatch Anomalieerkennung im CloudWatch Amazon-Benutzerhandbuch.