Skip to main content
Filtros definem quais eventos contam. Agregação define como os valores são combinados. Juntos, eles transformam uma massa de eventos brutos em um número preciso para cobrança.

​
Filtragem de eventos

Filtros permitem selecionar um subconjunto de eventos com base em suas propriedades. No Dashboard, os filtros são configurados diretamente na tela de edição do recurso:
Aira — Configuração de filtros de um recurso
  • eventName — inclua um ou mais tipos de evento (ex: api_request, storage_used)
  • Propriedades: Restrinja por valores dentro de properties (ex: region = "sa-east-1")
  • Tags: Classifique eventos por categorias adicionais
Filtro: eventName IN ("ticket_resolved_ai", "ticket_resolved_human")
        AND properties.channel = "chat"

→ Inclui apenas tickets resolvidos via chat, por qualquer tipo de agente
Planeje suas propriedades de evento desde o início da integração. Incluir propriedades como region, plan_tier, channel permite criar recursos com filtros granulares depois, sem alterar o código de envio.

​
Tipos de agregação

Soma todos os valores dos eventos filtrados ocorridos no período.Quando usar: métricas cumulativas que partem de zero a cada ciclo — requisições de API, mensagens enviadas, transações processadas.
Eventos no período: 120, 80, 300
Agregação por soma → 120 + 80 + 300 = 500
A maioria dos recursos de faturamento baseado em uso utiliza agregação por soma.

​
Exemplos práticos

​
Plataforma de API — requisições por endpoint

Recurso: “Requisições ao endpoint /payments”
  • Filtro: eventName = "api_request" AND properties.endpoint = "/v1/payments"
  • Agregação: Soma
  • Tipo: Unitário
  • Resultado: total de chamadas ao endpoint de pagamentos no mês

​
Cloud storage — armazenamento diário

Recurso: “Armazenamento utilizado”
  • Filtro: eventName = "storage_snapshot"
  • Agregação: Último do Período
  • Tipo: Unitário
  • Resultado: quantidade de GB armazenados ao final do mês (não acumulativo)

​
Fintech — volume transacionado

Recurso: “Volume de transações”
  • Filtro: eventName = "transaction_processed"
  • Agregação: Soma
  • Tipo: Monetário (valores em centavos)
  • Resultado: total em reais transacionados, usado para cobrar comissão percentual

​
Próximos passos

  • Tipos de recursos — entenda a diferença entre unitário e monetário
  • Planos — associe recursos a modelos de precificação