Verwenden der Metrik-Abfrageoption zum Abfragen von CloudWatch Metrics Insights-Daten

Anmerkung

Amazon CloudWatch Metrics Insights befindet sich in der Vorschauversion. CloudWatch Die Funktionen von Metrics Insights stehen allen offen AWS-Konten. Die Funktionen können sich ändern.

Sie können CloudWatch Metrics Insights-Daten abfragen, indem Sie den metric query Modus im Metrik-Abfrage-Editor auswählen.

CloudWatch Metrics Insights ist eine leistungsstarke SQL-Abfrage-Engine, mit der Sie Ihre Metriken maßstabsgetreu abfragen können. Es ist eine schnelle, flexible, SQL-basierte Abfrage-Engine, mit der Sie Trends und Muster in all Ihren CloudWatch Metriken in Echtzeit identifizieren können. Sie verwendet einen SQL-Dialekt. Weitere Hinweise zur Metrics Insights-Abfragesyntax finden Sie unterAbfragesyntax und Schlüsselwörter.

Abfragesyntax und Schlüsselwörter

CloudWatch Metrics Insights verwendet einen SQL-Dialekt. Das folgende Beispiel zeigt die Abfragesyntax.

SELECT FUNCTION(metricName)
FROM namespace | [ SCHEMA(namespace[, labelKey [, ...] ]) ]
     [ WHERE labelKey OPERATOR labelValue [AND|OR|([...])*] [, ...] ]
[ GROUP BY labelKey [, ...]]
[ ORDER BY FUNCTION() [DESC | ASC] ]
[ LIMIT number]

Bei Schlüsselwörtern wird nicht zwischen Groß- und Kleinschreibung unterschieden, bei den Bezeichnern wird jedoch zwischen Groß- und Kleinschreibung unterschieden. Zu den Identifikatoren gehören die Namen von Metriken, Namespaces und Dimensionen.

Die folgende Tabelle enthält die Abfrageschlüsselwörter und ihre Beschreibungen.

Stichwort	Beschreibung
FUNCTION	Erforderlich Gibt die zu verwendende Aggregatfunktion sowie den Namen der abzufragenden Metrik an. Gültige Werte sind AVG, COUNT, MAX, MIN und SUM.
MetricName	Erforderlich Beispiel, CPUUtilization.
FROM	Erforderlich Gibt die Quelle der Metrik an. Sie können entweder den Metrik-Namespace angeben, der die abzufragende Metrik enthält, oder eine SCHEMA-Tabellenfunktion. Einige Namespace-Beispiele sind AWS/EC2 und. AWS/Lambda
SCHEMA	(Optional) Filtert die Abfrageergebnisse so, dass nur die Metriken angezeigt werden, die exakt übereinstimmen, oder die Metriken, die nicht übereinstimmen.
WHERE	(Optional) Filtert die Ergebnisse, sodass nur die Metriken angezeigt werden, die Ihrem angegebenen Ausdruck entsprechen. Beispiel, WHERE InstanceType != 'c3.4xlarge'.
GROUP BY	(Optional) Gruppiert die Abfrageergebnisse in mehrere Zeitreihen. Beispiel, GROUP BY ServiceName.
ORDER BY	(Optional) Gibt die Reihenfolge der zurückzugebenden Zeitreihen an. Die Optionen sind ASC undDESC.
LIMIT	(Optional) Beschränkt die Anzahl der zurückzugebenden Zeitreihen.

Im Folgenden sind einige Beispiele aufgeführt:

• SELECT AVG(CPUUtilization) FROM "AWS/EC2" 

  Entspricht allen CPUUtilization Metriken im AWS/EC2 Namespace, ignoriert deren Dimensionen und gibt eine einzelne aggregierte Zeitreihe zurück.

• SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2")

  Entspricht nur den CPUUtilization Metriken im AWS/EC2 Namespace, für die keine Dimensionen definiert sind.

• SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2", InstanceId)

  Entspricht nur den CPUUtilization Metriken, für die berichtet wurde, CloudWatch mit genau einer Dimension,InstanceId.

• SELECT SUM(RequestCount) FROM SCHEMA("AWS/ApplicationELB", LoadBalancer,
  AvailabilityZone) 

  Stimmt nur mit den RequestCount Metriken überein, an die CloudWatch berichtet wurde, AWS/ApplicationELB mit genau zwei Dimensionen, LoadBalancer undAvailabilityZone.

Labelwerte müssen in einfache Anführungszeichen eingeschlossen werden.

Escape-Zeichen

In einer Abfrage müssen Bezeichnungswerte immer mit einfachen Anführungszeichen eingeschlossen sein.   Beispiel, SELECT MAX(CPUUtilization) FROM "AWS/EC2" WHERE AutoScalingGroupName = 'my-production-fleet'.

