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ête ProMAL

Lorsque vous ingérez OpenTelemetry des métriques CloudWatch via lePoint final 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 la prise en UTF-8 charge 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 portée (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 (non préfixé) pour une 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 dont l'attribut de OpenTelemetry ressource service.name est égal à myservice :

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

Vous pouvez combiner plusieurs correcteurs 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 dont 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éfixes pour chaque étendue OTLP :

Interrogation de vended AWS métriques avec ProMQL

Pour pouvoir interroger les AWS métriques vendues dans ProMQL, vous devez d'abord activer l'enrichissement OTel des métriques vendues. Voir : AWS métriques vendues au format OpenTelemetry.

Une fois que vous avez activé l'enrichissement par OTel, AWS les métriques vendues peuvent être consultées via ProMQL avec des étiquettes 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 sous forme d'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 Invocations Lambda groupé 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"})

Interrogation depuis Grafana

Vous pouvez interroger les données CloudWatch ProMQL depuis Grafana en ajoutant le plugin 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 plugin et est toujours activée, il n'y a donc pas de bouton à activer. Le plugin est publié sur grafana. com/grafana/plugins/grafana-amazonprometheus-datasource/ ; installez-le depuis le catalogue des 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

Conditions requises pour l'IAM : le principal IAM dont Grafana utilise les informations d'identification doivent 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.

Effectuer des requêtes 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 pointant vers le point de terminaison de surveillance. CloudWatch Ce plugin de source de données signe automatiquement les demandes avec SigV4 en utilisant le rôle IAM de l'espace de travail ; SigV4 est toujours activé, sans qu'il soit nécessaire de le configurer. Le plugin est disponible dans les versions 12 et ultérieures d'Amazon Managed Grafana. Pour plus d'informations, consultez la section Connect to an Amazon Managed Service for Prometheus source de données 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.

Interrogation avec les outils MCP

Le serveur CloudWatch MCP fournit des outils MCP (Model Context Protocol) qui permettent aux assistants d'intelligence artificielle 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.

Interrogation avec 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 utilisant monitoring comme 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 la liste des AWS régions dans lesquelles les requêtes ProMQL sont disponibles, consultez. Pris en charge AWS Régions Pour connaître les actions IAM requises pour chaque opération, consultezAutorisations IAM pour ProMQL.