@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 aeventNamenel tuo codice (maiuscole e minuscole incluse). Gli esempi nel passaggio successivo usano un nome di evento separato per ogni tipo di risorsa, ad esempiofunction_execution, quindi ognuno richiede il proprio meter. - Aggregation Type: Sum, per sommare la durata totale.
- Over Property: la chiave della durata che invii:
durationSeconds,durationMinutesodurationMs. - 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 anew 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 atrackTimeRange(). 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.