Share via

تمكين سجلات التشخيص لمواردEvent Grid

  • مقالة

توفر هذه المقالة إرشادات خطوة بخطوة لتمكين إعدادات التشخيص لموارد Event Grid. تسمح لك هذه الإعدادات بالتقاط معلومات التشخيص وعرضها بحيث يمكنك استكشاف أي أعطال وإصلاحها. يعرض الجدول التالي الإعدادات المتاحة لأنواع مختلفة من موارد Event Grid- الموضوعات المخصصة وموضوعات النظام والمجالات.

إعداد التشخيص Event Grid topics موضوعات نظام Event Grid مجالات الأحداث مساحات أسماء شركاء Event Grid
تسليمFailures ‏‏نعم‬ ‏‏نعم نعم لا
نشرFailures ‏‏نعم‬ Yes نعم ‏‏نعم‬
طلبات DataPlane ‏‏نعم‬ Yes نعم نعم

هام

بالنسبة إلى مخططات حالات فشل التسليم وإخفاقات النشر وطلبات مستوى البيانات، راجع سجلات التشخيص.

المتطلبات الأساسية

  • مورد شبكة حدث مزود
  • وجهة مخصصة لالتقاط سجلات التشخيص:
    • مساحة عمل Log Analytics
    • حساب التخزين
    • مراكز الأحداث
    • حل الشريك

تمكين سجلات التشخيص لموضوعات ومجالات Event Grid

إشعار

يوفر الإجراء التالي إرشادات خطوة بخطوة لتمكين سجلات التشخيص للمواضيع. خطوات تمكين سجلات التشخيص للمجال متشابهة جداً. في الخطوة 2، انتقل إلى Event Grid domain في مدخل Microsoft Azure.

  1. سجل الدخول إلى مدخل Azure.

  2. انتقل إلى موضوع شبكة الحدث الذي تريد تمكين إعدادات سجل التشخيص له.

    1. في شريط البحث في الجزء العلوي، ابحث عن مواضيع Event Grid.

      Screenshot that shows the Azure portal with Event Grid topics in the search box.

    2. حدد topic من القائمة التي تريد تكوين إعدادات التشخيص لها.

  3. حدد Diagnostic settings ضمن المراقبة في القائمة اليسرى.

  4. في صفحة Diagnostic settings، حدد Add New Diagnostic Setting.

    Screenshots showing the Diagnostic settings page of a custom topic.

  5. حدد name لإعداد التشخيص.

  6. حدد خيارallLogsفي قسم Logs.

    Screenshot that shows the Diagnostic setting page with All logs selected.

  7. قم بتمكين واحد أو أكثر من وجهات الالتقاط للسجلات، ثم قم بتكوينها عن طريق تحديد مورد التقاط تم إنشاؤه مسبقاً.

    • إذا حددت Send to Log Analytics، فحدد the Log Analytics workspace.

      Screenshot that shows the Diagnostic settings page with Send to Log Analytics selected.

    • إذا حددت Archive to a storage account، فحدد Storage account - Configure، ثم حدد حساب التخزين في اشتراك Azure الخاص بك.

      Screenshot that shows the Diagnostic settings page with Archive to an Azure storage account checked and a storage account selected.

    • إذا حددت Stream to an event hub، فحدد Event hub - Configure، ثم حدد مساحة اسم مراكز الأحداث، ومركز الحدث، ونهج الوصول.

      Screenshot that shows the

  8. حدد حفظ. ثم حدد X في الزاوية اليمنى لإغلاق الصفحة.

  9. الآن، عد إلى صفحة Diagnostic settings، تأكد من ظهور إدخال جديد في جدول Diagnostics Settings.

    Screenshot that shows the

يمكنك أيضاً تمكين جمع كل المقاييس للموضوع.

