QueryMetrics - Amazon Managed Service for Prometheus

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

QueryMetrics

A operação QueryMetrics avalia uma consulta instantânea em um único momento ou em um intervalo de tempo.

Verbos HTTP válidos:

GET, POST

Válido URIs:

/workspaces/workspaceId/api/v1/query Esse URI avalia uma consulta instantânea em um único momento.

/workspaces/workspaceId/api/v1/query_range Esse URI avalia uma consulta instantânea em um intervalo de tempo.

Parâmetros da consulta de URL:

query=<string> Uma string de consulta da expressão Prometheus. Usado em ambos query e query_range.

time=<rfc3339 | unix_timestamp> (Opcional) Carimbo de data/hora de avaliação se você estiver usando o query para uma consulta instantânea em um único momento.

timeout=<duration> (Opcional) Tempo limite de avaliação. O padrão é e é limitado pelo valor do sinalizador -query.timeout. Usado em ambos query e query_range.

start=<rfc3339 | unix_timestamp> Inicie o timestamp se você estiver usando query_range para consultar por um intervalo de tempo.

end=<rfc3339 | unix_timestamp> Carimbo de data/hora de término se você estiver usando query_range para consultar por um intervalo de tempo.

step=<duration | float> Largura da etapa de resolução da consulta em duration formato ou em float alguns segundos. Use somente se você estiver usando query_range para consultar por um intervalo de tempo e for necessário para essas consultas.

max_samples_processed_warning_threshold=<integer>(Opcional) Define o limite de aviso para amostras de consulta processadas (QSP). Quando as consultas atingirem esse limite, uma mensagem de aviso será retornada na resposta da API.

max_samples_processed_error_threshold=<integer>>(Opcional) Define o limite de erro para amostras de consulta processadas (QSP). As consultas que excederem esse limite serão rejeitadas com um erro e não serão cobradas. Usado para evitar custos excessivos de consulta.

Duration (Duração)

A duration em uma API compatível com o Prometheus é um número, seguido imediatamente por uma das seguintes unidades:

  • ms milissegundos

  • s segundos

  • m minutos

  • h horas

  • d dias, supondo que um dia sempre tenha 24h

  • w semanas, supondo que uma semana sempre tenha 7 dias

  • y anos, supondo que um ano sempre tenha 365 dias

Exemplo de solicitação

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

Exemplo de resposta

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