Skip to main content
Il blueprint Time Range invia a Dodo Payments un evento di utilizzo con la durata di esecuzione di una risorsa per un cliente, espressa in millisecondi, secondi o minuti. Un meter di tipo Sum applicato a questa durata somma il tempo di esecuzione di ogni cliente, permettendoti di addebitare il tempo di elaborazione. Il blueprint è incluso nel pacchetto npm @dodopayments/ingestion-blueprints come trackTimeRange().

Casi d’uso

Il blueprint Time Range è adatto ai seguenti scenari:

Serverless Functions

Addebita in base al tempo di esecuzione delle funzioni e all’utilizzo della memoria.

Container Runtime

Monitora il tempo di esecuzione dei container per la fatturazione basata sull’utilizzo.

Compute Instances

Monitora il tempo di esecuzione delle VM e addebita in base al minuto o all’ora.

Background Jobs

Monitora il tempo di elaborazione per esportazioni di dati, report e processi batch.
Usalo per addebitare il tempo di elaborazione, la durata dell’esecuzione delle funzioni, il tempo di esecuzione dei container o qualsiasi altro utilizzo basato sul tempo.

Avvio rapido

Per monitorare il tempo di esecuzione, installa il pacchetto, crea un meter e invia la durata ogni volta che una risorsa termina l’esecuzione.
1

Install the SDK

Installa il pacchetto Dodo Payments Ingestion Blueprints:
2

Get Your API Keys

Crea una chiave API Dodo Payments in Developer → API Keys nella dashboard Dodo Payments e salvala nella variabile d’ambiente DODO_PAYMENTS_API_KEY. Usa una chiave in modalità test durante lo sviluppo. Una chiave in modalità test funziona solo con test_mode.
3

Create a Meter

Nella dashboard Dodo Payments, vai a Products → Meters e fai clic su Create Meter. Configura i seguenti campi:
  • Meter Name: un nome descrittivo, ad esempio Compute Time.
  • Event Name: time_range_usage, oppure un nome a tua scelta. Deve corrispondere esattamente a eventName nel tuo codice (maiuscole e minuscole incluse). Gli esempi nel passaggio successivo usano un nome di evento separato per ogni tipo di risorsa, ad esempio function_execution, quindi ognuno richiede il proprio meter.
  • Aggregation Type: Sum, per sommare la durata totale.
  • Over Property: la chiave della durata che invii: durationSeconds, durationMinutes o durationMs.
  • Measurement Unit: l’unità mostrata sulle fatture, ad esempio seconds.
4

Track Time Usage

Misura la durata dell’esecuzione, quindi chiama trackTimeRange() con la durata nell’unità utilizzata dal meter:

Configurazione

Configurazione dell’acquisizione

Passa queste opzioni a new Ingestion():
string
obbligatorio
La tua chiave API Dodo Payments dalla dashboard.
string
Modalità dell’ambiente: test_mode o live_mode. Il valore predefinito è test_mode. Gli SDK Dodo Payments utilizzano invece live_mode per impostazione predefinita, quindi in produzione devi impostare esplicitamente live_mode.
string
obbligatorio
Nome dell’evento che corrisponde a Event Name del meter (maiuscole e minuscole incluse).

Opzioni per il monitoraggio del Time Range

Passa queste opzioni a trackTimeRange(). Ogni durata che passi viene inviata come chiave dei metadati con lo stesso nome.
string
obbligatorio
L’ID cliente Dodo Payments a cui addebitare il tempo di esecuzione, ad esempio cus_123.
number
Durata in millisecondi. Usala per una precisione inferiore al secondo.
number
Durata in secondi. È l’unità più comune per l’esecuzione delle funzioni e le attività brevi.
number
Durata in minuti. È utile per risorse con esecuzione più lunga, come le VM.
object
Metadati facoltativi sulla risorsa, come CPU, memoria o regione. Ogni valore deve essere una stringa, un numero o un booleano.

Procedure consigliate

Scegli l’unità corretta: usa i millisecondi per le operazioni brevi, i secondi per le funzioni e i minuti per le risorse con esecuzione più lunga.
Un meter somma solo la chiave indicata da Over Property, quindi invia ogni volta la durata nella stessa unità.
Misurazione accurata del tempo: usa Date.now() o performance.now() per monitorare il tempo con precisione, soprattutto per le funzioni serverless.
Ultima modifica il 26 settembre 2026