الانتقال إلى المحتوى الرئيسي

حالات الاستخدام

استكشف السيناريوهات الشائعة المدعومة من نموذج نطاق الوقت:

Serverless Functions

فوتر بناءً على وقت تنفيذ الدالة واستخدام الذاكرة.

Container Runtime

تتبع وقت تشغيل الحاوية للفوترة بناءً على الاستخدام.

Compute Instances

راقب وقت تشغيل VM واحتسب الرسوم حسب الدقيقة أو الساعة.

Background Jobs

تتبع وقت المعالجة لتصدير البيانات، التقارير، والمهام الدفعية.
مثالي للفوترة بناءً على وقت الحوسبة، مدة تنفيذ الدوال، وقت تشغيل الحاوية، أو أي استخدام يعتمد على الوقت.

البدء السريع

تتبع استخدام الموارد حسب مدة الوقت:
1

Install the SDK

npm install @dodopayments/ingestion-blueprints
2

Get Your API Keys

3

Create a Meter

أنشئ عدادًا في لوحة Dodo Payments:
  • اسم الحدث: time_range_usage (أو الاسم المفضل لديك)
  • نوع التجميع: sum لتتبع المدة الإجمالية
  • خاصية Over: durationSeconds، durationMinutes، أو durationMs
4

Track Time Usage

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
});

التكوين

تكوين الإدخال

apiKey
string
مطلوب
مفتاح واجهة برمجة تطبيقات Dodo Payments من اللوحة.
environment
string
مطلوب
وضع البيئة: test_mode أو live_mode.
eventName
string
مطلوب
اسم الحدث الذي يتطابق مع تكوين العداد الخاص بك.

خيارات تتبع نطاق الوقت

customerId
string
مطلوب
معرّف العميل لنسب الفوترة.
durationMs
number
المدة بالمللي ثانية. استخدمها للدقة الفرعية للثانية.
durationSeconds
number
المدة بالثواني. الأكثر شيوعًا لتنفيذ الدالات والمهام القصيرة.
durationMinutes
number
المدة بالدقائق. مفيد للموارد ذات التشغيل الطويل مثل الآلات الافتراضية.
metadata
object
بيانات وصفية اختيارية حول المورد مثل وحدة المعالجة، الذاكرة، المنطقة، إلخ.

أفضل الممارسات

اختر الوحدة المناسبة: استخدم المللي ثانية للعمليات القصيرة، والثواني للدوال، والدقائق للموارد ذات التشغيل الطويل.
توقيت دقيق: استخدم Date.now() أو performance.now() لتتبع الوقت بدقة، خاصةً للدوال بدون خوادم.