View a markdown version of this page

GetSeries - Amazon CloudWatch
Parametri di interrogazione URLAutorizzazioni IAM richiesteLimite di risultatiEsempi di richiesteRisposta di esempio

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à.

GetSeries

L'GetSeriesoperazione restituisce l'elenco delle serie temporali le cui etichette corrispondono a uno o più selettori.

Verbi HTTP validi

GET, POST

URI valido

/api/v1/series

L'URL completo della richiesta combina l'host di CloudWatch monitoraggio per la AWS regione con il percorso dell'operazione, ad esempiohttps://monitoring.AWS Region.amazonaws.com/api/v1/series. 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

Parametro Description

match[]

Obbligatorio. Un selettore di serie che filtra le serie temporali da restituire. Ogni selettore deve includere una corrispondenza esatta (=) nel nome della metrica, ad esempio o. {"http.server.active_requests"} {__name__="http.server.active_requests"} I selettori senza un metric-name equal matcher non sono supportati. Oltre alla corrispondenza esatta, gli abbinatori di etichette supportano anche not equal (!=), regex match () e regex match (=~) negativo. !~ Specificate match[] una o più volte per combinare i selettori. Per ulteriori informazioni sulla sintassi dei selettori, vedere. Interrogazione ProMQL

start

Obbligatorio. Inizio dell'intervallo di tempo da considerare, come timestamp RFC 3339 o timestamp Unix.

end

Obbligatorio. Fine dell'intervallo di tempo da considerare, come timestamp RFC 3339 o timestamp Unix.

limit

Opzionale. Numero massimo di serie temporali univoche da restituire, da a. 1 10000 Se non si specificalimit, CloudWatch restituisce fino al massimo (10.000). Per informazioni, consulta Limite di risultati.

Autorizzazioni IAM richieste

Per chiamareGetSeries, l'identità chiamante deve avere la seguente azione IAM:

  • cloudwatch:ListMetrics

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

Limite di risultati

Una singola /api/v1/series risposta può restituire fino a 10.000 serie temporali uniche. Per richiedere un numero inferiore di risultati, passa il limit parametro con un valore compreso tra 1 a10000. 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

Esempi di richieste

La POST richiesta seguente utilizza un selettore di corrispondenza esatta. Il selettorestart, e end vengono passati come campi codificati dal modulo nel corpo della richiesta. I caratteri speciali come{,, e sono codificati } in " percentuale. , Il valore match[] decodificato è. {"http.server.active_requests","@resource.service.name"="myservice"}

POST /api/v1/series 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

match%5B%5D=%7B%22http.server.active_requests%22%2C%22%40resource.service.name%22%3D%22myservice%22%7D&start=1780662000&end=1780665600

La POST richiesta seguente utilizza un selettore di corrispondenza regex. Il valore decodificato è. match[] {"http.server.active_requests","@aws.region"=~"us-.*"}

POST /api/v1/series 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

match%5B%5D=%7B%22http.server.active_requests%22%2C%22%40aws.region%22%3D~%22us-.*%22%7D&start=1780662000&end=1780665600

La stessa chiamata conawscurl:

awscurl --service monitoring --region us-east-1 \
    -X POST 'https://monitoring.us-east-1.amazonaws.com/api/v1/series' \
    -H 'Content-Type: application/x-www-form-urlencoded' \
    -d 'match[]={"http.server.active_requests","@aws.region"=~"us-.*"}&start=1780662000&end=1780665600'

Risposta di esempio

Una risposta corretta utilizza la busta Prometheus JSON standard. Il data campo è una serie di mappe di etichette, una per serie corrispondente.

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

{
    "status": "success",
    "data": [
        {
            "__name__": "http.server.active_requests",
            "@resource.service.name": "myservice",
            "@aws.region": "us-east-1"
        },
        {
            "__name__": "http.server.active_requests",
            "@resource.service.name": "myservice",
            "@aws.region": "us-west-2"
        }
    ]
}