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

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

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

الوظائف بدون خادم

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

وقت تشغيل الحاوية

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

حالات الحوسبة

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

وظائف الخلفية

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

البدء السريع

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

تثبيت SDK

npm install @dodopayments/ingestion-blueprints
2

احصل على مفاتيح API الخاصة بك

3

إنشاء عداد

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

تتبع استخدام الوقت

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
required
مفتاح API الخاص بك من لوحة معلومات مدفوعات دودي.
environment
string
required
وضع البيئة: test_mode أو live_mode.
eventName
string
required
اسم الحدث الذي يتطابق مع تكوين العداد الخاص بك.

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

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

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

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