View a markdown version of this page

GetSeries - Amazon CloudWatch
URL-AbfrageparameterErforderliche IAM-BerechtigungenLimit für ErgebnisseBeispielanforderungenBeispielantwort

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

GetSeries

Die GetSeries Operation gibt die Liste der Zeitreihen zurück, deren Beschriftungen mit einem oder mehreren Selektoren übereinstimmen.

Gültige HTTP-Verben

GET, POST

Gültiger URI

/api/v1/series

Die vollständige Anforderungs-URL kombiniert beispielsweise den CloudWatch Überwachungshost für die AWS Region mit dem Operationspfadhttps://monitoring.AWS Region.amazonaws.com/api/v1/series. Informationen zu Endpunkten, Signierung und erforderlichen IAM-Berechtigungen finden Sie unter. PromQL abfragen

URL-Abfrageparameter

Die folgenden Parameter werden in der URL-Abfragezeichenfolge für GET Anfragen oder als formularkodierte Textfelder für Anfragen übergeben. POST

Parameter Description

match[]

Erforderlich Ein Serienselektor, der die zurückzugebende Zeitreihe filtert. Jeder Selektor muss eine exakte Übereinstimmung (=) mit dem Metriknamen enthalten, {"http.server.active_requests"} z. B. oder. {__name__="http.server.active_requests"} Selektoren ohne einen Gleichheitsmatcher für Metriknamen werden nicht unterstützt. Neben Exact Match unterstützen Label-Matcher auch Not Equal (!=), Regex Match () und Negative Regex Match (=~). !~ Geben Sie match[] ein oder mehrere Male an, um Selektoren zu kombinieren. Weitere Hinweise zur Selektorsyntax finden Sie unter. PromQL abfragen

start

Erforderlich Beginn des zu berücksichtigenden Zeitbereichs als RFC 3339-Zeitstempel oder Unix-Zeitstempel.

end

Erforderlich Ende des zu berücksichtigenden Zeitbereichs, als RFC 3339-Zeitstempel oder Unix-Zeitstempel.

limit

Optional. Maximale Anzahl eindeutiger Zeitreihen, die zurückgegeben werden sollen, von bis. 1 10000 Wenn Sie nichts angebenlimit, wird bis zum Maximum (10.000) CloudWatch zurückgegeben. Siehe Limit für Ergebnisse.

Erforderliche IAM-Berechtigungen

Für einen Anruf GetSeries muss die Identität des Anrufers über die folgende IAM-Aktion verfügen:

  • cloudwatch:ListMetrics

Die vollständige IAM-Aktionszuordnung für alle PromQL-Operationen finden Sie unter. IAM-Berechtigungen für PromQL

Limit für Ergebnisse

Eine einzelne /api/v1/series Antwort kann bis zu 10.000 eindeutige Zeitreihen zurückgeben. Um weniger Ergebnisse anzufordern, übergeben Sie den limit Parameter mit einem Wert von 1 bis10000. Wenn Sie nichts angebenlimit, wird bis zum Maximum CloudWatch zurückgegeben.

Wenn die übereinstimmende Serie die Obergrenze überschreitet, wird die Antwort gekürzt und eine Nachricht in das warnings Prometheus-Standardfeld aufgenommen. Der HTTP-Statuscode bleibt bestehen. 200

Die vollständige Liste der PromQL-Grenzwerte, einschließlich TPS, Parallelität und 24-Stunden-Scanfenster, finden Sie unter. Grenzen und Einschränkungen von PromQL

Beispielanforderungen

Die folgende POST Anfrage verwendet einen Exact Match Selector. Die Selektorenstart, und end werden als formularkodierte Felder im Hauptteil der Anfrage übergeben. Sonderzeichen wie{,, und sind } " prozentcodiert. , Der match[] dekodierte Wert ist. {"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

Die folgende POST Anfrage verwendet einen Regex-Match-Selektor. Der match[] dekodierte Wert ist. {"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

Derselbe Anruf mitawscurl:

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'

Beispielantwort

Eine erfolgreiche Antwort verwendet den standardmäßigen Prometheus-JSON-Envelope. Das data Feld besteht aus einer Reihe von Label-Maps, eine pro übereinstimmender Serie.

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