Blueprint Rentang Waktu

Lacak konsumsi sumber daya berdasarkan waktu yang berlalu untuk komputasi, fungsi serverless, kontainer, dan penagihan runtime.

​

Kasus Penggunaan

Jelajahi skenario umum yang didukung oleh Blueprint Rentang Waktu:

Serverless Functions

Tagih berdasarkan waktu eksekusi fungsi dan penggunaan memori.

Container Runtime

Lacak waktu berjalan kontainer untuk penagihan berbasis penggunaan.

Compute Instances

Pantau waktu berjalan VM dan kenakan biaya per menit atau jam.

Background Jobs

Lacak waktu pemrosesan untuk ekspor data, laporan, dan pekerjaan batch.

Sangat cocok untuk penagihan berdasarkan waktu komputasi, durasi eksekusi fungsi, waktu berjalan kontainer, atau penggunaan berdasarkan waktu lainnya.

​

Memulai dengan Cepat

Lacak penggunaan sumber daya berdasarkan durasi waktu:

1. Install the SDK

   npm install @dodopayments/ingestion-blueprints
   
2. Get Your API Keys

   • Dodo Payments API Key: Dapatkan dari Dodo Payments Dashboard
3. Create a Meter

   Buat meter di Dodo Payments Dashboard:

   • Event Name: time_range_usage (atau nama pilihan Anda)
   • Aggregation Type: sum untuk melacak total durasi
   • Over Property: durationSeconds, durationMinutes, atau durationMs
4. Track Time Usage

   Serverless Functions

   import { Ingestion, trackTimeRange } from '@dodopayments/ingestion-blueprints';
   
   const ingestion = new Ingestion({
     apiKey: process.env.DODO_PAYMENTS_API_KEY,
     environment: 'test_mode',
     eventName: 'function_execution'
   });
   
   // Track function execution time
   const startTime = Date.now();
   
   // Execute your function (example: image processing)
   const result = await yourImageProcessingLogic();
   
   const durationMs = Date.now() - startTime;
   
   await trackTimeRange(ingestion, {
     customerId: 'customer_123',
     durationMs: durationMs
   });
   

   import { Ingestion, trackTimeRange } from '@dodopayments/ingestion-blueprints';
   
   const ingestion = new Ingestion({
     apiKey: process.env.DODO_PAYMENTS_API_KEY,
     environment: 'test_mode',
     eventName: 'container_runtime'
   });
   
   // Track container runtime in seconds
   await trackTimeRange(ingestion, {
     customerId: 'customer_456',
     durationSeconds: 120
   });
   

   import { Ingestion, trackTimeRange } from '@dodopayments/ingestion-blueprints';
   
   const ingestion = new Ingestion({
     apiKey: process.env.DODO_PAYMENTS_API_KEY,
     environment: 'test_mode',
     eventName: 'vm_runtime'
   });
   
   // Track VM runtime in minutes
   await trackTimeRange(ingestion, {
     customerId: 'customer_789',
     durationMinutes: 60
   });
   

​

Konfigurasi

​

Konfigurasi Ingesti

apiKey · string · wajib

Kunci API Dodo Payments Anda dari dasbor.

environment · string · wajib

Mode lingkungan: test_mode atau live_mode.

eventName · string · wajib

Nama peristiwa yang sesuai dengan konfigurasi meter Anda.

​

Opsi Rentang Waktu Lacak

customerId · string · wajib

ID pelanggan untuk atribusi penagihan.

durationMs · number

Durasi dalam milidetik. Gunakan untuk presisi di bawah satu detik.

durationSeconds · number

Durasi dalam detik. Paling umum untuk eksekusi fungsi dan tugas singkat.

durationMinutes · number

Durasi dalam menit. Berguna untuk sumber daya yang berjalan lebih lama seperti VM.

metadata · object

Metadata opsional tentang sumber daya seperti CPU, memori, wilayah, dll.

​

Praktik Terbaik

Pilih Unit yang Tepat: Gunakan milidetik untuk operasi pendek, detik untuk fungsi, dan menit untuk sumber daya yang berjalan lebih lama.

Waktu yang Akurat: Gunakan Date.now() atau performance.now() untuk pelacakan waktu yang akurat, terutama untuk fungsi tanpa server.