مشاركة عبر

تسجيل الدخول إلى مركز الأحداث

  • مقالة

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

log-to-eventhub يرسل النهج رسائل بالتنسيق المحدد إلى مركز أحداث محدد بواسطة كيان مسجل. كما يوحي اسمها، يتم استخدام النَهج لحفظ معلومات سياق الطلب أو الاستجابة المحددة للتحليل عبر الإنترنت أو دون اتصال بالإنترنت.

إشعار

للحصول على دليل تفصيلي حول تكوين مركز الأحداث وتسجيل الأحداث، راجع كيفية تسجيل أحداث API Management باستخدام Azure Event Hubs.

إشعار

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

نهج السياسة

<log-to-eventhub logger-id="id of the logger entity" partition-id="index of the partition where messages are sent" partition-key="value used for partition assignment">
  Expression returning a string to be logged
</log-to-eventhub>

سمات

السمة ‏‏الوصف مطلوبة افتراضي
معرف المسجل معرف المسجل الذي تم تسجيله مع خدمة API Management. تعبيرات النهج غير مسموح بها. ‏‏نعم‬ غير متوفر
معرف القسم تحديد فهرس القسم الذي يتم إرسال الرسائل إليه. تعبيرات النهج غير مسموح بها. اختياري. لا تستخدم إذا partition-key تم استخدامه. ‏‫غير متوفر‬
مفتاح القسم تحديد القيمة المستخدمة لتعيين القسم عند إرسال الرسائل. يتم السماح بتعبيرات النهج. اختياري. لا تستخدم إذا partition-id تم استخدامه. ‏‫غير متوفر‬

الاستخدام

  • أقسام النهج: واردة وصادرة وخلفية وعند الخطأ
  • نطاقات النهج: العمومية، ومساحة العمل، والمنتج، وواجهة برمجة التطبيقات، والتشغيل
  • البوابات: الكلاسيكية، الإصدار 2، الاستهلاك، المستضافة ذاتيا

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

  • لا يتأثر النهج بأخذ عينات Application Insights. سيتم تسجيل جميع استدعاءات النهج.
  • الحد الأقصى لحجم الرسالة المدعومة التي يمكن إرسالها إلى مركز أحداث من هذا النهج هو 200 كيلوبايت (كيلوبايت). سيتم اقتطاع رسالة أكبر تلقائيا إلى 200 كيلوبايت قبل النقل إلى مركز أحداث.

مثال

يمكن استخدام أي سلسلة كقيمة للتسجيل في مركز الأحداث. في هذا المثال، يتم تسجيل التاريخ والوقت واسم خدمة النشر ومعرف الطلب وعنوان IP واسم العملية لجميع المكالمات الواردة إلى مسجل مركز الحدث المسجل بالمعرف contoso-logger .

<policies>
  <inbound>
    <log-to-eventhub logger-id ='contoso-logger'>
      @( string.Join(",", DateTime.UtcNow, context.Deployment.ServiceName, context.RequestId, context.Request.IpAddress, context.Operation.Name) )
    </log-to-eventhub>
  </inbound>
  <outbound>
  </outbound>
</policies>

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

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