QueryMetrics - Servicio administrado por Amazon para Prometheus

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

QueryMetrics

La operación QueryMetrics evalúa una consulta instantánea en un único punto en el tiempo o en un intervalo de tiempo.

Verbos HTTP válidos:

GET, POST

Válido URIs:

/workspaces/workspaceId/api/v1/query Este URI evalúa una consulta instantánea en un único momento.

/workspaces/workspaceId/api/v1/query_range Este URI evalúa una consulta instantánea en un intervalo de tiempo.

Parámetros de consulta de URL:

query=<string> Una cadena de consulta de expresiones de Prometheus. Se utiliza tanto en query como en query_range.

time=<rfc3339 | unix_timestamp> (Opcional) Marca temporal de evaluación si está utilizando la query para una consulta instantánea en un momento dado.

timeout=<duration> (Opcional) Tiempo de espera de la evaluación. Por defecto, se limita al valor de la marca -query.timeout. Se utiliza tanto en query como en query_range.

start=<rfc3339 | unix_timestamp> Marca de tiempo de inicio si está utilizando query_range para consultar un intervalo de tiempo.

end=<rfc3339 | unix_timestamp> Marca de tiempo de finalización si está utilizando query_range para consultar un intervalo de tiempo.

step=<duration | float> Ancho del paso de resolución de la consulta en formato duration o como número de segundos float. Úselo solo si va a utilizar query_range para realizar consultas durante un intervalo de tiempo y si es necesario para dichas consultas.

max_samples_processed_warning_threshold=<integer>(Opcional) Establece el umbral de advertencia para las muestras de consulta procesadas (QSP). Cuando las consultas alcancen este umbral, se mostrará un mensaje de advertencia en la respuesta de la API.

max_samples_processed_error_threshold=<integer>>(Opcional) Establece el umbral de error para las muestras de consulta procesadas (QSP). Las consultas que superen este umbral se rechazarán con un error y no se cobrará nada. Se utiliza para evitar costes de consulta excesivos.

Duración

En una API compatible con Prometheus, una duration es un número, seguido inmediatamente de una de las siguientes unidades:

  • ms milisegundos

  • s segundos

  • m minutos

  • h horas

  • d días, suponiendo que un día siempre tenga 24 horas

  • w semanas, suponiendo que una semana siempre tenga 7 días

  • y años, suponiendo que un año siempre tenga 365 días

Solicitud de ejemplo

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

Respuesta de ejemplo

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