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.

Requêtes ProMQL

Lorsque vous ingérez OpenTelemetry des métriques CloudWatch via leEndpoint des métriques, le modèle de données OTLP hiérarchique est aplati en étiquettes. PromQL-compatible Cette section décrit la structure des étiquettes, la syntaxe ProMQL pour interroger ces étiquettes et le UTF-8 support dans ProMQL.

Lorsque vous utilisez PromQL dans CloudWatch, la convention de @ préfixe distingue les étiquettes des OTLP-scoped étiquettes Prometheus standard. Les champs de chaque étendue utilisent un @ préfixe double (par exemple,@resource.@schema_url), tandis que les attributs utilisent un préfixe à @ portée unique, par exemple. @resource.service.name Les attributs de point de données prennent également en charge l'accès nu (sans préfixe) pour des raisons de compatibilité descendante avec les requêtes ProMQL standard, par exemple, et sont équivalents. {"http.server.active_requests"} {"@datapoint.@name"="http.server.active_requests"}

Une expression ProMQL est placée entre accolades, spécifiant le nom de la métrique et un ensemble facultatif de correspondants d'étiquettes. L'exemple suivant sélectionne toutes les séries chronologiques pour la http.server.active_requests métrique :

{"http.server.active_requests"}

L'exemple suivant sélectionne toutes les séries chronologiques pour la métrique http.server.active_requests où l'attribut de OpenTelemetry ressource service.name est égal myservice :

{"http.server.active_requests", "@resource.service.name"="myservice"}

Vous pouvez combiner plusieurs outils de correspondance d'étiquettes dans une seule requête. L'exemple suivant sélectionne toutes les séries chronologiques pour la http.server.active_requests métrique où l'attribut de OpenTelemetry ressource service.name est égal myservice dans toutes les régions des États-Unis :

{"http.server.active_requests",
 "@resource.service.name"="myservice",
 "@aws.region"=~"us-.*"}

L'exemple suivant montre une requête de plage. Il calcule la valeur moyenne de tous les points de données dans une plage de temps spécifiée pour chaque série chronologique :

avg_over_time(
  {"http.server.active_requests",
   "@resource.service.name"="myservice"}[5m]
)

Le tableau suivant récapitule les conventions de préfixe pour chaque étendue OTLP :

Interroger un vendeur AWS métriques avec ProMQL

Pour pouvoir interroger des AWS métriques distribuées dans ProMQL, vous devez d'abord activer l'enrichissement OTel des métriques distribuées. Voir : AWS mesures distribuées dans un format OpenTelemetry.

Une fois que vous avez activé l'enrichissement OTel, AWS les métriques distribuées peuvent être interrogées via ProMQL avec des libellés supplémentaires. Le nom de la métrique est identique au nom de la CloudWatch métrique d'origine, et les CloudWatch dimensions d'origine sont disponibles en tant qu'attributs de point de données. Les libellés suivants sont disponibles (l'exemple ci-dessous concerne une instance EC2) :

L'exemple suivant sélectionne Invocations une fonction Lambda spécifique :

{Invocations, FunctionName="my-api-handler"}

L'exemple suivant sélectionne Lambda Errors pour toutes les fonctions associées à une équipe spécifique :

{Errors, "@instrumentation.@name"="cloudwatch.aws/lambda", "@aws.tag.Team"="backend"}

L'exemple suivant calcule le nombre total de Lambda Invocations regroupés par équipe :

sum by ("@aws.tag.Team")(
    {Invocations, "@instrumentation.@name"="cloudwatch.aws/lambda"}
)

L'exemple suivant sélectionne toutes les séries chronologiques pour la CPUUtilization métrique EC2. L'utilisation de "@instrumentation.@name"="cloudwatch.aws/ec2" est destinée à correspondre exclusivement à CPUUtilization d'EC2 et non à celle d'autres AWS services tels qu'Amazon Relational Database Service :

histogram_avg({CPUUtilization, "@instrumentation.@name"="cloudwatch.aws/ec2"})

Requête depuis Grafana

Vous pouvez interroger les données CloudWatch ProMQL depuis Grafana en ajoutant le plug-in de source de données Amazon Managed Service for Prometheus et en le pointant vers le point de terminaison de surveillance. CloudWatch La signature Sigv4 est intégrée au plug-in et est toujours activée, il n'y a donc pas de bascule à activer. Le plugin est publié sur grafana. com/grafana/plugins/grafana-amazonprometheus-datasource/  ; installez-le depuis le catalogue de plugins Grafana avant d'ajouter la source de données. Le plugin AMP v3.0.0 nécessite Grafana. >=11.6.11 <12 || >=12.0.10 <12.1 || >=12.1.7 <12.2 || >=12.2.5

Prérequis IAM  : le principal IAM dont les informations d'identification utilisées par Grafana doit avoir à la fois cloudwatch:GetMetricData (requis pour les requêtes instantanées et par plage) et cloudwatch:ListMetrics (requis pour la découverte de séries et d'étiquettes). Pour en savoir plus, consultez Autorisations IAM pour ProMQL.

