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 mit PromQL abfragen
Themen
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 das OpenTelemetry Line Protocol (OTLP) aufgenommen wurden, und angereicherten Verkaufsmetriken. AWS Wenn Sie OTLP-Metriken aufnehmen, bleibt die gesamte semantische Struktur Ihrer Telemetrie erhalten, einschließlich Ressourcenattributen, Instrumentierungsumfang, Datenpunktattributen und -spezifischen Metadaten, und CloudWatch stellt sie als abfragbare PromQL-Labels zur Verfügung. 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 Metriken über Dimensionen wie Service, Region oder Konto hinweg.
Berechnen Sie Raten, Histogramme, Quantile und gleitende Durchschnitte.
Sie können PromQL-Abfragen interaktiv in PromQL-Abfragen in Query Studio ausführen und auch zum Erstellen von Alarmen verwenden. CloudWatch Weitere Informationen erhalten Sie unter PromQL-Abfrage 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, die als Labels bezeichnet werden, identifiziert werden. Jede eindeutige Kombination aus Metriknamen und Labels bildet eine eigene Zeitreihe. |
Sofortiger Vektor |
Eine Reihe von Zeitreihen, die eine einzelne Stichprobe für jede Reihe enthalten und alle denselben Zeitstempel haben. Wird von Abfragen wie |
Bereichsvektor |
Eine Reihe von Zeitreihen, die eine Reihe von Datenpunkten im Zeitverlauf für jede Reihe enthalten. Wird erstellt, indem ein Zeitdauer-Selektor in Klammern angehängt wird, z. B. |
Label (Bezeichnung) |
Ein Schlüssel-Wert-Paar, das einer Zeitreihe zugeordnet ist. Bei OTLP-ingested Metriken werden Bezeichnungen aus Ressourcenattributen, Instrumentierungsumfang, Datenpunktattributen und -spezifischen Metadaten abgeleitet. AWS |
Label-Matcher |
Ein Ausdruck in geschweiften Klammern, der Zeitreihen nach Labelwert filtert. Unterstützt exact match ( |
Aggregationsoperator |
Eine Funktion, die mehrere Zeitreihen zu weniger Reihen kombiniert. Zu den gebräuchlichen Operatoren gehören |
Limits und Einschränkungen von PromQL
In der folgenden Tabelle sind die Grenzwerte und Einschränkungen für PromQL aufgeführt:
| Limit | Wert | Zusätzliche Informationen | Fehlercode |
|---|---|---|---|
Max. TPS für Abfrageanfragen pro Konto |
300 |
Die maximal zulässige Anzahl von Abfrageanforderungen (/query, /query_range) pro Sekunde pro Konto. |
422 |
Max. TPS für Discovery-Anfragen pro Konto |
10 |
Die maximal zulässige Anzahl von Discovery-Anfragen (/series, /label, /label_values) pro Sekunde pro Konto. |
422 |
Maximale Anzahl gleichzeitiger Abfrageanfragen pro Konto |
30 |
Maximale Anzahl von Abfragen (/query, /query_range), die ein Konto gleichzeitig aktiv ausführen kann. |
429 |
Maximale Anzahl gleichzeitiger Discovery-Anfragen pro Konto |
30 |
Maximale Anzahl von Discovery-Anfragen (/series, /labels, /label_values), die ein Konto gleichzeitig aktiv ausführen kann. |
429 |
Max. Anzahl der pro Abfrageanfrage zurückgegebenen Serien |
500 |
Maximale Anzahl eindeutiger Zeitreihen, die eine Abfrageanforderung (/query, /query_range) zurückgeben kann. |
200 — verkü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 — verkürzte Antwort |
Max. Reichweite pro Anfrage |
7 Tage |
Maximaler Zeitraum, den eine Abfrage umfassen kann, einschließlich Bereichsparametern und Lookback-Zeiträumen. |
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 Samples, 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 Samples, die pro 24-Stunden-Fenster der Abfrageausführung verarbeitet werden können. |
422 |
Ausführungstimeout |
20 Sekunden |
Maximale Zeit, die die Engine für die Auswertung einer Abfrage aufwenden kann, ausgenommen die Zeit, die in der Warteschlange und das Abrufen von Daten aus dem Speicher verbracht wird. |
422 |
Unterstützt AWS Regionen
In der folgenden Tabelle sind die AWS Regionen aufgeführt, in denen die Erfassung von OTLP-Metriken, PromQL-Abfragen 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 |
✓ |
✓ |
✓ |
USA West (Nordkalifornien) |
us-west-1 |
✓ |
✓ |
✓ |
USA Ost (Ohio) |
us-east-2 |
✓ |
✓ |
✓ |
Europa (London) |
eu-west-2 |
✓ |
✓ |
✓ |
Europa (Paris) |
eu-west-3 |
✓ |
✓ |
✓ |
Europa (Frankfurt) |
eu-central-1 |
✓ |
✓ |
✓ |
Europa (Stockholm) |
eu-north-1 |
✓ |
✓ |
✓ |
Europa (Milan) |
eu-south-1 |
✓ |
✓ |
✓ |
Europa (Spain) |
eu-south-2 |
✓ |
✓ |
✓ |
Europa (Zürich) |
eu-central-2 |
✓ |
✓ |
✓ |
Asien-Pazifik (Tokio) |
ap-northeast-1 |
✓ |
✓ |
✓ |
Asien-Pazifik (Seoul) |
ap-northeast-2 |
✓ |
✓ |
✓ |
Asia Pacific (Osaka) |
ap-northeast-3 |
✓ |
✓ |
✓ |
Asien-Pazifik (Mumbai) |
ap-south-1 |
✓ |
✓ |
✓ |
Asien-Pazifik (Hyderabad) |
ap-south-2 |
✓ |
✓ |
✓ |
Asien-Pazifik (Hongkong) |
ap-east-1 |
✓ |
✓ |
✓ |
Asien-Pazifik (Taipeh) |
ap-east-2 |
✓ |
✓ |
✓ |
Asien-Pazifik (Jakarta) |
ap-southeast-3 |
✓ |
✓ |
✓ |
Asien-Pazifik (Melbourne) |
ap-southeast-4 |
✓ |
✓ |
✓ |
Asien-Pazifik (Malaysia) |
ap-southeast-5 |
✓ |
✓ |
✓ |
Asien-Pazifik (Auckland) |
ap-southeast-6 |
✓ |
✓ |
✓ |
Asien-Pazifik (Thailand) |
ap-southeast-7 |
✓ |
✓ |
✓ |
Südamerika (São Paulo) |
sa-east-1 |
✓ |
✓ |
✓ |
Kanada (Zentral) |
ca-central-1 |
✓ |
✓ |
✓ |
Kanada West (Calgary) |
ca-west-1 |
✓ |
✓ |
✓ |
Afrika (Kapstadt) |
af-south-1 |
✓ |
✓ |
✓ |
Mexiko (Zentral) |
mx-central-1 |
✓ |
✓ |
✓ |
IAM-Berechtigungen für PromQL
Um PromQL-Abfragen auszuführen, benötigen Sie sowohl als auch Berechtigungen. cloudwatch:GetMetricData cloudwatch:ListMetrics In der folgenden Tabelle sind die Prometheus-compatible API-Endpunktpfade und ihre erforderlichen IAM-Aktionen aufgeführt:
| Pfad zum API-Endpunkt | HTTP-Methoden | Erforderliche Aktionen |
|---|---|---|
|
ABRUFEN, POSTEN |
|
|
HOLEN, POSTEN |
|
|
HOLEN, POSTEN |
|
|
HOLEN, POSTEN |
|
|
GET |
|
