VolundOS
Referência da APIGovernança

Consultar métricas reportadas

Devolve as amostras já reportadas de um ativo. Exige o escopo governance:read.

Atualizado em 13 de agosto de 2026
GET
/v1/governance/metrics

Authorization

chaveDeApi
AuthorizationBearer <token>

Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.

In: header

Query Parameters

asset_id*string

Ativo cujas amostras devem ser devolvidas.

metric_key?string

Restringe a uma métrica.

since?string

Só amostras a partir deste instante.

Formatdate-time
limit?integer

Quantidade máxima de amostras.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/governance/metrics?asset_id=string"
{  "asset_id": "string",  "samples": [    {      "id": "string",      "metric_key": "string",      "metric_kind": "string",      "value": 0,      "sample_count": 0,      "reported_at": "2019-08-24T14:15:22Z",      "window_start": "2019-08-24T14:15:22Z",      "window_end": "2019-08-24T14:15:22Z",      "source": "string",      "batch_id": "string",      "labels": {}    }  ]}

Reportar métricas de um ativo

Recebe métricas em lote. Depois de gravar, avalia os monitores da organização e abre alerta quando um limiar é violado — a menos que evaluate venha desligado. Exige o escopo governance:write.

Configurar um monitor

Cria um monitor de limiar sobre uma métrica de um ativo. Quando o limiar é violado, abre alerta e dispara os webhooks configurados. Exige o escopo governance:write.