Docs
Observabilidade

Observabilidade

Monitore uso, latência e custos em tempo real pelo Dashboard.

O Ignus Code registra automaticamente cada requisição processada pela API. Acesse todos os dados em Dashboard → Logs.

O que é monitorado

Para cada requisição, o sistema registra:

CampoDescrição
timestampData e hora da requisição
modelModelo solicitado
providerProvedor que respondeu
prompt_tokensTokens de entrada
completion_tokensTokens de saída
total_tokensTotal de tokens consumidos
latency_msLatência total em milissegundos
cost_brlCusto em reais
statussuccess, fallback, error

Dashboard de métricas

O Dashboard exibe:

  • Gráfico de requisições por hora/dia/semana
  • Custo acumulado do período
  • Latência média por modelo
  • Taxa de erro por provedor
  • Top modelos mais usados

Alertas de gasto

Configure alertas para receber notificação quando o gasto atingir um limite:

  1. Dashboard → Configurações → Alertas
  2. Defina o valor limite (ex: R$ 50,00)
  3. Escolha o canal: e-mail ou webhook
{
  "type": "spend_alert",
  "threshold_brl": 50.00,
  "webhook_url": "https://seu-app.com/webhook/ignus"
}

Logs via API

Em versões futuras, os logs estarão disponíveis via API REST para integração com ferramentas externas (Datadog, Grafana, etc.).

GET https://proxy.ignustec.com.br/v1/usage/logs
Authorization: Bearer sk_ic_xxxxxxxxxxxxxxxxxxxx

Saldo e créditos

Acompanhe seu saldo em tempo real no Dashboard ou via API:

curl https://proxy.ignustec.com.br/v1/billing/balance \
  -H "Authorization: Bearer $IGNUS_API_KEY"
{
  "balance_brl": "R$ 23,47",
  "last_refill": "2026-06-20T14:30:00Z"
}

Quando o saldo chegar a R$ 2,00, você recebe um e-mail de aviso automaticamente. Configure um alerta de saldo baixo em Dashboard → Configurações.