Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Métriques de requêtes avec ProMQL
Rubriques
Note
L'ingestion des métriques OTLP, les requêtes ProMQL, l' OTel enrichissement des AWS métriques vendues et Query Studio sont en version préliminaire publique, sont gratuits et sujets à modification.
Qu'est-ce que Prometheus Query Language (ProMQL) ?
Prometheus Query Language (ProMQL) est un langage de requête fonctionnel qui vous permet de sélectionner, d'agréger et de transformer des données de séries chronologiques en temps réel. ProMQL a été initialement conçu pour Prometheus et est devenu un langage de requête populaire pour les métriques.
Amazon CloudWatch prend en charge ProMQL pour interroger les métriques, y compris les métriques ingérées via le protocole OTLP ( OpenTelemetryLine Protocol) et les métriques vendues enrichies.AWS Lorsque vous ingérez des métriques OTLP, CloudWatch préserve la structure sémantique complète de votre télémétrie, y compris les attributs des ressources, la portée de l'instrumentation, les attributs des points de données et les métadonnées AWS spécifiques, et les expose sous forme d'étiquettes ProMQL interrogeables.
Avec ProMQL, vous pouvez effectuer les opérations suivantes :
Sélectionnez les séries chronologiques par nom de métrique et par étiquette correspondante.
Appliquez des fonctions et des opérateurs mathématiques à des séries chronologiques.
Agrégez les mesures selon des dimensions telles que le service, la région ou le compte.
Calculez les taux, les histogrammes, les quantiles et les moyennes mobiles.
Vous pouvez utiliser les requêtes ProMQL de manière interactive dans Exécution de requêtes ProMQL dans Query Studio (version préliminaire) et également pour créer des alarmes. CloudWatch Pour plus d’informations, consultez Requête ProMAL et Utilisation de ProMQL dans les alarmes.
Note
CloudWatch utilise ProMQL sur la base de la spécification Prometheus 3.0. Cela inclut la prise en charge des noms de métriques et des noms d'étiquettes UTF-8.
Les concepts suivants sont fondamentaux pour travailler avec ProMQL dans. CloudWatch
| Concept | Description |
|---|---|
Séries chronologiques |
Un flux de valeurs horodatées identifiées par un nom de métrique et un ensemble de paires clé-valeur appelées labels. Chaque combinaison unique de nom de métrique et d'étiquettes forme une série chronologique distincte. |
Vecteur instantané |
Un ensemble de séries chronologiques contenant un seul échantillon pour chaque série, toutes partageant le même horodatage. Renvoyé par des requêtes telles que |
Vecteur de portée |
Ensemble de séries chronologiques contenant une gamme de points de données au fil du temps pour chaque série. Créé en ajoutant un sélecteur de durée entre crochets, par exemple,. |
Étiquette |
Une paire clé-valeur attachée à une série chronologique. Dans les métriques ingérées par OTLP, les étiquettes sont dérivées des attributs des ressources, de la portée de l'instrumentation, des attributs des points de données et des métadonnées spécifiques. AWS |
Matcher d'étiquettes |
Expression entre accolades qui filtre les séries chronologiques par valeur d'étiquette. Supporte la correspondance exacte ( |
Opérateur d'agrégation |
Fonction qui combine plusieurs séries chronologiques en un nombre réduit de séries. Les opérateurs courants incluent |
Limites et restrictions de ProMQL
Le tableau suivant répertorie les limites et restrictions de ProMQL :
| Limite | Value | Informations supplémentaires | Code d’erreur |
|---|---|---|---|
TPS maximum pour les demandes de requête par compte |
300 |
Nombre maximum de requêtes (/query, /query_range) autorisées par seconde par compte. |
422 |
TPS maximal pour les demandes de découverte par compte |
10 |
Nombre maximum de demandes de découverte (/series, /label, /label_values) autorisées par seconde par compte. |
422 |
Nombre maximal de demandes de requêtes simultanées par compte |
30 |
Nombre maximum de requêtes (/query, /query_range) qu'un compte peut exécuter activement en même temps. |
429 |
Nombre maximal de demandes de découverte simultanées par compte |
30 |
Nombre maximum de demandes de découverte (/series, /labels, /label_values) qu'un compte peut avoir en cours d'exécution active en même temps. |
429 |
Nombre maximum de séries renvoyées par demande de requête |
500 |
Nombre maximal de séries chronologiques uniques qu'une demande de requête (/query, /query_range) peut renvoyer. |
200 - réponse tronquée |
Nombre maximum d'étiquettes renvoyées par demande de découverte |
10 000 |
Nombre maximum d'étiquettes uniques qu'une demande de découverte (/series, /labels, /label_values) peut renvoyer. |
200 - réponse tronquée |
Portée maximale par demande |
7 jours |
Plage de temps maximale qu'une requête peut couvrir, y compris les paramètres de plage et les périodes de rétrospective. |
422 |
Nombre maximum de séries numérisées par fenêtre de 24 heures |
100 000 |
Nombre maximal de séries chronologiques uniques pouvant être scannées par fenêtre de 24 heures d'exécution des requêtes. |
422 |
Nombre maximum d'échantillons scannés par fenêtre de 24 heures |
300 000 000 |
Nombre maximum d'échantillons pouvant être scannés par fenêtre de 24 heures d'exécution des requêtes. |
422 |
Nombre maximum d'échantillons traités par fenêtre de 24 heures |
3 000 000 000 |
Nombre maximum d'échantillons pouvant être traités par fenêtre d'exécution de requête de 24 heures. |
422 |
Execution timeout (Délai d'exécution) |
20 secondes |
Durée maximale que le moteur peut consacrer à l'évaluation d'une requête, à l'exception du temps passé dans la file d'attente et à récupérer des données depuis le stockage. |
422 |
AWS Régions prises en charge
Le tableau suivant répertorie les AWS régions dans lesquelles l'ingestion de métriques OTLP, les requêtes ProMQL et Query Studio sont disponibles.
| Nom de la région | Code région | Ingestion des métriques OTLP | Requête ProMQL | Studio de requêtes |
|---|---|---|---|---|
USA Est (Virginie du Nord) |
us-east-1 |
✓ |
✓ |
✓ |
USA Ouest (Oregon) |
us-west-2 |
✓ |
✓ |
✓ |
Europe (Irlande) |
eu-west-1 |
✓ |
✓ |
✓ |
Asie-Pacifique (Singapour) |
ap-southeast-1 |
✓ |
✓ |
✓ |
Asie-Pacifique (Sydney) |
ap-southeast-2 |
✓ |
✓ |
✓ |
Autorisations IAM pour ProMQL
Pour exécuter des requêtes ProMQL, vous avez besoin à la fois d'autorisations cloudwatch:GetMetricData et cloudwatch:ListMetrics d'autorisations. Le tableau suivant répertorie les nouvelles opérations de l'API ProMQL et leurs actions IAM requises :
| Opération API | Actions requises |
|---|---|
ExecuteMetricQueryPost |
|
ExecuteMetricQueryGet |
|
ExecuteMetricRangeQuery |
|
ExecuteMetricRangeQueryGet |
|
ExecuteMetricSeriesPost |
|
ExecuteMetricSeriesGet |
|
ExecuteMetricLabelsPost |
|
ExecuteMetricLabelsGet |
|
ExecuteMetricLabelValuesGet |
|
