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.

GetSeries

L'GetSeriesopération renvoie la liste des séries chronologiques dont les libellés correspondent à un ou plusieurs sélecteurs.

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/series. 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.

Autorisations IAM requises

Pour appelerGetSeries, l'identité appelante doit avoir l'action IAM suivante :

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/series réponse peut renvoyer jusqu'à 10 000 séries chronologiques uniques. Pour demander moins de résultats, transmettez le limit paramètre avec une valeur comprise entre 1 et10000. Si vous ne spécifiez paslimit, CloudWatch renvoie le 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 demandes

La POST requête suivante utilise un sélecteur de correspondance exacte. Les sélecteursstart, et end sont transmis sous forme de champs codés sous forme de formulaire dans le corps de la demande. Les caractères spéciaux tels que{, }", et , sont codés en pourcentage. La match[] valeur décodée est{"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 requête suivante utilise un sélecteur de correspondance regex. La match[] valeur décodée est{"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

Le même appel avec awscurl :

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'

Exemple de réponse

Une réponse réussie utilise l'enveloppe JSON Prometheus standard. Le data champ est un ensemble de cartes d'étiquettes, une par série correspondante.

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