Metrische Namespaces, Metriknamen und Labelschlüssel, die andere Zeichen als Buchstaben, Zahlen und Unterstriche (_) enthalten, müssen von doppelten Anführungszeichen umgeben werden. Beispiel, SELECT MAX("My.Metric"). Wenn eines davon selbst ein doppeltes Anführungszeichen enthält (z. B.Bytes"Input"), müssen Sie dieses doppelte Anführungszeichen durch umgekehrte Schrägstriche maskieren, wie in. SELECT AVG("Bytes\"Input\"") Wenn ein Metrik-Namespace, ein Metrikname oder ein Bezeichnungsschlüssel ein Wort enthält, das ein reserviertes Schlüsselwort in Metrics Insights ist, muss dieses auch in doppelten Anführungszeichen eingeschlossen sein. Wenn Sie beispielsweise eine Metrik mit dem Namen LIMIT haben, würden Sie SELECT AVG("LIMIT") benutzen. Es ist auch möglich, einen Namespace, einen Metriknamen oder eine Bezeichnung in doppelte Anführungszeichen einzuschließen, auch wenn kein reserviertes Schlüsselwort enthalten ist.

Builder-Modus und Codemodus

Sie können eine Abfrage im Builder Modus oder Code Modus erstellen.

Um eine Abfrage im Builder Modus zu erstellen

1. Suchen und wählen Sie anhand der Informationen aus der obigen Tabelle einen Metrik-Namespace, einen Metriknamen, Filter-, Gruppen- und Sortieroptionen aus.

2. Wählen Sie für jede dieser Optionen aus der Liste der möglichen Optionen aus.

Um eine Abfrage im Code Modus zu erstellen

1. Schreiben Sie Ihre Abfrage im Code-Editor.

2. Um die Abfrage auszuführen, wählen Sie im Code-Editor die Option Abfrage ausführen.

Um eine Abfrage im builder Modus zu erstellen:

• Suchen und wählen Sie anhand der Informationen aus der obigen Tabelle einen Metrik-Namespace, einen Metriknamen, Filter-, Gruppen- und Sortieroptionen aus.

• Wählen Sie für jede dieser Optionen aus der Liste der möglichen Optionen aus.

Grafana erstellt automatisch eine SQL-Abfrage auf der Grundlage Ihrer Auswahl.

Um eine Abfrage im Modus zu erstellen: code

• Schreiben Sie Ihre Abfrage im Code-Editor.

• Um die Abfrage auszuführen, wählen Sie im Code-Editor die Option Abfrage ausführen.

Der Code-Editor verfügt über eine integrierte Autovervollständigungsfunktion, die Vorschläge für Schlüsselwörter, Aggregationen, Namespaces, Metriken, Labels und Labelwerte enthält. Die Vorschläge werden angezeigt, wenn Sie ein Leerzeichen, ein Komma oder ein Dollarzeichen eingeben. Sie können auch die Tastenkombination CTRL+Space verwenden.

Der Code-Editor kann die Abfrage automatisch vervollständigen. Die Verwendung von Vorlagenvariablen im Code-Editor kann jedoch die automatische Vervollständigung beeinträchtigen.

CloudWatch Beispiele für Metrics Insights

Anmerkung

CloudWatch Metrics Insights befindet sich in der offenen Vorschauversion. Die Vorschau steht allen AWS Konten offen und Sie müssen keinen Zugriff beantragen. Funktionen können hinzugefügt oder geändert werden, bevor die allgemeine Verfügbarkeit angekündigt wird.

Dieser Abschnitt enthält Beispiele für nützliche CloudWatch Metrics Insights-Abfragen, die Sie kopieren und direkt verwenden oder im Abfrage-Editor kopieren und ändern können. Einige dieser Beispiele sind bereits in der Konsole verfügbar und Sie können auf sie zugreifen, indem Sie in der Metrikanzeige Add query (Abfrage hinzufügen) auswählen.

EC2 Beispiele

Metriken zur CPU-Auslastung pro Instanz anzeigen

