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.
Metriken abfragen mit PromQL
Themen
Anmerkung
Die Erfassung von OTLP-Metriken, die PromQL-Abfrage, die OTel Anreicherung verkaufter AWS Metriken und Query Studio befinden sich in der öffentlichen Vorschauversion, sind kostenlos und können sich ändern.
Was ist Prometheus Query Language (PromQL)?
Prometheus Query Language (PromQL) ist eine funktionale Abfragesprache, mit der Sie Zeitreihendaten in Echtzeit auswählen, aggregieren und transformieren können. PromQL wurde ursprünglich für Prometheus entwickelt und hat sich zu einer beliebten Abfragesprache für Metriken entwickelt.
Amazon CloudWatch unterstützt PromQL für die Abfrage von Metriken, einschließlich Metriken, die über OpenTelemetry Line Protocol (OTLP) aufgenommen wurden, und angereicherten Verkaufsmetriken.AWS Wenn Sie OTLP-Metriken aufnehmen, bleibt die vollständige semantische Struktur Ihrer Telemetrie CloudWatch erhalten, einschließlich Ressourcenattributen, Instrumentierungsumfang, Datenpunktattributen und -spezifischer Metadaten, und macht sie als abfragbare PromQL-Labels verfügbar. AWS
Mit PromQL können Sie Folgendes tun:
Wählen Sie Zeitreihen nach Metriknamen und Label-Matchern aus.
Wenden Sie mathematische Funktionen und Operatoren auf Zeitreihen an.
Aggregieren Sie Kennzahlen für verschiedene Dimensionen wie Service, Region oder Konto.
Berechnen Sie Raten, Histogramme, Quantile und gleitende Durchschnitte.
Sie können PromQL-Abfragen interaktiv in Ausführen von PromQL-Abfragen in Query Studio (Vorschau) Alarmen verwenden und diese auch erstellen. CloudWatch Weitere Informationen erhalten Sie unter PromQL abfragen und Verwendung von PromQL in Alarmen.
Anmerkung
CloudWatch verwendet PromQL basierend auf der Prometheus 3.0-Spezifikation. Dies beinhaltet die Unterstützung von UTF-8-Metriknamen und Labelnamen.
Die folgenden Konzepte sind grundlegend für die Arbeit mit PromQL in. CloudWatch
| Konzept | Description |
|---|---|
Zeitreihen |
Ein Stream von Werten mit Zeitstempel, die durch einen Metriknamen und eine Reihe von Schlüssel-Wert-Paaren, sogenannten Labels, identifiziert werden. Jede eindeutige Kombination aus Metriknamen und Labels bildet eine eigene Zeitreihe. |
Sofortiger Vektor |
Eine Reihe von Zeitreihen, die für jede Serie ein einzelnes Beispiel enthalten und alle denselben Zeitstempel haben. Wird von Abfragen wie |
Bereichsvektor |
Ein Satz von Zeitreihen, der für jede Reihe einen Bereich von Datenpunkten im Zeitverlauf enthält. Wird erstellt, indem ein Zeitdauer-Selektor in Klammern angehängt wird, z. B. |
Label (Bezeichnung) |
Ein Schlüssel-Wert-Paar, das an eine Zeitreihe angehängt ist. In OTLP-erfassten Metriken werden Labels aus Ressourcenattributen, Instrumentierungsbereich, Datenpunktattributen und -spezifischen Metadaten abgeleitet. AWS |
Label-Matcher |
Ein Ausdruck in geschweiften Klammern, der Zeitreihen nach dem Labelwert filtert. Unterstützt Exact Match ( |
Aggregationsoperator |
Eine Funktion, die mehrere Zeitreihen zu weniger Reihen kombiniert. Zu den gebräuchlichen Operatoren gehören |
Grenzen und Einschränkungen von PromQL
In der folgenden Tabelle sind die Limits und Einschränkungen für PromQL aufgeführt:
| Limit | Wert | Zusätzliche Informationen | Fehlercode |
|---|---|---|---|
Max. TPS für Abfrageanfragen pro Konto |
300 |
Maximal zulässige Anzahl von Abfrageanfragen (/query, /query_range) pro Sekunde pro Konto. |
422 |
Max. TPS für Discovery-Anfragen pro Konto |
10 |
Maximal zulässige Anzahl von Discovery-Anfragen (/series, /label, /label_values) pro Sekunde pro Konto. |
422 |
Max. Anzahl gleichzeitiger Abfrageanfragen pro Konto |
30 |
Maximale Anzahl von Abfragen (/query, /query_range), die ein Konto gleichzeitig aktiv ausführen kann. |
429 |
Max. Anzahl gleichzeitiger Discovery-Anfragen pro Konto |
30 |
Maximale Anzahl von Ermittlungsanfragen (/series, /labels, /label_values), die ein Konto gleichzeitig aktiv ausführen kann. |
429 |
Max. Anzahl zurückgegebener Serien pro Abfrageanforderung |
500 |
Maximale Anzahl eindeutiger Zeitreihen, die eine Abfrageanforderung (/query, /query_range) zurückgeben kann. |
200 — gekürzte Antwort |
Max. Anzahl der pro Discovery-Anfrage zurückgegebenen Labels |
10.000 |
Maximale Anzahl eindeutiger Labels, die eine Discovery-Anfrage (/series, /labels, /label_values) zurückgeben kann. |
200 — gekürzte Antwort |
Max. Reichweite pro Anfrage |
7 Tage |
Maximaler Zeitraum, den eine Abfrage umfassen kann, einschließlich Bereichsparameter und Lookback-Zeiträume. |
422 |
Max. Anzahl gescannter Serien pro 24-Stunden-Fenster |
100 000 |
Maximale Anzahl eindeutiger Zeitreihen, die pro 24-Stunden-Fenster der Abfrageausführung gescannt werden können. |
422 |
Max. Anzahl gescannter Proben pro 24-Stunden-Fenster |
300.000.000 |
Maximale Anzahl von Proben, die pro 24-Stunden-Fenster der Abfrageausführung gescannt werden können. |
422 |
Max. Anzahl verarbeiteter Proben pro 24-Stunden-Fenster |
3.000.000.000 |
Maximale Anzahl von Stichproben, die pro 24-Stunden-Fenster für die Abfrageausführung verarbeitet werden können. |
422 |
Ausführungstimeout |
20 Sekunden |
Maximale Zeit, die die Engine mit der Auswertung einer Abfrage verbringen kann, ohne die Zeit, die in der Warteschlange und beim Abrufen von Daten aus dem Speicher verbracht wird. |
422 |
Unterstützte Regionen AWS
In der folgenden Tabelle sind die AWS Regionen aufgeführt, in denen die Erfassung von OTLP-Metriken, die PromQL-Abfrage und Query Studio verfügbar sind.
| Name der Region | Regionscode | OTLP-Metriken werden aufgenommen | ProMQL-Abfrage | Query Studio |
|---|---|---|---|---|
USA Ost (Nord-Virginia) |
us-east-1 |
✓ |
✓ |
✓ |
USA West (Oregon) |
us-west-2 |
✓ |
✓ |
✓ |
Europa (Irland) |
eu-west-1 |
✓ |
✓ |
✓ |
Asien-Pazifik (Singapur) |
ap-southeast-1 |
✓ |
✓ |
✓ |
Asien-Pazifik (Sydney) |
ap-southeast-2 |
✓ |
✓ |
✓ |
IAM-Berechtigungen für PromQL
Um PromQL-Abfragen ausführen zu können, benötigen Sie sowohl als auch Berechtigungen. cloudwatch:GetMetricData cloudwatch:ListMetrics Die folgende Tabelle listet die neuen PromQL-API-Operationen und ihre erforderlichen IAM-Aktionen auf:
| API-Operation | Erforderliche Aktionen |
|---|---|
ExecuteMetricQueryPost |
|
ExecuteMetricQueryGet |
|
ExecuteMetricRangeQuery |
|
ExecuteMetricRangeQueryGet |
|
ExecuteMetricSeriesPost |
|
ExecuteMetricSeriesGet |
|
ExecuteMetricLabelsPost |
|
ExecuteMetricLabelsGet |
|
ExecuteMetricLabelValuesGet |
|
