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 des Metrik-Abfrage-Editors Mit dem Metrik-Abfrage-Editor können Sie zwei Arten von Abfragen erstellen: **Metriksuche** und **Metrikabfrage**. Mit der Option **Metric Query** werden Daten mithilfe von CloudWatch Metrics Insights abgefragt. ## Allgemeine Felder im Abfrage-Editor Es gibt drei Felder, die sowohl für die **Metriksuche** als auch für die **Metrikabfrage** gelten. **Allgemeine Felder** **Id** Die `GetMetricData` API erfordert, dass alle Abfragen eine eindeutige ID haben. Verwenden Sie dieses Feld, um eine ID Ihrer Wahl anzugeben. Die ID kann Zahlen, Buchstaben und Unterstriche enthalten und muss mit einem Kleinbuchstaben beginnen. Wenn keine ID angegeben ist, generiert Amazon Managed Grafana eine ID nach dem folgenden Muster:`query[refId of the current query row]`. `queryA`Stellt beispielsweise die erste Abfragezeile im Panel-Editor dar. **Zeitraum** Ein Zeitraum ist der Zeitraum, der mit einer bestimmten CloudWatch Statistik verknüpft ist. Perioden werden in Sekundenzahlen definiert. Zu den gültigen Werten gehören 1, 5, 10, 30 oder ein Vielfaches von 60. Wenn Sie das Periodenfeld leer lassen oder auf gesetzt haben`auto`, wird es automatisch auf der Grundlage des Zeitbereichs und der CloudWatch Aufbewahrungsrichtlinie berechnet. Die verwendete Formel lautet`time range in seconds / 2000`, und dann wird zum nächsthöheren Wert in einer Reihe von vordefinierten Zeiträumen [60, 300, 900, 3600, 21600, 86400] übergegangen, nachdem die auf der Aufbewahrung basierenden Zeiträume entfernt wurden. Um zu sehen, welchen Zeitraum Amazon Managed Grafana verwendet, wählen Sie im Abfrage-Editor die Option **Abfragevorschau anzeigen**. **Alias** Es gelten die folgenden Aliasmuster. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/grafana/latest/userguide/CloudWatch-using-the-metric-query-editor.html) # Verwenden der Metrik-Suchoption Um eine gültige Abfrage in der **Metriksuche** zu erstellen, müssen Sie den Namespace, den Metriknamen und mindestens eine Statistik angeben. Wenn **Match Exact** aktiviert ist, müssen Sie auch alle Dimensionen der Metrik angeben, die Sie abfragen. Das Metrikschema muss exakt übereinstimmen. Weitere Informationen finden Sie unter [Syntax von CloudWatch Suchausdrücken](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/search-expression-syntax.html). Wenn **Match Exact** deaktiviert ist, können Sie eine beliebige Anzahl von Dimensionen angeben, nach denen Sie filtern möchten. Es werden bis zu 100 Metriken zurückgegeben, die Ihren Filterkriterien entsprechen. ## Dynamische Abfragen mit Platzhalterzeichen für Dimensionen Sie können eine dynamische Liste von Metriken überwachen, indem Sie das Platzhalterzeichen Sternchen (`*`) für einen oder mehrere Dimensionswerte verwenden. Auf diese Weise können Sie Metriken für AWS Ressourcen wie EC2-Instances oder Container überwachen. Wenn beispielsweise neue Instances im Rahmen eines Auto Scaling-Events erstellt werden, erscheinen sie automatisch im Diagramm, ohne dass Sie die neue Instance verfolgen müssen IDs. Diese Funktion ist derzeit auf das Abrufen von bis zu 100 Metriken beschränkt. Sie können „**Abfragevorschau anzeigen**“ wählen, um den Suchausdruck zu sehen, der automatisch für die Unterstützung von Platzhalterzeichen erstellt wurde. Standardmäßig ist der Suchausdruck so definiert, dass die abgefragten Metriken exakt mit den definierten Dimensionsnamen übereinstimmen müssen. Das bedeutet, dass im Beispiel nur Metriken mit genau einer Dimension mit Namen zurückgegeben `InstanceId` werden. Um Metriken einzubeziehen, für die andere Dimensionen definiert sind, können Sie **Match Exact** deaktivieren. Wenn Sie **Match Exact** deaktivieren, wird auch dann ein Suchausdruck erstellt, wenn Sie keine Platzhalterzeichen verwenden. Grafana sucht nach jeder Metrik, die mindestens dem Namespace, dem Metriknamen und allen definierten Dimensionen entspricht. ## Vorlagenvariablen mit mehreren Werten Bei der Definition von Dimensionswerten auf der Grundlage von mehrwertigen Vorlagenvariablen wird ein Suchausdruck verwendet, um nach den passenden Metriken abzufragen. Dies ermöglicht die Verwendung mehrerer Vorlagenvariablen in einer Abfrage. Sie können Vorlagenvariablen auch für Abfragen verwenden, bei denen die Option „**Genau zuordnen**“ deaktiviert ist. Suchausdrücke sind derzeit auf 1024 Zeichen beschränkt, sodass Ihre Abfrage möglicherweise fehlschlägt, wenn Sie eine lange Werteliste haben. Wenn Sie alle Metriken abfragen möchten, die einen beliebigen Wert für einen bestimmten Dimensionsnamen haben, empfehlen wir, anstelle der Option das Platzhalterzeichen Sternchen (`*`) zu verwenden. `All` Die Verwendung von mehrwertigen Vorlagenvariablen wird nur für Dimensionswerte unterstützt. Die Verwendung von mehrwertigen Vorlagenvariablen für `Region``Namespace`, oder `Metric Name` wird nicht unterstützt. ## Metrische mathematische Ausdrücke Sie können neue Zeitreihenmetriken erstellen, indem Sie mithilfe mathematischer Funktionen auf CloudWatch Metriken aufbauen. Arithmetische Operatoren, unäre Subtraktion und andere Funktionen werden unterstützt und können auf Metriken angewendet werden. CloudWatch [Weitere Informationen zu CloudWatch metrischen mathematischen Funktionen finden Sie unter Metrische Mathematik verwenden.](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) Um beispielsweise arithmetische Operationen auf eine Metrik anzuwenden, geben Sie der Rohmetrik eine ID (eine eindeutige Zeichenfolge). Sie können diese ID dann verwenden und im `Expression` Feld der neuen Metrik arithmetische Operationen darauf anwenden. Wenn Sie das `Expression` Feld verwenden, um auf eine andere Abfrage zu verweisen, können Sie beispielsweise keine Warnungsregel erstellen`queryA * 2`, die auf dieser Abfrage basiert. ## Zeitraum Ein Zeitraum ist die Zeitdauer, die mit einer bestimmten CloudWatch Amazon-Statistik verknüpft ist. Perioden werden in Sekundenzahlen definiert. Zu den gültigen Werten gehören 1, 5, 10, 30 oder ein Vielfaches von 60. Wenn Sie das Periodenfeld leer lassen oder auf „**auto**“ setzen, wird es automatisch auf der Grundlage des Zeitbereichs berechnet. Die verwendete Formel lautet`time range in seconds / 2000`, und dann geht es zum nächsthöheren Wert in einer Reihe vordefinierter Perioden über`[60, 300, 900, 3600, 21600, 86400]`. Um zu sehen, welchen Zeitraum Amazon Managed Grafana verwendet, wählen Sie im Abfrage-Editor die Option **Abfragevorschau anzeigen**. ## Deep-Linking von Grafana-Panels zur Konsole CloudWatch Wenn Sie im Panel eine Zeitreihe auswählen, wird ein Kontextmenü mit einem Link zur **Ansicht in der CloudWatch Konsole angezeigt**. Wenn Sie diesen Link auswählen, wird eine neue Registerkarte geöffnet, auf der Sie zur CloudWatch Konsole gelangen und auf der alle Metriken für diese Abfrage angezeigt werden. Wenn Sie derzeit nicht bei der CloudWatch Konsole angemeldet sind, leitet Sie der Link zur Anmeldeseite weiter. Der angegebene Link ist für alle gültig, zeigt AWS-Konto jedoch nur die richtigen Metriken an, wenn Sie bei der angemeldet sind AWS-Konto , die der ausgewählten Datenquelle in Grafana entspricht. Diese Funktion ist nicht für Metriken verfügbar, die auf metrischen mathematischen Ausdrücken basieren. # 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.