Saltar al contenido principal
Los medidores convierten eventos en bruto en cantidades facturables. Filtran eventos y aplican funciones de agregación (Contar, Sumar, Máximo, Último) para calcular el uso por cliente.
Interfaz de creación de medidor que muestra el nombre del evento, tipo de agregación y opciones de filtrado

​
Recursos de API

​
Creando un Medidor

1

Información Básica

​
Nombre del Medidor
string
required
Nombre descriptivo (por ejemplo, “Solicitudes API”, “Uso de Token”)
​
Nombre del Evento
string
required
Nombre exacto del evento a coincidir (sensible a mayúsculas). Ejemplos: api.call, image.generated
2

Agregación

​
Tipo de Agregación
string
required
Elige cómo se agregan los eventos:
  • Contar: Número total de eventos (llamadas API, cargas)
  • Sumar: Sumar valores numéricos (tokens, bytes)
  • Máximo: Valor más alto en el período (usuarios picos)
  • Último: Valor más reciente
​
Sobre Propiedad
string
Clave de metadatos para agregar (requerido para todos los tipos excepto Contar). Ejemplos: tokens, bytes, duration_ms
​
Unidad de Medida
string
required
Etiqueta de unidad para facturas. Ejemplos: calls, tokens, GB, hours
3

Filtrado (Opcional)

Filtrado de eventos
Agrega condiciones para filtrar qué eventos se cuentan:
  • Lógica AND: Todas las condiciones deben coincidir
  • Lógica OR: Cualquier condición puede coincidir
Comparadores: igual, no igual, mayor que, menor que, contieneHabilita el filtrado, elige la lógica, agrega condiciones con clave de propiedad, comparador y valor.
4

Crear

Revisa la configuración y haz clic en Crear Medidor.

​
Visualizando Analíticas

Analíticas del medidor
Tu panel de medidores muestra:
  • Resumen: Uso total y gráfico de uso
  • Eventos: Eventos individuales recibidos
  • Clientes: Uso y cargos por cliente

​
Solución de Problemas

  • El nombre del evento debe coincidir exactamente (sensible a mayúsculas)
  • Verifica que los filtros del medidor no estén excluyendo eventos
  • Verifica que los IDs de cliente existan
  • Desactiva temporalmente los filtros para probar
  • Verifica que la Propiedad coincida exactamente con la clave de metadatos
  • Usa números, no cadenas: tokens: 150 no "150"
  • Incluye propiedades requeridas en todos los eventos
  • Coincide exactamente con mayúsculas y minúsculas
  • Usa los operadores correctos para el tipo de datos
  • Asegúrate de que los eventos incluyan propiedades filtradas
  • Verifica la pestaña de Eventos para contar los eventos reales recibidos
  • Verifica el tipo de agregación (Contar vs Sumar)
  • Asegúrate de que los valores sean numéricos para Sumar/Máximo

​
Próximos Pasos

Enviar Eventos

Comienza a enviar eventos de uso desde tu aplicación a tus medidores.

Ver Plantillas

Usa configuraciones de medidor listas para casos de uso comunes.