المقاييس

​

موارد API

​

إنشاء مقياس

1

Basic Information

​

Meter Name

string

مطلوب

اسم وصفي (مثل “طلبات API”، “استخدام الرموز”)

​

Event Name

string

مطلوب

اسم الحدث الدقيق للمطابقة (حساس لحالة الخط). أمثلة: api.call، image.generated

2

Aggregation

​

Aggregation Type

string

مطلوب

اختر كيفية تجميع الأحداث:

• Count: إجمالي عدد الأحداث (استدعاءات API، التحميلات)
• Sum: جمع القيم الرقمية (الرموز، البايتات)
• Max: أعلى قيمة في الفترة (أعلى عدد مستخدمين)
• Last: أحدث قيمة

​

Over Property

string

مفتاح البيانات الوصفية للتجميع (مطلوب لجميع الأنواع ما عدا Count). أمثلة: tokens، bytes، duration_ms

​

Measurement Unit

string

مطلوب

تسمية الوحدة للفواتير. أمثلة: calls، tokens، GB، hours

3

Filtering (Optional)

أضف شروطاً لتصفية الأحداث التي يتم احتسابها:

• منطق AND: يجب أن تتطابق جميع الشروط
• منطق OR: يمكن أن تتطابق أي شرط

المقارنات: يساوي، لا يساوي، أكبر من، أقل من، يحتوي علىفعّل التصفية، اختر المنطق، أضف شروطًا بمفتاح الخاصية والمقارن والقيمة.

4

Create

راجع التكوين واضغط Create Meter.

​

عرض التحليلات

• نظرة عامة: إجمالي الاستخدام ومخطط الاستخدام
• الأحداث: الأحداث الفردية المستلمة
• العملاء: الاستخدام والرسوم لكل عميل

​

الفوترة بالاعتمادات بدلاً من العملات

​

متى تستخدم الخصم المستند إلى الاعتمادات

​

تكوين عداد لخصم الاعتمادات

1

Create a Credit Entitlement

ابدأ بإنشاء اعتماد في Products → Credits. عرّف الوحدة (مثل “API Calls”، “Tokens”), الدقة، وإعدادات دورة الحياة (انتهاء الصلاحية، الترحيل، التجاوز).اطّلع على دليل الفوترة المستندة إلى الاعتمادات للحصول على تعليمات مفصلة.

2

Create or Edit a Usage-Based Product

اذهب إلى منتجك المستند إلى الاستخدام وافتح قسم تكوين Meter.

3

Add a Meter

انقر على زر + لإرفاق عداد. قم بتكوين اسم الحدث، نوع التجميع، ووحدة القياس كالمعتاد.

4

Enable 'Bill Usage in Credits'

فعّل خاصية Bill usage in Credits في تكوين العداد. سيُظهر هذا إعدادات الاعتماد التالية:

​

Credit Entitlement

string

مطلوب

حدد أي أهلية اعتماد يجب أن يخصم منها هذا العداد.

​

Meter units per credit

number

مطلوب

عدد وحدات الاستخدام المطلوبة لخصم اعتماد واحد. على سبيل المثال:

• 1 = كل حدث عداد يخصم اعتمادًا واحدًا
• 100 = 100 حدث عداد يخصمان اعتمادًا واحدًا
• 1000 = 1,000 مكالمة API تستهلك اعتمادًا واحدًا

5

Set the Free Threshold

ما زال الحد المجاني ساريًا - الأحداث التي تقع تحت هذا الحد لا تخصم اعتمادات.مثال: مع حد مجاني قدره 1,000 ووحدات العداد لكل اعتماد تساوي 1:

• يستخدم العميل 2,500 مكالمة API
• أول 1,000 مجانية
• يتم خصم 1,500 اعتماد من رصيدهم

​

كيف يعمل خصم الاعتمادات

1. وصول الأحداث - يرسل تطبيقك أحداث الاستخدام عبر Event Ingestion API
2. تجميع العداد - تُجمّع الأحداث وفقًا لتكوين العداد (Count, Sum, Max, Last)
3. معالجة عامل الخلفية - كل دقيقة، يسترجع العامل الأحداث الجديدة منذ آخر نقطة تحقق
4. يتم خصم الاعتمادات - يتم تحويل الاستخدام المجمع إلى اعتمادات باستخدام معدل meter_units_per_credit ويُخصم باستخدام ترتيب FIFO (تُستهلك المنح الأقدم أولاً)
5. تتبع التجاوز - إذا وصل الرصيد إلى الصفر وتم تفعيل التجاوز، يستمر الاستخدام ويتم التعامل مع التجاوز وفق السلوك المُكوَّن (يُسامح عند إعادة التعيين، يُفوترة في الفاتورة التالية، أو يُحمل كعجز)

​

عدة عدادات، مجموعة اعتماد واحدة

• text.generation - اعتماد واحد لكل 1,000 رمز
• image.generation - 10 اعتمادات لكل صورة

​

استكشاف الأخطاء وإصلاحها

​

الخطوات التالية