Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

QueryMetrics

L'QueryMetricsoperazione valuta una query istantanea PromQL in un singolo momento o valuta una query in un intervallo di tempo.

L'URL completo della richiesta combina l'host di CloudWatch monitoraggio per la AWS regione con il percorso operativo, ad esempiohttps://monitoring.AWS Region.amazonaws.com/api/v1/query. Per informazioni sugli endpoint, sulla firma e sulle autorizzazioni IAM richieste, consulta. Interrogazione ProMQL

Parametri di interrogazione URL

I seguenti parametri vengono passati nella stringa di query URL per GET le richieste o come campi del corpo codificati dal modulo per le richieste. POST

Durata

durationIn un' Prometheus-compatible API è un numero, seguito immediatamente da una delle seguenti unità:

Autorizzazioni IAM richieste

Per effettuare una chiamataQueryMetrics, l'identità chiamante deve avere entrambe le seguenti azioni IAM:

Per la mappatura completa delle azioni IAM per tutte le operazioni PromQL, consulta. Autorizzazioni IAM per PromQL

Limite di risultati

Una /api/v1/query_range risposta singola /api/v1/query o può restituire fino a 500 serie temporali uniche. Per richiedere un numero inferiore di risultati, passa il limit parametro con un valore compreso tra 1 a500. Se non lo specifichilimit, CloudWatch restituisce il valore massimo.

Quando le serie corrispondenti superano il limite, la risposta viene troncata e viene incluso un messaggio nel campo standard Prometheus. warnings Il codice di stato HTTP rimane. 200

Per l'elenco completo dei limiti di PromQL, inclusi TPS, concorrenza e finestre di scansione 24 ore su 24, consulta. Limiti e restrizioni di PromQL

Richiesta di esempio

La POST richiesta seguente passa l'espressione PromQL in un corpo codificato in un modulo. I caratteri speciali come{, e sono codificati in } percentuale. "

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)

La stessa chiamata con: 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"})'

Risposta di esempio

Una risposta corretta utilizza la busta Prometheus JSON 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"
                ]
            }
        ]
    }
}

Quando il set di risultati supera il limite per chiamata, CloudWatch restituisce un array result troncato e include un messaggio nel campo: warnings

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"
    ]
}