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.
# 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 unter[Abfragesyntax und Schlüsselwörter](#metrics-insights-syntax-keywords).
## 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 | Description |
| --- | --- |
| 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 \$1= '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` und`AvailabilityZone`.
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.
1. 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.
1. 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
```
Die maximalen, durchschnittlichen und minimalen Lambda-Ausführungszeiten anzeigen
```
SELECT MAX(Duration)
FROM "AWS/Lambda"
```
### Beispiele für Application Load Balancer
Zeigen Sie Metriken mit den folgenden Dimensionen **LoadBalancer**an **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
mazon-simple-notificaation-serviceA-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 `SELECT``FROM`, 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.