تمكين سجلات التشخيص لموضوعات نظام Event Grid

  1. سجل الدخول إلى مدخل Azure.
  2. انتقل إلى موضوع النظام الذي تريد تمكين إعدادات سجل التشخيص له.
    1. في شريط البحث في الجزء العلوي، ابحث عن مواضيع نظام Event Grid. Search for system topics
    2. حدد system topic الذي تريد تكوين إعدادات التشخيص له. Select system topic
  3. حدد Diagnostic settings ضمن Monitoring في القائمة اليسرى، ثم حدد Add diagnostic setting. Add diagnostic settings - button
  4. حدد name لإعداد التشخيص.
  5. حدد خيارallLogsفي قسم Logs. Select delivery failures
  6. قم بتمكين واحد أو أكثر من وجهات الالتقاط للسجلات، ثم قم بتكوينها عن طريق تحديد مورد التقاط تم إنشاؤه مسبقاً.
    • إذا حددت Send to Log Analytics، فحدد the Log Analytics workspace. Send to Log Analytics
    • إذا حددت Archive to a storage account، فحدد Storage account - Configure، ثم حدد حساب التخزين في اشتراك Azure الخاص بك. Archive to an Azure storage account
    • في حالة تحديد دفق إلى مركز الحدث، حددمراكز الأحداث تكوين، ثم حدد مساحة أسماء Event Hubs، ومراكز الأحداث، ونهج الوصول. Stream to an event hub
  7. حدد حفظ. ثم حدد X في الزاوية اليمنى لإغلاق الصفحة.
  8. الآن، عد إلى صفحة Diagnostic settings، تأكد من ظهور إدخال جديد في جدول Diagnostics Settings. Diagnostic setting in the list

يمكنك أيضاً تمكين جمع كل المقاييس لموضوع النظام. System topic - enable all metrics

عرض سجلات التشخيص في Azure Storage

  1. بمجرد تمكين حساب التخزين كوجهة التقاط، تبدأ Event Grid في إصدار سجلات التشخيص. يجب أن تشاهد حاويات جديدة باسم insights-logs-deliveryfailures وinsights-logs-publishfailures في حساب التخزين.

    Storage - containers for diagnostic logs

  2. أثناء تنقلك عبر إحدى الحاويات، سينتهي بك الأمر في blob بتنسيق JSON. يحتوي الملف على إدخالات سجل إما لفشل التسليم أو فشل النشر. يمثل مسار التنقل ResourceId لموضوع Event Grid والطوابع الزمنية (مستوى الدقيقة) عند إصدار إدخالات السجل. يلتزم ملف blob/JSON، القابل للتنزيل، في النهاية بالمخطط الموضح في القسم التالي.

    JSON file in the storage

  3. من المفترض أن ترى المحتوى في ملف JSON مشابهاً للمثال التالي:

    {
    "time": "2019-11-01T00:17:13.4389048Z",
    "resourceId": "/SUBSCRIPTIONS/SAMPLE-SUBSCTIPTION-ID /RESOURCEGROUPS/SAMPLE-RESOURCEGROUP-NAME/PROVIDERS/MICROSOFT.EVENTGRID/TOPICS/SAMPLE-TOPIC-NAME ",
    "eventSubscriptionName": "SAMPLEDESTINATION",
    "category": "DeliveryFailures",
    "operationName": "Deliver",
    "message": "Message:outcome=NotFound, latencyInMs=2635, id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx, systemId=xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, state=FilteredFailingDelivery, deliveryTime=11/1/2019 12:17:10 AM, deliveryCount=0, probationCount=0, deliverySchema=EventGridEvent, eventSubscriptionDeliverySchema=EventGridEvent, fields=InputEvent, EventSubscriptionId, DeliveryTime, State, Id, DeliverySchema, LastDeliveryAttemptTime, SystemId, fieldCount=, requestExpiration=1/1/0001 12:00:00 AM, delivered=False publishTime=11/1/2019 12:17:10 AM, eventTime=11/1/2019 12:17:09 AM, eventType=Type, deliveryTime=11/1/2019 12:17:10 AM, filteringState=FilteredWithRpc, inputSchema=EventGridEvent, publisher=DIAGNOSTICLOGSTEST-EASTUS.EASTUS-1.EVENTGRID.AZURE.NET, size=363, fields=Id, PublishTime, SerializedBody, EventType, Topic, Subject, FilteringHashCode, SystemId, Publisher, FilteringTopic, TopicCategory, DataVersion, MetadataVersion, InputSchema, EventTime, fieldCount=15, url=sb://diagnosticlogstesting-eastus.servicebus.windows.net/, deliveryResponse=NotFound: The messaging entity 'sb://diagnosticlogstesting-eastus.servicebus.windows.net/eh-diagnosticlogstest' could not be found. TrackingId:c98c5af6-11f0-400b-8f56-c605662fb849_G14, SystemTracker:diagnosticlogstesting-eastus.servicebus.windows.net:eh-diagnosticlogstest, Timestamp:2019-11-01T00:17:13, referenceId: ac141738a9a54451b12b4cc31a10dedc_G14:"
}

