Vai al contenuto principale
I misuratori convertono eventi grezzi in quantità fatturabili. Filtrano gli eventi e applicano funzioni di aggregazione (Conteggio, Somma, Massimo, Ultimo) per calcolare l’utilizzo per cliente.
Interfaccia di creazione del misuratore che mostra il nome dell'evento, il tipo di aggregazione e le opzioni di filtraggio

​
Risorse API

​
Creazione di un Misuratore

1

Informazioni di Base

​
Nome Misuratore
string
obbligatorio
Nome descrittivo (es. “Richieste API”, “Utilizzo Token”)
​
Nome Evento
string
obbligatorio
Nome esatto dell’evento da abbinare (case-sensitive). Esempi: api.call, image.generated
2

Aggregazione

​
Tipo di Aggregazione
string
obbligatorio
Scegli come aggregare gli eventi:
  • Conteggio: Numero totale di eventi (chiamate API, caricamenti)
  • Somma: Aggiungi valori numerici (token, byte)
  • Massimo: Valore più alto nel periodo (utenti di picco)
  • Ultimo: Valore più recente
​
Su Proprietà
string
Chiave metadata da aggregare (richiesta per tutti i tipi tranne Conteggio). Esempi: tokens, bytes, duration_ms
​
Unità di Misura
string
obbligatorio
Etichetta dell’unità per le fatture. Esempi: calls, tokens, GB, hours
3

Filtraggio (Opzionale)

Filtraggio eventi
Aggiungi condizioni per filtrare quali eventi vengono conteggiati:
  • Logica AND: Tutte le condizioni devono corrispondere
  • Logica OR: Qualsiasi condizione può corrispondere
Comparatori: uguale, diverso, maggiore di, minore di, contieneAbilita il filtraggio, scegli la logica, aggiungi condizioni con chiave proprietà, comparatore e valore.
4

Crea

Rivedi la configurazione e fai clic su Crea Misuratore.

​
Visualizzazione Analitiche

Analitiche del misuratore
Il tuo cruscotto dei misuratori mostra:
  • Panoramica: Utilizzo totale e grafico dell’utilizzo
  • Eventi: Eventi individuali ricevuti
  • Clienti: Utilizzo e addebiti per cliente

​
Risoluzione dei Problemi

  • Il nome dell’evento deve corrispondere esattamente (case-sensitive)
  • Controlla che i filtri del misuratore non stiano escludendo eventi
  • Verifica che gli ID cliente esistano
  • Disabilita temporaneamente i filtri per testare
  • Verifica che la Proprietà corrisponda esattamente alla chiave metadata
  • Usa numeri, non stringhe: tokens: 150 non "150"
  • Includi proprietà richieste in tutti gli eventi
  • Corrispondenza esatta del caso
  • Usa operatori corretti per il tipo di dati
  • Assicurati che gli eventi includano le proprietà filtrate
  • Controlla la scheda Eventi per contare gli eventi effettivamente ricevuti
  • Verifica il tipo di aggregazione (Conteggio vs Somma)
  • Assicurati che i valori siano numerici per Somma/Massimo

​
Prossimi Passi

Invia Eventi

Inizia a inviare eventi di utilizzo dalla tua applicazione ai tuoi misuratori.

Visualizza Blueprint

Utilizza configurazioni di misuratori pronte all’uso per casi d’uso comuni.