SELECT AVG(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
    

Sehen Sie sich die durchschnittliche CPU-Auslastung der gesamten Flotte an

SELECT AVG(CPUUtilization)
FROM SCHEMA("AWS/EC2", InstanceId)
    

Sehen Sie sich die 10 Instances mit der höchsten durchschnittlichen CPU-Auslastung an

SELECT MAX(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
LIMIT 10
    

Sehen Sie sich die 10 Instances mit der höchsten CPU-Auslastung, sortiert nach dem Maximum, in absteigender Reihenfolge an

SELECT AVG(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
ORDER BY MAX() DESC
LIMIT 10 

In diesem Fall erfasst der CloudWatch Agent eine CPUUtilization Metrik pro Anwendung. Diese Abfrage filtert den Durchschnitt dieser Metrik für einen bestimmten Anwendungsnamen.

SELECT AVG(CPUUtilization)
FROM "AWS/CWAgent"
WHERE ApplicationName = 'eCommerce'
SELECT AVG(ConcurrentExecutions)
FROM "AWS/Lambda"

Zeigen Sie die durchschnittliche Ausführungszeit für die 10 wichtigsten Lambda-Funktionen, sortiert nach dem Maximum, in absteigender Reihenfolge an

SELECT AVG(Duration)
FROM "AWS/Lambda"
GROUP BY FunctionName
ORDER BY MAX() DESC
LIMIT 10

Zeigen Sie die maximale, durchschnittliche und minimale Lambda-Ausführungszeit an

SELECT MAX(Duration)
FROM "AWS/Lambda"

Beispiele für Application Load Balancer

Sehen Sie sich Metriken an, die die folgenden Dimensionen LoadBalancerhaben AvailabilityZone

SELECT SUM(RequestCount)
FROM SCHEMA("AWS/ApplicationELB", LoadBalancer, AvailabilityZone)

Metriken mit der Anzahl der aktiven gleichzeitigen TCP-Verbindungen anzeigen

SELECT AVG(ActiveConnectionCount)
FROM "AWS/ApplicationELB"

Beispiele für Amazon EBS

Die 10 häufigsten durchschnittlichen Schreib-Bytes pro Volume in absteigender Reihenfolge anzeigen

SELECT AVG(VolumeWriteBytes)
FROM "AWS/EBS"
GROUP BY VolumeId
ORDER BY MAX() DESC
LIMIT 10

Durchschnittliche Schreibzeit für Amazon EBS-Volumes anzeigen

SELECT AVG(VolumeTotalWriteTime)
FROM "AWS/EBS"

Durchschnittliche Leerlaufzeit des Amazon EBS-Volumes anzeigen

SELECT AVG(VolumeIdleTime)
FROM "AWS/EBS"
View average burst balance per volume
SELECT AVG(BurstBalance)
FROM "AWS/EBS"
GROUP BY VolumeId
View average read bytes across Amazon EBS volumes
SELECT AVG(VolumeReadBytes)
FROM "AWS/EBS"

Durchschnittliche Schreib-Bytes auf Amazon EBS-Volumes anzeigen

SELECT AVG(VolumeWriteBytes)
FROM "AWS/EBS"

Beispiele für Amazon Simple Storage Service

Gruppe mit durchschnittlicher Latenz nach Bucket-Namen anzeigen

SELECT AVG(TotalRequestLatency)
FROM "AWS/S3"
GROUP BY BucketName

Zeigen Sie die durchschnittliche Anzahl von Objekten pro Bucket in allen Amazon S3 S3-Buckets an

SELECT AVG(NumberOfObjects)
FROM "AWS/S3"
GROUP BY BucketName
    

Beispiele für Amazon Simple Notification Service

A mazon-simple-notificaation-service — Beispiele

SELECT AVG(NumberOfMessagesPublished)
FROM "AWS/SNS"

Durchschnittliche Anzahl an fehlgeschlagenen Nachrichten für jeden Themennamen anzeigen

SELECT AVG(NumberOfNotificationsFailed)
FROM "AWS/SNS"
GROUP BY TopicName

AWS Beispiele für die API-Nutzung

Sehen Sie sich die 20 AWS APIs häufigsten Anrufe nach der Anzahl der Anrufe in Ihrem Konto an

SELECT COUNT(CallCount)
FROM "AWS/Usage"
WHERE "Type" = 'API'
GROUP BY "Service", "Resource"
ORDER BY SUM() DESC
LIMIT 20

CloudWatch Grenzwerte von Metrics Insights

CloudWatch Für Metrics Insights gelten derzeit die folgenden Grenzwerte:

• Sie können nur die Daten der letzten drei Stunden abfragen.

• Eine einzelne Abfrage kann nicht mehr als 10 000 Metriken verarbeiten. Das bedeutet, dass SELECTFROM, wenn die WHERE Klauseln, und mehr als 10.000 Metriken entsprechen würden, nur die ersten 10.000 dieser gefundenen Metriken von der Abfrage verarbeitet werden.

• Eine einzelne Abfrage kann nicht mehr als 500 Zeitreihen zurückgeben. Das bedeutet, dass, wenn die Abfrage mehr als 500 Metriken verarbeitet, nicht alle Metriken in den Abfrageergebnissen zurückgegeben werden. Wenn Sie eine ORDER BY Klausel verwenden, werden alle verarbeiteten Metriken sortiert und die 500, die gemäß Ihrer ORDER BY Klausel die höchsten oder niedrigsten Werte haben, werden zurückgegeben. Wenn Sie keine ORDER BY Klausel angeben, können Sie nicht kontrollieren, welche 500 passenden Metriken zurückgegeben werden.

• Jeder GetMetricData Vorgang kann nur eine Abfrage haben, aber Sie können mehrere Widgets in einem Dashboard haben, die jeweils eine Abfrage enthalten.