استخدام قالب Azure Resource Manager

فيما يلي نموذج قالب Azure Resource Manager لتمكين إعدادات التشخيص لموضوع Event Grid. عند نشر هذا القالب النموذجي، يتم إنشاء الموارد التالية.

  • موضوع Event Grid
  • مساحة عمل Log Analytics

بعد ذلك، يقوم بإنشاء إعداد تشخيص حول الموضوع لإرسال معلومات التشخيص إلى مساحة عمل Log Analytics.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "topic_name": {
            "defaultValue": "spegrid0917topic",
            "type": "String"
        },
        "log_analytics_workspace_name": {
            "defaultValue": "splogaw0625",
            "type": "String"
        },
        "location": {
            "defaultValue": "eastus",
            "type": "String"
        },
        "sku": {
            "defaultValue": "Free",
            "type": "String"
        }
    },
    "variables": {},
    "resources": [
        {
            "type": "Microsoft.EventGrid/topics",
            "apiVersion": "2020-10-15-preview",
            "name": "[parameters('topic_name')]",
            "location": "[parameters('location')]",
            "sku": {
                "name": "Basic"
            },
            "kind": "Azure",
            "identity": {
                "type": "None"
            },
            "properties": {
                "inputSchema": "EventGridSchema",
                "publicNetworkAccess": "Enabled"
            }
        },
        {
            "apiVersion": "2017-03-15-preview",
            "name": "[parameters('log_analytics_workspace_name')]",
            "location": "[parameters('location')]",
            "type": "Microsoft.OperationalInsights/workspaces",
            "properties": {
                "sku": {
                    "name": "[parameters('sku')]"
                }
            }
        },
        {
            "type": "Microsoft.EventGrid/topics/providers/diagnosticSettings",
            "apiVersion": "2017-05-01-preview",
            "name": "[concat(parameters('topic_name'), '/', 'Microsoft.Insights/', parameters('log_analytics_workspace_name'))]",
            "location": "[parameters('location')]",
            "dependsOn": [
                "[resourceId('Microsoft.EventGrid/topics', parameters('topic_name'))]",
                "[resourceId('Microsoft.OperationalInsights/workspaces', parameters('log_analytics_workspace_name'))]"
            ],
            "properties": {
                "workspaceId": "[resourceId('Microsoft.OperationalInsights/workspaces', parameters('log_analytics_workspace_name'))]",
                "metrics": [
                    {
                        "category": "AllMetrics",
                        "enabled": true
                    }
                ],
                "logs": [
                    {
                        "category": "DeliveryFailures",
                        "enabled": true
                    },
                    {
                        "category": "PublishFailures",
                        "enabled": true
                    }
                ]
            }
        }
    ]
}

تمكين سجلات التشخيص لتتبع التدقيق

يمكن لشبكة الحدث نشر تتبعات عمليات التدقيق لعمليات مستوى البيانات. لتمكين الميزة، حدد عملية التدقيق في قسم مجموعات الفئة أو حدد DataPlaneRequests في قسم الفئات.

يمكن استخدام تتبع التدقيق للتأكد من أن الوصول إلى البيانات مسموح به فقط للأغراض المصرح بها. يقوم بجمع معلومات حول التحكم في الأمان مثل اسم المورد ونوع العملية والوصول إلى الشبكة والمستوى والمنطقة والمزيد. لمزيد من المعلومات حول كيفية تمكين إعداد التشخيص، يجب مراجعة سجلات التشخيص في مواضيع شبكة الحدث ومجالات الحدث. Screenshot that shows the Diagnostic settings page with Audit selected.

هام

لمزيد من المعلومات حول DataPlaneRequests المخطط، راجعسجلات التشخيص.

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

للحصول على مخطط السجل ومعلومات المفاهيم الأخرى عن السجلات التشخيصية للموضوعات أو المجالات، راجع سجلات التشخيص.