Skip to main content
GET
Consulta de métrica estruturada de intervalo
Requer a ação do IAM telemetry:ReadMetrics. Consulte permissões de telemetria para obter a lista completa, o que cada uma abrange e um exemplo de política.

Autorizações

Authorization
string
header
obrigatório

Um token bearer OAuth 2.0, enviado como Authorization: Bearer <token>. Esta é a forma recomendada de autenticação.

Obtenha o token trocando o par de chaves de acesso de uma conta de serviço em POST /v1/oauth/token com grant_type=client_credentials. Esse é o fluxo padrão de credenciais de cliente; bibliotecas compatíveis com OAuth podem obter e renovar o token para você.

Os tokens duram uma hora por padrão. O mesmo par de chaves de acesso também serve como credencial AWS SigV4 para o endpoint de objetos compatível com S3, que aceita somente esse método de autenticação.

Parâmetros de consulta

metric
string
obrigatório
Exemplo:

"http_requests_total"

agg
enum<string>
obrigatório
Opções disponíveis:
avg,
sum,
min,
max,
count,
last,
rate,
increase
Exemplo:

"avg"

match[]
string[]
by[]
string[]
start
string
obrigatório
Exemplo:

"2026-01-15T09:00:00Z"

end
string
obrigatório
Exemplo:

"2026-01-15T10:00:00Z"

step
string

Duração da largura da caçamba (ex. "15s", "1m")

Exemplo:

"15s"

Resposta

Resposta da matriz de Prometheus

The response is of type object.