إرسال قياسات مخصصة
ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات
يرسل نهج emit-metric مقاييس مخصصة بالتنسيق المحدد إلى Application Insights.
إشعار
تعيين عناصر النهج والعناصر التابعة بالترتيب الوارد في بيان النهج. تعلم كيفية إعداد نُهج APIM أو تعديلها.
حدود المقاييس المخصصة
يفرض Azure Monitor حدود استخدام للمقاييس المخصصة التي قد تؤثر على قدرتك على إصدار مقاييس من APIM. على سبيل المثال، يعين Azure Monitor حاليا حدا قدره 10 مفاتيح أبعاد لكل مقياس، وحدود 50000 سلسلة زمنية نشطة إجمالية لكل منطقة في اشتراك (خلال فترة 12 ساعة).
هذه الحدود لها الآثار التالية لتكوين مقاييس مخصصة في نهج إدارة واجهة برمجة التطبيقات مثل emit-metric أو azure-openai-emit-token-metric:
يمكنك تكوين 10 أبعاد مخصصة كحد أقصى لكل نهج.
عدد السلاسل الزمنية النشطة التي تم إنشاؤها بواسطة النهج خلال فترة 12 ساعة هو نتاج عدد القيم الفريدة لكل بعد تم تكوينه خلال الفترة. على سبيل المثال، إذا تم تكوين ثلاثة أبعاد مخصصة في النهج، وكان لكل بعد 10 قيم محتملة خلال الفترة، فإن النهج سيساهم بسلسلة زمنية نشطة 1000 (10 × 10 × 10).
إذا قمت بتكوين النهج في مثيلات APIM متعددة موجودة في نفس المنطقة في اشتراك، يمكن لجميع المثيلات المساهمة في حد السلاسل الزمنية النشطة الإقليمية.
تعرف على المزيد حول قيود التصميم واعتبارات المقاييس المخصصة في Azure Monitor.
المتطلبات الأساسية
- يجب دمج مثيل APIM الخاص بك مع Application insights. لمزيد من المعلومات، راجع كيفية تكامل Azure API Management مع Azure Application Insights.
- تمكين تسجيل Application Insights لواجهات برمجة التطبيقات الخاصة بك.
- تمكين المقاييس المخصصة ذات الأبعاد في Application Insights. لمزيد من المعلومات، راجع إرسال مقاييس مخصصة.
نهج السياسة
<emit-metric name="name of custom metric" value="value of custom metric" namespace="metric namespace">
<dimension name="dimension name" value="dimension value" />
</emit-metric>
سمات
| السمة | الوصف | مطلوب | القيمة الافتراضية |
|---|---|---|---|
| الاسم | سلسلة. اسم المقياس المخصص. تعبيرات النهج غير مسموح بها. | نعم | غير متوفر |
| مساحة الاسم | سلسلة. مساحة الاسم للمقياس المخصص. تعبيرات النهج غير مسموح بها. | لا | API Management |
| قيمة | قيمة المقياس المخصص المعبر عنها كمضاعفة. يتم السماح بتعبيرات النهج. | لا | 1 |
عناصر
| العنصر | الوصف | مطلوب |
|---|---|---|
| البُعد | أضف عنصراً واحداً أو أكثر من هذه العناصر لكل بعد مضمن في المقياس المخصص. | نعم |
سمات البعد
| السمة | الوصف | مطلوب | القيمة الافتراضية |
|---|---|---|---|
| الاسم | سلسلة أو تعبير نهج. اسم البعد. | نعم | غير متوفر |
| قيمة | سلسلة أو تعبير نهج. قيمة البعد. يمكن حذفها فقط إذا name تطابق مع أحد الأبعاد الافتراضية. إذا كان الأمر كذلك، يتم توفير القيمة حسب اسم البعد. |
لا | غير متاح |
أسماء الأبعاد الافتراضية التي يمكن استخدامها بدون قيمة
- معرف واجهة برمجة التطبيقات
- معرف العملية
- معرف المنتج
- معرِف المستخدم
- مُعرّف الاشتراك
- الموقع
- معرف البوابة
الاستخدام
- أقسام النهج: واردة وصادرة وخلفية وعند الخطأ
- نطاقات النهج: العمومية، ومساحة العمل، والمنتج، وواجهة برمجة التطبيقات، والتشغيل
- البوابات: الكلاسيكية، الإصدار 2، الاستهلاك، المستضافة ذاتيا، مساحة العمل
ملاحظات الاستخدام
- يمكنك تكوين 10 أبعاد مخصصة على الأكثر لهذا النهج.
مثال
يرسل المثال التالي مقياسا مخصصا لحساب عدد طلبات واجهة برمجة التطبيقات مع معرف واجهة برمجة التطبيقات كبعد مخصص.
<policies>
<inbound>
<emit-metric name="Request" value="1" namespace="my-metrics">
<dimension name="API ID" />
</emit-metric>
</inbound>
<outbound>
</outbound>
</policies>
النهج ذات الصلة
المحتوى ذو الصلة
لمزيد من المعلومات حول العمل مع النُهج، راجع: