Uso e logs
A tendência de uso mostra a carga; os logs por requisição trazem horário, chave, modelo, tokens, custo, latência e status.
O console oferece duas visões do consumo: a tendência de uso na visão geral da conta (macro — como a carga se comporta) e os logs por requisição (micro — registros exatos).
Tendência de uso (visão geral da conta)
- Um gráfico de série temporal do volume de chamadas, medido em tokens;
- Use-o para avaliar a carga geral e identificar picos anormais (por exemplo, um dia em que o uso dobra de repente);
- Um estado vazio significa simplesmente que não houve chamadas no período.
Logs (registros por requisição)
A página de logs registra cada requisição à API com campos que você pode auditar:
| Campo | Descrição |
|---|---|
| Horário da requisição | Quando a chamada aconteceu — ancora a conciliação |
| Chave de API | Qual chave fez a chamada (distinguida pelo nome) |
| Modelo | O ID do modelo realmente invocado |
| Tokens | Tokens consumidos pela chamada (entrada + saída) |
| Custo | O valor descontado |
| Latência | Duração da requisição — para caçar chamadas lentas |
| Status | Sucesso / falha com o código de status correspondente |
Usos típicos
- Conciliação: agregue os logs em um intervalo de tempo e compare contagens e valores com os registros de requisição da sua aplicação;
- Localizar gastos anormais: filtre por chave para achar os maiores consumidores — o culpado costuma ser uma chave de teste usada por engano em produção;
- Depurar falhas: combine com Códigos de erro e observe os códigos de status ao longo do tempo (falhas concentradas em um momento geralmente indicam uma instabilidade da plataforma);
- Acompanhar desempenho: a coluna de latência revela modelos lentos ou requisições com contexto longo, orientando a escolha de modelo e as configurações de timeout.
Logs e uso vêm de chamadas reais — os registros ficam consultáveis imediatamente após uma requisição, sem nada a aguardar.