QueryMetrics - Amazon Managed Service for Prometheus

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’opération QueryMetrics évalue une requête instantanée à un moment donné ou sur une période donnée.

Verbes HTTP valides :

GET, POST

URI valides :

/workspaces/workspaceId/api/v1/query Cet URI évalue une requête instantanée à un moment donné.

/workspaces/workspaceId/api/v1/query_range Cet URI évalue une requête instantanée sur une période donnée.

Paramètres de requête d’URL :

query=<string> Chaîne de requête d’expression Prometheus. Utilisée à la fois dans query et query_range.

time=<rfc3339 | unix_timestamp> (Facultatif) Horodatage d’évaluation si vous utilisez query pour une requête instantanée à un moment donné.

timeout=<duration> (Facultatif) Délai d’évaluation. La valeur par défaut est définie et plafonnée par la valeur de l’indicateur -query.timeout. Utilisée à la fois dans query et query_range.

start=<rfc3339 | unix_timestamp> Démarrez l’horodatage si vous utilisez query_range pour effectuer des requêtes sur un intervalle de temps.

end=<rfc3339 | unix_timestamp> Arrêtez l’horodatage si vous utilisez query_range pour effectuer des requêtes sur un intervalle de temps.

step=<duration | float> Interrogez la durée de l’étape de résolution sous forme de duration ou sous forme d’un nombre float de secondes. À utiliser uniquement si vous utilisez query_range pour effectuer des requêtes sur un intervalle de temps, et nécessaire pour ce type de requêtes.

Durée

Une duration dans une API compatible avec Prometheus est un nombre, suivi immédiatement de l’une des unités suivantes :

  • ms millisecondes

  • s secondes

  • m minutes

  • h heures

  • d jours, en supposant qu’un jour compte toujours 24 heures

  • w semaines, en supposant qu’une semaine compte toujours 7 jours

  • y années, en supposant qu’une année compte toujours 365 jours

Exemple de demande

POST /workspaces/ws-b226cc2a-a446-46a9-933a-ac50479a5568/api/v1/query?query=sum(node_cpu_seconds_total) HTTP/1.1
Content-Length: 0, 
Authorization: AUTHPARAMS
X-Amz-Date: 20201201T193725Z
User-Agent: Grafana/8.1.0

Exemple de réponse

HTTP/1.1 200 OK
x-amzn-RequestId: 12345678-abcd-4442-b8c5-262b45e9b535
Content-Length: 132
Connection: keep-alive
Date: Tue, 01 Dec 2020 19:37:25 GMT
Content-Type: application/json
Server: amazon
content-encoding: gzip

{
    "status": "success",
    "data": {
        "resultType": "vector",
        "result": [
            {
                "metric": {},
                "value": [
                    1634937046.322,
                    "252590622.81000024"
                ]
            }
        ]
    }
}