Skip to main content
GET
Consulta de métrica estruturada instantânea
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

Nome da métrica

Exemplo:

"http_requests_total"

agg
enum<string>
obrigatório

Agregação

Opções disponíveis:
avg,
sum,
min,
max,
count,
last,
rate,
increase
Exemplo:

"avg"

match[]
string[]

Combinadores de etiquetas (p. ex. (job="api")

by[]
string[]

Agrupar por nomes de rótulo

step
string

Duração da janela de retrospectiva (por exemplo, "15s", "5m"). Padrão: 5m.

Exemplo:

"5m"

time
string

Carimbo de data/hora de avaliação (RFC 3339 ou segundos unix). Padrões para agora.

Exemplo:

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

Resposta

Prometheus vector response

The response is of type object.