Pular para o conteúdo principal
Os medidores convertem eventos brutos em quantidades faturáveis. Eles filtram eventos e aplicam funções de agregação (Contar, Somar, Máximo, Último) para calcular o uso por cliente.
Interface de criação de medidor mostrando nome do evento, tipo de agregação e opções de filtragem

​
Recursos da API

​
Criando um Medidor

1

Informações Básicas

​
Nome do Medidor
string
required
Nome descritivo (ex: “Solicitações de API”, “Uso de Token”)
​
Nome do Evento
string
required
Nome exato do evento a ser correspondido (case-sensitive). Exemplos: api.call, image.generated
2

Agregação

​
Tipo de Agregação
string
required
Escolha como os eventos são agregados:
  • Contar: Número total de eventos (chamadas de API, uploads)
  • Somar: Adicione valores numéricos (tokens, bytes)
  • Máximo: Maior valor no período (usuários em pico)
  • Último: Valor mais recente
​
Sobre Propriedade
string
Chave de metadados para agregar (obrigatório para todos os tipos, exceto Contar). Exemplos: tokens, bytes, duration_ms
​
Unidade de Medida
string
required
Rótulo da unidade para faturas. Exemplos: calls, tokens, GB, hours
3

Filtragem (Opcional)

Filtragem de eventos
Adicione condições para filtrar quais eventos são contados:
  • Lógica AND: Todas as condições devem corresponder
  • Lógica OR: Qualquer condição pode corresponder
Comparadores: igual, diferente, maior que, menor que, contémAtive a filtragem, escolha a lógica, adicione condições com chave de propriedade, comparador e valor.
4

Criar

Revise a configuração e clique em Criar Medidor.

​
Visualizando Análises

Análises do medidor
Seu painel de medidores mostra:
  • Visão Geral: Uso total e gráfico de uso
  • Eventos: Eventos individuais recebidos
  • Clientes: Uso e cobranças por cliente

​
Solução de Problemas

  • O nome do evento deve corresponder exatamente (case-sensitive)
  • Verifique se os filtros do medidor não estão excluindo eventos
  • Verifique se os IDs dos clientes existem
  • Desative temporariamente os filtros para testar
  • Verifique se a Propriedade corresponde exatamente à chave de metadados
  • Use números, não strings: tokens: 150 não "150"
  • Inclua propriedades obrigatórias em todos os eventos
  • Correspondência exata de maiúsculas e minúsculas
  • Use operadores corretos para o tipo de dado
  • Certifique-se de que os eventos incluam propriedades filtradas
  • Verifique a aba Eventos para contar os eventos reais recebidos
  • Verifique o tipo de agregação (Contar vs Somar)
  • Certifique-se de que os valores são numéricos para Somar/Máximo

​
Próximos Passos

Enviar Eventos

Comece a enviar eventos de uso do seu aplicativo para seus medidores.

Ver Modelos

Use configurações de medidores prontas para casos de uso comuns.