@dodopayments/ingestion-blueprints باسم trackTimeRange().
حالات الاستخدام
تناسب Time Range Blueprint السيناريوهات التالية:Serverless Functions
احتسب الرسوم بناءً على وقت تنفيذ الدالة واستخدام الذاكرة.
Container Runtime
تتبّع وقت تشغيل الحاويات لاحتساب الرسوم المستندة إلى الاستخدام.
Compute Instances
راقب وقت تشغيل VM واحتسب الرسوم بالدقيقة أو الساعة.
Background Jobs
تتبّع وقت معالجة عمليات تصدير البيانات والتقارير والمهام الدفعية.
استخدمها لاحتساب الرسوم مقابل وقت الحوسبة، أو مدة تنفيذ الدوال، أو وقت تشغيل الحاويات، أو أي استخدام آخر يعتمد على الوقت.
البدء السريع
لتتبّع وقت التشغيل، ثبّت الحزمة، وأنشئ مقياسًا، وأرسل المدة في كل مرة ينتهي فيها مورد من التشغيل.1
Install the SDK
ثبّت حزمة Dodo Payments Ingestion Blueprints:
2
Get Your API Keys
أنشئ مفتاح Dodo Payments API ضمن Developer → API Keys في لوحة تحكم Dodo Payments، واحفظه في متغير البيئة
DODO_PAYMENTS_API_KEY. استخدم مفتاح وضع الاختبار أثناء التطوير. يعمل مفتاح وضع الاختبار مع test_mode فقط.3
Create a Meter
في لوحة تحكم Dodo Payments، انتقل إلى Products → Meters وانقر على Create Meter. عيّن الحقول التالية:
- Meter Name: اسم وصفي، مثل
Compute Time. - Event Name:
time_range_usage، أو اسم تختاره. يجب أن يطابقeventNameفي التعليمات البرمجية لديك تمامًا، مع مراعاة حالة الأحرف. تستخدم الأمثلة في الخطوة التالية اسم حدث منفصلًا لكل نوع مورد، مثلfunction_execution، ولذلك يحتاج كل نوع إلى مقياس خاص به. - Aggregation Type: Sum لجمع إجمالي المدة.
- Over Property: مفتاح المدة الذي ترسله:
durationSecondsأوdurationMinutesأوdurationMs. - Measurement Unit: الوحدة الظاهرة في الفواتير، مثل
seconds.
4
Track Time Usage
قِس مدة تشغيل العمل، ثم استدعِ
trackTimeRange() بالمدة وفق الوحدة التي يستخدمها المقياس لديك:الإعدادات
إعدادات الإدخال
مرّر هذه الخيارات إلىnew Ingestion():
string
مطلوب
مفتاح Dodo Payments API من لوحة التحكم.
string
وضع البيئة:
test_mode أو live_mode. القيمة الافتراضية هي test_mode. لكن Dodo Payments SDKs تستخدم live_mode افتراضيًا، لذا اضبط live_mode صراحةً في بيئة الإنتاج.string
مطلوب
اسم الحدث الذي يطابق Event Name للمقياس، مع مراعاة حالة الأحرف.
خيارات Track Time Range
مرّر هذه الخيارات إلىtrackTimeRange(). تُرسل كل مدة تمرّرها كمفتاح metadata بالاسم نفسه.
string
مطلوب
معرّف عميل Dodo Payments الذي ستُحتسب عليه رسوم وقت التشغيل، مثل
cus_123.number
المدة بالميلي ثانية. استخدمها للدقة التي تقل عن ثانية.
number
المدة بالثواني. وهي الأكثر شيوعًا لتنفيذ الدوال والمهام القصيرة.
number
المدة بالدقائق. مفيدة للموارد التي تعمل لفترات طويلة، مثل VM.
object
بيانات metadata اختيارية حول المورد، مثل CPU أو الذاكرة أو المنطقة. يجب أن تكون كل قيمة سلسلة نصية أو رقمًا أو قيمة منطقية.