Pour configurer Grafana, procédez comme suit.

Requête depuis Amazon Managed Grafana

Vous pouvez interroger les données CloudWatch ProMQL depuis un espace de travail Amazon Managed Grafana en ajoutant une source de données Amazon Managed Service for Prometheus qui pointe vers le point de terminaison de surveillance. CloudWatch Ce plug-in de source de données signe automatiquement les demandes avec Sigv4 à l'aide du rôle IAM de l'espace de travail ; Sigv4 est toujours activé, sans aucune bascule à configurer. Le plug-in est disponible dans les versions 12 et ultérieures d'Amazon Managed Grafana. Pour plus d'informations, consultez la section Connexion à une source de données Amazon Managed Service pour Prometheus dans le guide de l'utilisateur d'Amazon Managed Grafana.

Conditions requises pour l'IAM  : le rôle IAM de l'espace de travail Amazon Managed Grafana doit avoir à la fois cloudwatch:GetMetricData (obligatoire pour les requêtes instantanées et par plage) et cloudwatch:ListMetrics (obligatoire pour la découverte de séries et d'étiquettes). Pour en savoir plus, consultez Autorisations IAM pour ProMQL.

Pour configurer la source de données, procédez comme suit.

Effectuer des requêtes avec les outils MCP

Le serveur CloudWatch MCP fournit des outils MCP (Model Context Protocol) qui permettent aux assistants d'IA et aux outils de développement d'interroger les données CloudWatch ProMQL en votre nom. Les outils MCP gèrent automatiquement l'authentification et le formatage des demandes. Vous pouvez donc vous concentrer sur l'écriture de requêtes ProMQL plutôt que sur la gestion des requêtes HTTP et de la signature Sigv4.

Les outils ProMQL suivants sont disponibles sur le serveur CloudWatch MCP :

Pour plus de détails sur les paramètres, la configuration et les instructions de configuration, consultez la section Outils pour CloudWatch ProMQL dans la documentation du serveur CloudWatch MCP.

Effectuer des requêtes à l'aide de l'API HTTP

Vous pouvez également interroger les données CloudWatch ProMQL par programmation en appelant directement les points de terminaison HTTP. Prometheus-compatible Les demandes doivent être signées avec AWS Signature Version 4 en monitoring tant que nom de service.

Le point de terminaison ProMQL suit le modèle. https://monitoring.AWS Region.amazonaws.com/api/v1/operation Par exemple, pour la région USA Est (Virginie du Nord) (us-east-1), le point de terminaison d'une requête instantanée est. https://monitoring.us-east-1.amazonaws.com/api/v1/query

Pour la référence complète de l'API, y compris les opérations prises en charge, les paramètres de demande et les formats de réponse, consultezPrometheus-compatible API. Pour obtenir la liste des AWS régions dans lesquelles les requêtes ProMQL sont disponibles, consultez. Pris en charge AWS Régions Pour les actions IAM requises pour chaque opération, consultezAutorisations IAM pour ProMQL.