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.

QueryMetrics

L'QueryMetricsopération évalue une requête instantanée ProMQL à un moment donné ou évalue une requête sur une période donnée.

L'URL de demande complète combine l'hôte CloudWatch de surveillance de la AWS région avec le chemin de l'opération, par exemplehttps://monitoring.AWS Region.amazonaws.com/api/v1/query. Pour plus d'informations sur les points de terminaison, la signature et les autorisations IAM requises, consultez. Requête ProMAL

Paramètres de requête d'URL

Les paramètres suivants sont transmis dans la chaîne de requête URL pour les GET demandes, ou sous forme de champs de corps codés par formulaire pour POST les demandes.

Durée

durationDans une Prometheus-compatible API, un nombre est immédiatement suivi de l'une des unités suivantes :

Autorisations IAM requises

Pour appelerQueryMetrics, l'identité appelante doit comporter les deux actions IAM suivantes :

Pour le mappage complet des actions IAM pour toutes les opérations ProMQL, voir. Autorisations IAM pour ProMQL

Limite de résultats

Une seule /api/v1/query /api/v1/query_range réponse peut renvoyer jusqu'à 500 séries chronologiques uniques. Pour demander moins de résultats, transmettez le limit paramètre avec une valeur comprise entre 1 et500. Si vous ne le spécifiez paslimit, CloudWatch renvoie le montant maximum.

Lorsque la série correspondante dépasse le plafond, la réponse est tronquée et un message est inclus dans le champ Prometheus warnings standard. Le code d'état HTTP est conservé200.

Pour la liste complète des limites ProMQL, y compris le TPS, la simultanéité et les fenêtres de numérisation de 24 heures, voir. Limites et restrictions de ProMQL

Exemple de demande

La POST requête suivante transmet l'expression ProMQL dans un corps codé par formulaire. Les caractères spéciaux tels que {}, et " sont codés en pourcentage.

POST /api/v1/query HTTP/1.1
Host: monitoring.us-east-1.amazonaws.com
Content-Type: application/x-www-form-urlencoded
Authorization: AUTHPARAMS
X-Amz-Date: 20260605T193725Z
User-Agent: awscurl/0.36

query=sum(%7B%22http.server.active_requests%22%7D)

Le même appel avec awscurl :

awscurl --service monitoring --region us-east-1 \
    -X POST 'https://monitoring.us-east-1.amazonaws.com/api/v1/query' \
    -H 'Content-Type: application/x-www-form-urlencoded' \
    -d 'query=sum({"http.server.active_requests"})'

Exemple de réponse

Une réponse réussie utilise l'enveloppe JSON Prometheus standard :

HTTP/1.1 200 OK
x-amzn-RequestId: 12345678-abcd-4442-b8c5-262b45e9b535
Content-Type: application/json

{
    "status": "success",
    "data": {
        "resultType": "vector",
        "result": [
            {
                "metric": {},
                "value": [
                    1780000000.000,
                    "42"
                ]
            }
        ]
    }
}

Lorsque le jeu de résultats dépasse le plafond par appel, CloudWatch renvoie un result tableau tronqué et inclut un message dans le warnings champ :

HTTP/1.1 200 OK
Content-Type: application/json

{
    "status": "success",
    "data": {
        "resultType": "vector",
        "result": [ ... up to 500 series ... ]
    },
    "warnings": [
        "result truncated to the maximum of 500 series; refine the query or use the limit parameter"
    ]
}