مراقبة مرجع بيانات Azure Event Hubs
راجع مراقبة Azure Event Hubs للحصول على تفاصيل حول جمع بيانات المراقبة وتحليلها إلى Azure Event Hubs.
إشعار
لا يتضمن Azure Monitor الأبعاد في بيانات المقاييس المُصدَّرة المُرسلة إلى وجهة مثل Azure Storage ومراكز أحداث Azure وLog Analytics وما إلى ذلك.
المقاييس
يسرد هذا القسم جميع مقاييس المنصة المُجمعة تلقائيًا لـ Azure .Event Hubs يكون موفر الموارد لهذه المقاييس هو Microsoft.EventHub/المجموعات أو Microsoft.EventHub/namespaces.
طلب المقاييس
تحسب عدد طلبات البيانات وبيانات التشغيل.
| اسم المقياس | قابل للتصدير عبر إعدادات التشخيص | الوحدة | نوع التجميع | الوصف | الأبعاد |
|---|---|---|---|---|---|
| الطلبات الواردة | نعم | عدد | عدد | عدد الطلبات المقدمة إلى خدمة Event Hubs خلال فترة زمنية محددة. يتضمن هذا المقياس جميع البيانات وعمليات وحدة الإدارة. | اسم الكيان |
| الطلبات الناجحة | لا | عدد | عدد | عدد الطلبات الناجحة المقدمة إلى Event Husbs Service خلال فترة زمنية محددة. | اسم الكيان نتيجة العملية |
| الطلبات المخنوقة | لا | عدد | عدد | عدد الطلبات المقيدة بسبب تجاوز الاستخدام. | اسم الكيان نتيجة العملية |
يتم تصنيف النوعين التاليين من الأخطاء على أنهما أخطاء مستخدم:
- أخطاء من جانب العميل (في HTTP التي قد تكون 400 خطأ).
- الأخطاء التي تحدث أثناء معالجة الرسائل.
مقاييس الرسالة
| اسم المقياس | قابل للتصدير عبر إعدادات التشخيص | الوحدة | نوع التجميع | الوصف | الأبعاد |
|---|---|---|---|---|---|
| رسائل واردة | نعم | عدد | عدد | عدد الأحداث أو الرسائل المرسلة إلى Event Hubs خلال فترة زمنية محددة. | اسم الكيان |
| الرسائل الصادرة | نعم | عدد | عدد | عدد الأحداث أو الرسائل المستلمة من Event Hubs خلال فترة زمنية مُحددة. | اسم الكيان |
| الرسائل الملتقطة | لا | عدد | عدد | عدد الرسائل الملتقطة. | اسم الكيان |
| وحدات البايت الواردة | نعم | بايت | عدد | وحدات البايت الواردة لمركز حدث خلال فترة محددة. | اسم الكيان |
| وحدات البايت الصادرة | نعم | بايت | عدد | وحدات البايت الصادرة لمركز حدث خلال فترة محددة. | اسم الكيان |
| الحجم | لا | بايت | المتوسط | حجم مركز الحدث بالبايت. | اسم الكيان |
إشعار
- هذه القيم هي قيم في نقطة زمنية. قد لا تنعكس الرسائل الواردة المستهلكة مباشرة بعد تلك النقطة الزمنية في هذه المقاييس.
- يتضمن مقياس الطلبات الواردة جميع البيانات وعمليات وحدة الإدارة. يمنحك مقياس الرسائل الواردة إجمالي عدد الأحداث المُرسلة إلى مركز الأحداث. على سبيل المثال، إذا أرسلت دُفعة من 100 حدث إلى مركز أحداث، فسوف يتم احتسابها على أنها طلب وارد واحد و100 رسالة واردة.
المقاييس الملتقطة
| اسم المقياس | قابل للتصدير عبر إعدادات التشخيص | الوحدة | نوع التجميع | الوصف | الأبعاد |
|---|---|---|---|---|---|
| الرسائل الملتقطة | لا | عدد | عدد | عدد الرسائل الملتقطة. | اسم الكيان |
| وحدات البايت الملتقطة | لا | بايت | عدد | وحدات البايت المُلتقطة لمركز أحداث | اسم الكيان |
| التقاط تراكم | لا | عدد | عدد | التقاط التراكم لمركز أحداث | اسم الكيان |
مقاييس الاتصال
| اسم المقياس | قابل للتصدير عبر إعدادات التشخيص | الوحدة | نوع التجميع | الوصف | الأبعاد |
|---|---|---|---|---|---|
| الاتصال النشطة | لا | عدد | المتوسط | عدد الاتصالات النشطة في مساحة الاسم وعلى أحد الكيانات (مركز الحدث) في مساحة الاسم. قيمة هذا المقياس هي قيمة نقطة زمنية. قد لا تنعكس الاتصالات التي كانت نشطة مباشرة بعد هذه النقطة الزمنية في المقياس. | اسم الكيان |
| الاتصالات المفتوحة | لا | عدد | المتوسط | عدد الاتصالات المفتوحة. | اسم الكيان |
| الاتصالات المغلقة | لا | عدد | المتوسط | عدد الاتصالات المغلقة. | اسم الكيان |
مقاييس الخطأ
| اسم المقياس | قابل للتصدير عبر إعدادات التشخيص | الوحدة | نوع التجميع | الوصف | الأبعاد |
|---|---|---|---|---|---|
| أخطاء الخادم | لا | عدد | عدد | عدد الطلبات غير المُعالجة بسبب خطأ في خدمة Event Hubs خلال فترة زمنية مُحددة. | اسم الكيان نتيجة العملية |
| أخطاء المستخدم | لا | عدد | عدد | عدد الطلبات التي لم يتم معالجتها بسبب أخطاء المستخدم خلال فترة محددة. | اسم الكيان نتيجة العملية |
| تجاوزت الحصة أخطاء | لا | عدد | عدد | عدد الأخطاء الناتجة عن تجاوز الحصص النسبية خلال فترة محددة. | اسم الكيان نتيجة العملية |
إشعار
تُنشأ تطبيقات المنطق مستقبلات فترة ويمكن نقل أجهزة الاستقبال من عقدة إلى أخرى اعتمادًا على حمل الخدمة. أثناء هذه التحركات، ReceiverDisconnection قد تحدث استثناءات. يتم حسابها كأخطاء مستخدم على جانب خدمة Event Hubs. قد تجمع تطبيقات المنطق حالات الفشل من عملاء Event Hubs حيث يمكنك عرضها في سجلات المستخدمين.
أبعاد المقاييس
يدعم Azure Event Hubs الأبعاد التالية للمقاييس في Azure Monitor. تعد إضافة أبعاد إلى مقاييسك أمرًا اختياريًا. إذا لم تضف أبعادًا، تُحدد المقاييس على مستوى مساحة الاسم.
| اسم البعد | الوصف |
|---|---|
| اسم الكيان | اسم Event Hub. باستخدام مقياس "الطلبات الواردة"، يحتوي بعد Entity Name على قيمة "-NamespaceOnlyMetric-" بالإضافة إلى جميع مراكز الأحداث الخاصة بك. يمثل الطلبات التي تم إجراؤها على مستوى مساحة الاسم. تتضمن الأمثلة طلب سرد كافة مراكز الأحداث في مساحة الاسم أو الطلبات إلى الكيانات التي فشلت المصادقة أو التخويل. |
سجلات الموارد
لدى Azure Event Hubs الآن القدرة على إرسال السجلات إلى أي من جدولي الوجهة - Azure Diagnostic أو جداول الموارد المحددة في Log Analytics. يمكنك استخدام التبديل المتوفر على مدخل Microsoft Azure لاختيار جداول الوجهة.
تقوم مراكز الأحداث بالتقاط سجلات التشخيص للفئات التالية:
| الفئة | الوصف |
|---|---|
| أرشيف السجلات | يلتقط معلومات حول عمليات التقاط مراكز الأحداث، على وجه التحديد، السجلات المتعلقة بالتقاط الأخطاء. |
| سجلات التشغيل | التقط جميع عمليات الإدارة التي يتم إجراؤها على مساحة الاسم مراكز الأحداث من Azure. لا يتم تسجيل عمليات البيانات، بسبب الحجم الكبير لعمليات البيانات التي يتم إجراؤها في مراكز الأحداث من Azure. |
| سجلات مقياس الحركة | يلتقط عمليات الملء التلقائي التي تم إجراؤها على مساحة اسم مراكز الأحداث. |
| سجلات منسق Kafka | يلتقط عمليات منسق Kafka المتعلقة بمراكز الأحداث. |
| سجلات أخطاء مستخدم Kafka | يلتقط معلومات حول واجهات برمجة تطبيقات Kafka التي يتم استدعاؤها في مراكز الأحداث. |
| حدث اتصال الشبكة الظاهرية لمراكز الأحداث | يلتقط معلومات حول عناوين IP والشبكات الافتراضية التي ترسل حركة الانتقال إلى مراكز الأحداث. |
| سجلات المستخدم الرئيسية التي يديرها العميل | يلتقط العمليات المتعلقة بالمفتاح المُدار بواسطة العميل. |
| سجلات تدقيق وقت التشغيل | التقاط معلومات التشخيص المجمعة لجميع عمليات الوصول إلى مستوى البيانات (مثل إرسال الأحداث أو تلقيها) في مراكز الأحداث. |
| سجلات قياس التطبيق | التقاط المعلومات المجمعة حول مقاييس معينة تتعلق بعمليات مستوى البيانات. |
يتم تخزين جميع السجلات بتنسيق JavaScript Object Notation (JSON). يحتوي كل إدخال على حقول سلسلة تستخدم التنسيق الموضح في الأقسام التالية.
أرشيف مخطط السجلات
تتضمن سلاسل JSON لسجل الأرشيف العناصر المدرجة في الجدول التالي:
| Name | الوصف | مدعوم في تشخيصات Azure | مدعوم في AZMSArchiveLogs (جدول خاص بالموارد) |
|---|---|---|---|
TaskName |
وصف المهمة التي فشلت | نعم | نعم |
ActivityId |
معرف داخلي، يستخدم للتتبع | نعم | نعم |
trackingId |
معرف داخلي، يستخدم للتتبع | نعم | نعم |
resourceId |
معرف مورد Azure Resource Manager | yes | نعم |
eventHub |
الاسم الكامل لمركز الأحداث (يتضمن اسم مساحة الاسم) | نعم | لا |
EventhubName |
اسم كيان مركز الحدث | لا | نعم |
partitionId |
قسم مركز الأحداث الذي تتم كتابته إلى | نعم | نعم |
archiveStep |
القيم الممكنة:ArchiveFlushWriter, DestinationInit | نعم | نعم |
startTime |
وقت بدء الفشل | نعم | لا |
Time Generated (UTC) |
الطابع الزمني للعملية | لا | نعم |
failures |
عدد مرات حدوث الفشل | نعم | نعم |
durationInSeconds |
مدة الفشل | نعم | نعم |
message |
رسالة الخطأ | نعم | نعم |
category |
فئة السجل | نعم | لا |
Provider |
اسم الخدمة التي تنبعث منها السجلات، على سبيل المثال، مراكز الأحداث | لا | نعم |
Type |
نوع السجل المنبعث | لا | نعم |
الكود التالي هو مثال على سلسلة JSON لسجل الأرشيف:
تشخيصات Azure:
{
"TaskName": "EventHubArchiveUserError",
"ActivityId": "000000000-0000-0000-0000-0000000000000",
"trackingId": "0000000-0000-0000-0000-00000000000000000",
"resourceId": "/SUBSCRIPTIONS/000000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs Namespace Name>",
"eventHub": "<Event Hub full name>",
"partitionId": "1",
"archiveStep": "ArchiveFlushWriter",
"startTime": "9/22/2016 5:11:21 AM",
"failures": 3,
"durationInSeconds": 360,
"message": "Microsoft.WindowsAzure.Storage.StorageException: The remote server returned an error: (404) Not Found. ---> System.Net.WebException: The remote server returned an error: (404) Not Found.\r\n at Microsoft.WindowsAzure.Storage.Shared.Protocol.HttpResponseParsers.ProcessExpectedStatusCodeNoException[T](HttpStatusCode expectedStatusCode, HttpStatusCode actualStatusCode, T retVal, StorageCommandBase`1 cmd, Exception ex)\r\n at Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob.<PutBlockImpl>b__3e(RESTCommand`1 cmd, HttpWebResponse resp, Exception ex, OperationContext ctx)\r\n at Microsoft.WindowsAzure.Storage.Core.Executor.Executor.EndGetResponse[T](IAsyncResult getResponseResult)\r\n --- End of inner exception stack trace ---\r\n at Microsoft.WindowsAzure.Storage.Core.Util.StorageAsyncResult`1.End()\r\n at Microsoft.WindowsAzure.Storage.Core.Util.AsyncExtensions.<>c__DisplayClass4.<CreateCallbackVoid>b__3(IAsyncResult ar)\r\n--- End of stack trace from previous location where exception was thrown ---\r\n at System.",
"category": "ArchiveLogs"
}
إدخال جدول خاص بالموارد:
{
"TaskName": "EventHubArchiveUserError",
"ActivityId": "000000000-0000-0000-0000-0000000000000",
"trackingId": "0000000-0000-0000-0000-00000000000000000",
"resourceId": "/SUBSCRIPTIONS/000000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs Namespace Name>",
"EventHubName": "<Event Hub full name>",
"partitionId": "1",
"archiveStep": "ArchiveFlushWriter",
"TimeGenerated(UTC)": "9/22/2016 5:11:21 AM",
"failures": 3,
"durationInSeconds": 360,
"message": "Microsoft.WindowsAzure.Storage.StorageException: The remote server returned an error: (404) Not Found. ---> System.Net.WebException: The remote server returned an error: (404) Not Found.\r\n at Microsoft.WindowsAzure.Storage.Shared.Protocol.HttpResponseParsers.ProcessExpectedStatusCodeNoException[T](HttpStatusCode expectedStatusCode, HttpStatusCode actualStatusCode, T retVal, StorageCommandBase`1 cmd, Exception ex)\r\n at Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob.<PutBlockImpl>b__3e(RESTCommand`1 cmd, HttpWebResponse resp, Exception ex, OperationContext ctx)\r\n at Microsoft.WindowsAzure.Storage.Core.Executor.Executor.EndGetResponse[T](IAsyncResult getResponseResult)\r\n --- End of inner exception stack trace ---\r\n at Microsoft.WindowsAzure.Storage.Core.Util.StorageAsyncResult`1.End()\r\n at Microsoft.WindowsAzure.Storage.Core.Util.AsyncExtensions.<>c__DisplayClass4.<CreateCallbackVoid>b__3(IAsyncResult ar)\r\n--- End of stack trace from previous location where exception was thrown ---\r\n at System.",
"Provider":"EVENTHUB",
"Type":"AZMSArchiveLogs"
}
مخطط السجلات التشغيلية
تتضمن سلاسل السجل التشغيلي JSON العناصر المدرجة في الجدول التالي:
| Name | الوصف | مدعوم في AzureDiagnostics | مدعوم في AZMSOperationalLogs (جدول خاص بالموارد) |
|---|---|---|---|
ActivityId |
معرف داخلي، يستخدم لأغراض التتبع | نعم | نعم |
EventName |
اسم العملية. للحصول على قائمة بالقيم لهذا العنصر، راجع أسماء الأحداث | نعم | نعم |
resourceId |
معرف مورد Azure Resource Manager | نعم | نعم |
SubscriptionId |
مُعرّف الاشتراك | نعم | نعم |
EventTimeString |
وقت العملية | نعم | لا |
Time Generated (UTC) |
الطابع الزمني للعملية | لا | نعم |
EventProperties |
خصائص العملية. يوفر هذا العنصر مزيداً من المعلومات حول الأحداث كما هو موضح في المثال التالي. | نعم | نعم |
Status |
حالة العملية. يمكن أن تكون القيمة إما ناجحة أو فاشلة. | نعم | نعم |
Caller |
طلب العملية (بوابة Azure أو عميل الإدارة) | نعم | نعم |
Category |
فئة السجل | نعم | لا |
Provider |
اسم الخدمة التي تنبعث منها السجلات، على سبيل المثال، مراكز الأحداث | لا | نعم |
Type |
نوع السجلات المنبعثة | لا | نعم |
الكود التالي هو مثال على سلسلة JSON للسجل التشغيلي:
تشخيصات Azure:
Example:
{
"ActivityId": "00000000-0000-0000-0000-00000000000000",
"EventName": "Create EventHub",
"resourceId": "/SUBSCRIPTIONS/00000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace name>",
"SubscriptionId": "000000000-0000-0000-0000-000000000000",
"EventTimeString": "9/28/2016 8:40:06 PM +00:00",
"EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-000000000000\",\"Namespace\":\"<Namespace Name>\",\"Via\":\"https://<Namespace Name>.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
"Status": "Succeeded",
"Caller": "ServiceBus Client",
"category": "OperationalLogs"
}
إدخال جدول خاص بالموارد:
Example:
{
"ActivityId": "00000000-0000-0000-0000-00000000000000",
"EventName": "Create EventHub",
"resourceId": "/SUBSCRIPTIONS/00000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace name>",
"SubscriptionId": "000000000-0000-0000-0000-000000000000",
"TimeGenerated (UTC)": "9/28/2016 8:40:06 PM +00:00",
"EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-000000000000\",\"Namespace\":\"<Namespace Name>\",\"Via\":\"https://<Namespace Name>.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
"Status": "Succeeded",
"Caller": "ServiceBus Client",
"Provider": "EVENTHUB",
"Type":"AZMSOperationalLogs"
}
أسماء الأحداث
يتم ملء اسم الأحداث كنوع العملية + نوع المورد من التعدادات التالية. على سبيل المثال، أو Create QueueRetrieve Event Hubأو .Delete Rule
| نوع العملية | نوع المورد |
|---|---|
| - إنشاء -تحديث - حذف -استرداد - غير معروف |
-مساحه الاسم -قائمه انتظار -الموضوع -الاشتراك - مراكز الأحداث - SharedAccessPolicy - UsageCredit -القاعده - مجموعة المستهلكين |
مخطط سجلات القياس التلقائي
يتضمن سجل القياس التلقائي JSON العناصر المدرجة في الجدول التالي:
| Name | الوصف | مدعوم في تشخيصات Azure | مدعوم في AZMSAutoscaleLogs (جدول خاص بالموارد) |
|---|---|---|---|
TrackingId |
المعرف الداخلي، والذي يستخدم لأغراض التعقب | نعم | نعم |
ResourceId |
معرف مورد Azure Resource Manager. | نعم | نعم |
Message |
رسالة إعلامية، توفر تفاصيل حول إجراء الملء التلقائي. تحتوي الرسالة على القيمة السابقة والحالية لوحدة الإنتاجية لمساحة اسم معينة وما تسبب في تضخم TU. | نعم | نعم |
Time Generated (UTC) |
الطابع الزمني للعملية | لا | نعم |
Provider |
اسم الخدمة التي تنبعث منها السجلات، على سبيل المثال، مراكز الأحداث | لا | نعم |
Type |
نوع السجلات المنبعثة | لا | نعم |
إليك مثال على حدث مقياس تلقائي:
تشخيصات Azure:
{
"TrackingId": "fb1b3676-bb2d-4b17-85b7-be1c7aa1967e",
"Message": "Scaled-up EventHub TUs (UpdateStartTimeUTC: 5/13/2021 7:48:36 AM, PreviousValue: 1, UpdatedThroughputUnitValue: 2, AutoScaleReason: 'IncomingMessagesPerSecond reached 2170')",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name"
}
إدخال جدول خاص بالموارد:
{
"TrackingId": "fb1b3676-bb2d-4b17-85b7-be1c7aa1967e",
"Message": "Scaled-up EventHub TUs (UpdateStartTimeUTC: 5/13/2021 7:48:36 AM, PreviousValue: 1, UpdatedThroughputUnitValue: 2, AutoScaleReason: 'IncomingMessagesPerSecond reached 2170')",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
"timeGenerated (UTC) : "9/28/2022 8:40:06 PM +00:00",
"Provider" : "EVENTHUB",
"Type" : "AZMSAutoscaleLogs"
}
مخطط سجلات منسق Kafka
يتضمن سجل منسق Kafka JSON العناصر المدرجة في الجدول التالي:
| Name | الوصف | مدعوم في تشخيصات Azure | مدعوم في AZMSKafkaCoordinatorLogs (جدول خاص بالموارد) |
|---|---|---|---|
RequestId |
معرف الطلب، والذي يستخدم لأغراض التتبع | نعم | نعم |
ResourceId |
معرف مورد Azure Resource Manager | نعم | نعم |
Operation |
اسم العملية التي تم إجراؤها أثناء تنسيق المجموعة | نعم | نعم |
ClientId |
معرف العميل | نعم | نعم |
NamespaceName |
اسم مساحة الاسم | نعم | نعم |
SubscriptionId |
مُعرف اشتراكك في Azure | نعم | نعم |
Message |
رسالة إعلامية أو تحذير، والتي توفر تفاصيل حول الإجراءات التي تم القيام بها أثناء تنسيق المجموعة. | نعم | نعم |
Time Generated (UTC) |
الطابع الزمني للعملية | لا | نعم |
Provider |
اسم الخدمة التي تنبعث منها السجلات، على سبيل المثال، ServiceBus | لا | نعم |
Type |
نوع السجل المنبعث | لا | نعم |
مثال
تشخيصات Azure:
{
"RequestId": "FE01001A89E30B020000000304620E2A_KafkaExampleConsumer#0",
"Operation": "Join.Start",
"ClientId": "KafkaExampleConsumer#0",
"Message": "Start join group for new member namespace-name:c:$default:I:KafkaExampleConsumer#0-cc40856f7f3c4607915a571efe994e82, current group size: 0, API version: 2, session timeout: 10000ms, rebalance timeout: 300000ms.",
"SubscriptionId": "0000000-0000-0000-0000-000000000000",
"NamespaceName": "namespace-name",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
"Category": "KafkaCoordinatorLogs"
}
إدخال جدول خاص بالموارد:
{
"RequestId": "FE01001A89E30B020000000304620E2A_KafkaExampleConsumer#0",
"Operation": "Join.Start",
"ClientId": "KafkaExampleConsumer#0",
"Message": "Start join group for new member namespace-name:c:$default:I:KafkaExampleConsumer#0-cc40856f7f3c4607915a571efe994e82, current group size: 0, API version: 2, session timeout: 10000ms, rebalance timeout: 300000ms.",
"SubscriptionId": "0000000-0000-0000-0000-000000000000",
"NamespaceName": "namespace-name",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
"Time Generated (UTC) ": "9/28/2022 8:40:06 PM +00:00",
"Provider" : "EVENTHUB",
"Type" : "AZMSKafkaCoordinatorLogs"
}
مخطط سجلات أخطاء مستخدم Kafka
يتضمن سجل أخطاء مستخدم Kafka JSON العناصر المدرجة في الجدول التالي:
| Name | الوصف | مدعوم في تشخيصات Azure | مدعوم في AZMSKafkaUserErrorLogs (جدول خاص بالموارد) |
|---|---|---|---|
TrackingId |
معرف التتبع، والذي يستخدم لأغراض التعقب. | نعم | نعم |
NamespaceName |
اسم مساحة الاسم | نعم | نعم |
Eventhub |
اسم Event Hub | نعم | نعم |
PartitionId |
معرف القسم | نعم | نعم |
GroupId |
معرف مجموعة | نعم | نعم |
ClientId |
معرف العميل | نعم | نعم |
ResourceId |
معرف مورد Azure Resource Manager. | نعم | نعم |
Message |
رسالة إعلامية توفر تفاصيل حول أحد الأخطاء | نعم | نعم |
TimeGenerated (UTC) |
الطابع الزمني للعملية المنفذة | لا | نعم |
Provider |
اسم الخدمة التي تنبعث منها السجلات، على سبيل المثال، مراكز الأحداث | لا | نعم |
Type |
نوع السجل المنبعث | لا | نعم |
مراكز الأحداث مخطط حدث اتصال الشبكة الافتراضية
يتضمن حدث اتصال الشبكة الظاهرية لمراكز الأحداث (الشبكة الظاهرية) JSON العناصر المدرجة في الجدول التالي:
| Name | الوصف | مدعوم في تشخيصات Azure | مدعوم في AZMSVNet الاتصال ionevents (جدول خاص بالموارد) |
|---|---|---|---|
SubscriptionId |
مُعرف اشتراكك في Azure | نعم | نعم |
NamespaceName |
اسم مساحة الاسم | نعم | نعم |
IPAddress |
عنوان IP لعميل متصل بخدمة مراكز الأحداث | نعم | نعم |
Action |
الإجراء الذي تم اتخاذه بواسطة خدمة مراكز الأحداث عند تقييم طلبات الاتصال. الإجراءات المدعومة هي قبول الاتصال ورفض الاتصال. | نعم | نعم |
Reason |
يقدم سبباً لتنفيذ الإجراء | نعم | لا |
Message |
يقدم سبباً لتنفيذ الإجراء | لا | نعم |
Count |
عدد مرات حدوث الإجراء المحدد | نعم | نعم |
ResourceId |
معرف مورد Azure Resource Manager. | نعم | نعم |
Time Generated (UTC) |
الطابع الزمني للعملية | لا | نعم |
Provider |
اسم الخدمة التي تنبعث منها السجلات، على سبيل المثال، ServiceBus | لا | نعم |
Type |
AZMSVNet الاتصال الأحداث | لا | نعم |
يتم إنشاء سجلات الشبكة الظاهرية فقط إذا كانت مساحة الاسم تسمح بالوصول من الشبكات المحددة أو من عناوين IP محددة (قواعد تصفية IP). إذا كنت لا تريد تقييد الوصول إلى مساحة الاسم الخاصة بك باستخدام هذه الميزات وما زلت ترغب في الحصول على سجلات الشبكة الافتراضية لتتبع عناوين IP للعملاء المتصلين بمساحة مراكز الأحداث، فيمكنك استخدام الحل البديل التالي. تمكين تصفية IP، وإضافة إجمالي نطاق IPv4 القابل للعنوان (0.0.0.0/1 - 128.0.0.0/1) ونطاق IPv6 ( - ::/18000::/1). لا تدعم تصفية عناوين IP لمراكز الأحداث نطاقات IPv6. قد ترى عناوين نقطة النهاية الخاصة بتنسيق IPv6 في السجل.
مثال
تشخيصات Azure:
{
"SubscriptionId": "0000000-0000-0000-0000-000000000000",
"NamespaceName": "namespace-name",
"IPAddress": "1.2.3.4",
"Action": "Deny Connection",
"Reason": "IPAddress doesn't belong to a subnet with Service Endpoint enabled.",
"Count": "65",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
"Category": "EventHubVNetConnectionEvent"
}
إدخال جدول خاص بالموارد:
{
"SubscriptionId": "0000000-0000-0000-0000-000000000000",
"NamespaceName": "namespace-name",
"IPAddress": "1.2.3.4",
"Action": "Deny Connection",
"Message": "IPAddress doesn't belong to a subnet with Service Endpoint enabled.",
"Count": "65",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
"Provider": "EVENTHUB",
"Time Generated (UTC) ": "9/28/2022 8:40:06 PM +00:00",
"Type" : "AZMSKafkauserErrorlogs"
}
مخطط سجلات المستخدم الرئيسي المُدار بواسطة العميل
يتضمن سجل المستخدم الرئيسي الذي يديره العميل JSON العناصر المدرجة في الجدول التالي:
| Name | الوصف | مدعوم في تشخيصات Azure | مدعوم في AZMSCustomerManagedKeyUserLogs (جدول خاص بالموارد) |
|---|---|---|---|
Category |
نوع فئة الرسالة. إنها إحدى القيم التالية: الخطأ والمعلومات. على سبيل المثال، إذا تم تعطيل المفتاح من مخزن المفاتيح الخاص بك، فستكون فئة معلومات أو إذا تعذر فك المفتاح، فقد يقع تحت الخطأ. | نعم | نعم |
ResourceId |
معرف المورد الداخلي، والذي يتضمن معرف اشتراك Azure واسم مساحة الاسم | نعم | نعم |
KeyVault |
اسم مورد Key Vault | نعم | نعم |
Key |
اسم مفتاح Key Vault المستخدم لتشفير مساحة اسم مراكز الأحداث. | نعم | نعم |
Version |
إصدار مفتاح Key Vault. | نعم | نعم |
Operation |
العملية التي يتم إجراؤها على المفتاح الموجود في خزنة المفاتيح الخاصة بك. على سبيل المثال، قم بتعطيل / تمكين المفتاح أو التقييد أو فك التقييد. | نعم | نعم |
Code |
التعليمات البرمجية المقترنة بالعملية. مثال: رمز الخطأ 404 يعني أنه لم يتم العثور على المفتاح. | نعم | نعم |
Message |
الرسالة، والتي توفر تفاصيل حول خطأ أو رسالة إعلامية | نعم | نعم |
Time Generated (UTC) |
الطابع الزمني للعملية | لا | نعم |
Provider |
اسم الخدمة التي تنبعث منها السجلات، على سبيل المثال، ServiceBus | لا | نعم |
Type |
نوع السجل المنبعث | لا | نعم |
فيما يلي مثال للسجل الخاص بمفتاح مُدار للعميل:
تشخيصات Azure:
{
"TaskName": "CustomerManagedKeyUserLog",
"ActivityId": "11111111-1111-1111-1111-111111111111",
"category": "error"
"resourceId": "/SUBSCRIPTIONS/11111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
"keyVault": "https://mykeyvault.vault-int.azure-int.net",
"key": "mykey",
"version": "1111111111111111111111111111111",
"operation": "wrapKey",
"code": "404",
"message": "Key not found: ehbyok0/111111111111111111111111111111"
}
{
"TaskName": "CustomerManagedKeyUserLog",
"ActivityId": "11111111111111-1111-1111-1111111111111",
"category": "info"
"resourceId": "/SUBSCRIPTIONS/111111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
"keyVault": "https://mykeyvault.vault-int.azure-int.net",
"key": "mykey",
"version": "111111111111111111111111111111",
"operation": "disable | restore",
"code": "",
"message": ""
}
إدخال جدول خاص بالموارد:
{
"TaskName": "CustomerManagedKeyUserLog",
"ActivityId": "11111111-1111-1111-1111-111111111111",
"category": "error"
"resourceId": "/SUBSCRIPTIONS/11111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
"keyVault": "https://mykeyvault.vault-int.azure-int.net",
"key": "mykey",
"version": "1111111111111111111111111111111",
"operation": "wrapKey",
"code": "404",
"message": "Key not found: ehbyok0/111111111111111111111111111111",
"Provider": "EVENTHUB",
"Time Generated (UTC) ": "9/28/2022 8:40:06 PM +00:00",
"Type" : "AZMSCustomerManagedKeyUserLogs"
}
{
"TaskName": "CustomerManagedKeyUserLog",
"ActivityId": "11111111111111-1111-1111-1111111111111",
"category": "info"
"resourceId": "/SUBSCRIPTIONS/111111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
"keyVault": "https://mykeyvault.vault-int.azure-int.net",
"key": "mykey",
"version": "111111111111111111111111111111",
"operation": "disable | restore",
"code": "",
"message": "",
"Provider": "EVENTHUB",
"Time Generated (UTC) ": "9/28/2022 8:40:06 PM +00:00",
"Type" : "AZMSCustomerManagedKeyUserLogs"
}
فيما يلي رموز الأخطاء الشائعة التي يجب البحث عنها عند تمكين تشفير BYOK.
| الإجراء | رمز الخطأ | الحالة الناتجة للبيانات |
|---|---|---|
| قم بإزالة إذن التقييد / فك التقييد من مخزن المفاتيح | 403 | يتعذر الوصول إليها |
| إزالة عضوية دور معرف Microsoft Entra من أساس Microsoft Entra الذي منح إذن الالتفاف/إلغاء التغليف | 403 | يتعذر الوصول إليها |
| احذف مفتاح تشفير من خزنة المفاتيح | 404 | يتعذر الوصول إليها |
| حذف مخزن المفاتيح | 404 | لا يمكن الوصول إليه (بافتراض تمكين الحذف البسيط وهو إعداد مطلوب.) |
| تغيير فترة انتهاء الصلاحية على مفتاح التشفير بحيث تكون منتهية الصلاحية بالفعل | 403 | يتعذر الوصول إليها |
| تغيير NBF (ليس قبل ذلك) مثل مفتاح تشفير المفتاح هذا غير نشط | 403 | يتعذر الوصول إليها |
| تحديد الخيار Allow MSFT Services لجدار حماية مخزن المفاتيح أو حظر الوصول إلى الشبكة إلى خزنة المفاتيح التي تحتوي على مفتاح التشفير | 403 | يتعذر الوصول إليها |
| نقل خزنة المفاتيح إلى مستأجر مختلف | 404 | يتعذر الوصول إليها |
| مشكلة متقطعة في الشبكة أو انقطاع DNS / AAD / MSI | يمكن الوصول إليها باستخدام مفتاح تشفير البيانات المخزنة مؤقتاً |
سجلات تدقيق وقت التشغيل
تلتقط سجلات تدقيق وقت التشغيل معلومات تشخيصية مجمعة لجميع عمليات الوصول إلى مستوى البيانات (مثل إرسال الأحداث أو تلقيها) في Event Hubs.
إشعار
لا تتوفر سجلات تدقيق وقت التشغيل إلا في مستويات مميزة ومخصصة.
تتضمن سجلات تدقيق وقت التشغيل العناصر المذكورة في الجدول التالي:
| Name | الوصف | مدعوم في تشخيصات Azure | معتمد في جدول خاص بالموارد |
|---|---|---|---|
ActivityId |
معرّف فريد عالمي مُنشأ عشوائياً يضمن التفرد لنشاط التدقيق. | نعم | نعم |
ActivityName |
اسم عملية وقت التشغيل. | نعم | نعم |
ResourceId |
المورد المقترن بالنشاط. | نعم | نعم |
Timestamp |
نوع التجميع. | نعم | لا |
TimeGenerated [UTC] |
وقت العملية المنفذة (بالتوقيت العالمي المتفق عليه) | لا | نعم |
Status |
حالة النشاط (النجاح أو الفشل). | نعم | نعم |
Protocol |
نوع البروتوكول المقترن بالعملية. | نعم | نعم |
AuthType |
نوع المصادقة (Azure Active Directory أو نهج SAS). | نعم | نعم |
AuthKey |
معرّف تطبيق Azure Active Directory أو اسم نهج SAS المُستخدم للمصادقة على مورد. | نعم | نعم |
NetworkType |
نوع الوصول إلى الشبكة: Public أو Private. |
نعم | نعم |
ClientIP |
عنوان IP لتطبيق العميل. | نعم | نعم |
Count |
إجمالي عدد العمليات المُجراة خلال الفترة المجمعة التي تبلغ دقيقة واحدة. | نعم | نعم |
Properties |
بيانات التعريف الخاصة بعملية وحدة البيانات. | نعم | نعم |
Category |
فئة السجل | نعم | لا |
Provider |
اسم الخدمة التي تنبعث منها السجلات على سبيل المثال، Eventhub | لا | نعم |
Type |
نوع السجلات المنبعثة | لا | نعم |
فيما يلي مثال لإدخال سجل تدقيق وقت التشغيل:
تشخيصات Azure :
{
"ActivityId": "<activity id>",
"ActivityName": "ConnectionOpen | Authorization | SendMessage | ReceiveMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace>/eventhubs/<event hub name>",
"Time": "1/1/2021 8:40:06 PM +00:00",
"Status": "Success | Failure",
"Protocol": "AMQP | KAFKA | HTTP | Web Sockets",
"AuthType": "SAS | Azure Active Directory",
"AuthId": "<AAD application name | SAS policy name>",
"NetworkType": "Public | Private",
"ClientIp": "x.x.x.x",
"Count": 1,
"Category": "RuntimeAuditLogs"
}
إدخال جدول خاص بالموارد:
{
"ActivityId": "<activity id>",
"ActivityName": "ConnectionOpen | Authorization | SendMessage | ReceiveMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace>/eventhubs/<event hub name>",
"TimeGenerated (UTC)": "1/1/2021 8:40:06 PM +00:00",
"Status": "Success | Failure",
"Protocol": "AMQP | KAFKA | HTTP | Web Sockets",
"AuthType": "SAS | Azure Active Directory",
"AuthId": "<AAD application name | SAS policy name>",
"NetworkType": "Public | Private",
"ClientIp": "x.x.x.x",
"Count": 1,
"Type": "AZMSRuntimeAUditLogs",
"Provider":"EVENTHUB"
}
سجلات مقاييس التطبيق
تلتقط سجلات مقاييس التطبيق المعلومات المجمعة على مقاييس معينة تتعلق بعمليات وحدة البيانات. تتضمن المعلومات المُلتقطة مقاييس وقت التشغيل التالية.
إشعار
لا تتوفر سجلات قياسات التطبيق إلا في المستويات المميزة والمخصصة.
| Name | الوصف |
|---|---|
ConsumerLag |
أشِر إلى المدة الانتقالية بين المستهلكين والمنتجين. |
NamespaceActiveConnections |
تفاصيل الاتصالات النشطة المؤسسة من عميل إلى مركز الأحداث. |
GetRuntimeInfo |
احصل على معلومات وقت التشغيل من مراكز الأحداث. |
GetPartitionRuntimeInfo |
احصل على معلومات وقت التشغيل التقريبية لقسم منطقي لمركز أحداث. |
IncomingMessages |
تفاصيل عدد الرسائل المنشورة إلى مراكز الأحداث. |
IncomingBytes |
تفاصيل معدل نقل الناشر المرسلة إلى مراكز الأحداث |
OutgoinMessages |
تفاصيل عدد الرسائل المستهلكة من مراكز الأحداث. |
OutgoingBytes |
تفاصيل معدل نقل المستهلك من مراكز الأحداث. |
OffsetCommit |
عدد استدعاءات الالتزام بالإزاحة التي تم إجراؤها إلى مركز الحدث |
OffsetFetch |
عدد استدعاءات إحضار الإزاحة التي تم إجراؤها إلى مركز الحدث. |
سجلات الأخطاء التشخيصية
تسجل سجلات الأخطاء التشخيصية رسائل الخطأ لأي جانب عميل، وتجاوز التقييد والحصة النسبية الأخطاء. وهي توفر تشخيصات مفصلة لتحديد الأخطاء.
تتضمن سجلات الأخطاء التشخيصية العناصر المدرجة في الجدول أدناه:
| Name | الوصف | مدعوم في تشخيصات Azure | مدعوم في AZMSDiagnosticErrorLogs (جدول خاص بالموارد) |
|---|---|---|---|
ActivityId |
معرّف فريد عالمي مُنشأ عشوائياً يضمن التفرد لنشاط التدقيق. | نعم | نعم |
ActivityName |
اسم العملية | نعم | نعم |
NamespaceName |
اسم مساحة الاسم | نعم | yes |
EntityType |
نوع الكيان | نعم | نعم |
EntityName |
اسم الكيان | نعم | نعم |
OperationResult |
نوع الخطأ في العملية (Clienterror أو Serverbusy أو quotaexceeded) | نعم | نعم |
ErrorCount |
عدد الأخطاء المتطابقة أثناء فترة التجميع البالغة دقيقة واحدة. | نعم | نعم |
ErrorMessage |
رسالة خطأ مفصلة | نعم | نعم |
ResourceProvider |
اسم الخدمة التي تنبعث منها السجلات. القيم المحتملة: Microsoft.Eventhub وMicrosoft.Servicebus | نعم | نعم |
Time Generated (UTC) |
وقت العملية | لا | نعم |
EventTimestamp |
وقت العملية | نعم | لا |
Category |
فئة السجل | نعم | لا |
Type |
نوع السجلات المنبعثة | لا | نعم |
فيما يلي مثال لإدخال سجل الأخطاء التشخيصية:
{
"ActivityId": "0000000000-0000-0000-0000-00000000000000",
"SubscriptionId": "<Azure Subscription Id",
"NamespaceName": "Name of Event Hubs Namespace",
"EntityType": "EventHub",
"EntityName": "Name of Event Hub",
"ActivityName": "SendMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event hub namespace name>",,
"OperationResult": "ServerBusy",
"ErrorCount": 1,
"EventTimestamp": "3/27/2024 1:02:29.126 PM +00:00",
"ErrorMessage": "the request was terminated because the entity is being throttled by the application group with application group name <application group name> and policy name <throttling policy name>.error code: 50013.",
"category": "DiagnosticErrorLogs"
}
إدخال جدول خاص بالموارد:
{
"ActivityId": "0000000000-0000-0000-0000-00000000000000",
"NamespaceName": "Name of Event Hubs Namespace",
"EntityType": "Event Hub",
"EntityName": "Name of Event Hub",
"ActivityName": "SendMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event hub namespace name>",,
"OperationResult": "ServerBusy",
"ErrorCount": 1,
"TimeGenerated [UTC]": "1/27/2024 4:02:29.126 PM +00:00",
"ErrorMessage": "The request was terminated because the entity is being throttled by the application group with application group name <application group name> and policy name <throttling policy name>.error code: 50013.",
"Type": "AZMSDiagnosticErrorLogs"
}
جداول سجلات Azure Monitor
يستخدم ناقل Azure Event Hubs جداول Kusto من سجلات Azure Monitor. يمكنك الاستعلام عن هذه الجداول باستخدام Log Analytics. للحصول على قائمة بجداول Kusto التي تستخدمها الخدمة، راجع مرجع جدول سجلات Azure Monitor.
يمكنك عرض نماذج الاستعلامات لبدء استخدام فئات سجل مختلفة.
هام
لا يتم تصدير الأبعاد إلى مساحة عمل في Log Analytics.
الخطوات التالية
- للحصول على معلومات حول مراقبة Azure Event Hubs، راجع Monitoring Azure Event Hubs.
- للحصول على تفاصيل حول مراقبة موارد Azure، راجع مراقبة موارد Azure باستخدام Azure Monitor.
الملاحظات
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجع https://aka.ms/ContentUserFeedback.
إرسال الملاحظات وعرضها المتعلقة بـ