مشاركة عبر

إرسال قياسات مخصصة

  • مقالة

ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات

يرسل نهج emit-metric مقاييس مخصصة بالتنسيق المحدد إلى Application Insights.

إشعار

إشعار

تعيين عناصر النهج والعناصر التابعة بالترتيب الوارد في بيان النهج. تعلم كيفية إعداد نُهج APIM أو تعديلها.

نهج السياسة

<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 أبعاد مخصصة على الأكثر لهذا النهج.

  • يعد استدعاء النهج emit-metric نحو حدود الاستخدام للمقاييس المخصصة لكل منطقة في الاشتراك. معرفة المزيد

مثال

يرسل المثال التالي مقياساً مخصصاً لحساب عدد طلبات API مع معرف المستخدم وعنوان IP للعميل ومعرف API كأبعاد مخصصة.

<policies>
  <inbound>
    <emit-metric name="Request" value="1" namespace="my-metrics"> 
        <dimension name="User ID" /> 
        <dimension name="Client IP" value="@(context.Request.IpAddress)" /> 
        <dimension name="API ID" /> 
    </emit-metric> 
  </inbound>
  <outbound>
  </outbound>
</policies>

المحتوى ذو الصلة

لمزيد من المعلومات حول العمل مع النُهج، راجع: