Bagikan melalui

Mengaktifkan log diagnostik untuk sumber daya Event Grid

  • Artikel

Artikel ini memberikan petunjuk langkah demi langkah untuk mengaktifkan pengaturan diagnostik untuk sumber daya Event Grid. Pengaturan ini memungkinkan Anda untuk mengambil dan melihat informasi diagnostik sehingga Anda dapat memecahkan masalah kegagalan apa pun. Tabel berikut menunjukkan pengaturan yang tersedia untuk berbagai jenis sumber daya Event Grid - topik khusus, topik sistem, dan domain.

Pengaturan diagnostik Topik Event Grid Topik sistem Event Grid Domain Peristiwa Namespace mitra Event Grid
DeliveryFailures Ya Ya Ya Tidak
PublishFailures Ya No Ya Ya
DataPlaneRequests Ya No Ya Ya

Penting

Untuk skema kegagalan pengiriman, kegagalan penerbitan, dan permintaan data plane, lihat Log diagnostik.

Prasyarat

  • Sumber daya Event Grid yang diprovisikan
  • Tujuan yang disediakan untuk menangkap log diagnostik:
    • Ruang kerja Analitik Log
    • Akun Penyimpanan
    • Event Hubs
    • Solusi mitra

Mengaktifkan log diagnostik untuk topik dan domain Event Grid

Catatan

Prosedur berikut memberikan petunjuk langkah demi langkah dalam mengaktifkan log diagnostik untuk topik. Langkah-langkah untuk mengaktifkan log diagnostik untuk domain sangat mirip. Di langkah 2, buka domain Event Grid di portal Microsoft Azure.

  1. Masuk ke portal Azure.

  2. Buka topik Event Grid yang ingin Anda aktifkan pengaturan log diagnostiknya.

    1. Di bilah pencarian di bagian atas, cari Topik Event Grid.

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

    2. Pilih topik dari daftar yang ingin Anda konfigurasi pengaturan diagnostiknya.

  3. Pilih Pengaturan diagnostik di bawah Pemantauan.

  4. Pada halaman Pengaturan diagnostik, pilih Tambahkan Pengaturan Diagnostik Baru.

    Screenshots showing the Diagnostic settings page of a custom topic.

  5. Tentukan nama untuk pengaturan diagnostik.

  6. Pilih opsi allLogs di bagian Log.

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

  7. Aktifkan satu atau beberapa tujuan penangkapan untuk log, lalu konfigurasikan dengan memilih sumber daya penangkapan yang dibuat sebelumnya.

    • Jika Anda memilih Kirim ke Analitik Log, pilih ruang kerja Analitik Log.

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

    • Jika Anda memilih Arsipkan ke akun penyimpanan, pilih Akun penyimpanan - Konfigurasikan, lalu pilih akun penyimpanan di langganan Azure Anda.

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

    • Jika Anda memilih Streaming ke Event Hub, pilih Azure Event Hubs - Konfigurasikan, lalu pilih bidang nama Azure Event Hubs, event hubs, dan kebijakan akses.

      Screenshot that shows the

  8. Pilih Simpan. Lalu, pilih X di sudut kanan untuk menutup halaman.

  9. Sekarang, kembali ke halaman Pengaturan diagnostik, konfirmasikan bahwa Anda melihat entri baru dalam tabel Pengaturan Diagnostik.

    Screenshot that shows the

Anda juga dapat mengaktifkan pengumpulan semua metrik untuk topik tersebut.

Mengaktifkan log diagnostik untuk topik sistem Event Grid

  1. Masuk ke portal Azure.
  2. Buka topik sistem yang ingin Anda aktifkan pengaturan log diagnostiknya.
    1. Di bilah pencarian di bagian atas, cari Topik sistem Event Grid. Search for system topics
    2. Pilih topik sistem yang ingin Anda konfigurasikan pengaturan diagnostiknya. Select system topic
  3. Pilih Pengaturan diagnostik di bawah Pemantauan di panel kiri, lalu pilih Tambahkan pengaturan diagnostik. Add diagnostic settings - button
  4. Tentukan nama untuk pengaturan diagnostik.
  5. Pilih opsi allLogs di bagian Log. Select delivery failures
  6. Aktifkan satu atau beberapa tujuan penangkapan untuk log, lalu konfigurasikan dengan memilih sumber daya penangkapan yang dibuat sebelumnya.
    • Jika Anda memilih Kirim ke Analitik Log, pilih ruang kerja Analitik Log. Send to Log Analytics
    • Jika Anda memilih Arsipkan ke akun penyimpanan, pilih Akun penyimpanan - Konfigurasikan, lalu pilih akun penyimpanan di langganan Azure Anda. Archive to an Azure storage account
    • Jika Anda memilih Alirkan ke Pusat Aktivitas, pilih Pusat Aktivitas - Konfigurasikan, lalu pilih namespace layanan Pusat Aktivitas, pusat aktivitas, dan kebijakan akses. Stream to an event hub
  7. Pilih Simpan. Lalu, pilih X di sudut kanan untuk menutup halaman.
  8. Sekarang, kembali ke halaman Pengaturan diagnostik, konfirmasikan bahwa Anda melihat entri baru dalam tabel Pengaturan Diagnostik. Diagnostic setting in the list

Anda juga dapat mengaktifkan pengumpulan semua metrik untuk topik sistem. System topic - enable all metrics

Menampilkan log diagnostik di Microsoft Azure Storage

  1. Setelah Anda mengaktifkan akun penyimpanan sebagai tujuan penangkapan, Event Grid mulai memancarkan log diagnostik. Anda akan melihat kontainer baru bernama insights-logs-deliveryfailures dan insights-logs-publishfailures di akun penyimpanan.

    Storage - containers for diagnostic logs

  2. Saat menavigasi melalui salah satu kontainer, Anda akan berakhir pada gumpalan dalam format JSON. Berkas ini memuat entri log untuk kegagalan pengiriman atau kegagalan publikasi. Jalur navigasi mewakili ResourceId dari topik Event Grid dan tanda waktu (tingkat menit) saat entri log dipancarkan. File blob/JSON, yang dapat diunduh, pada akhirnya mematuhi skema yang dijelaskan di bagian berikutnya.

    JSON file in the storage

  3. Anda akan melihat konten dalam file JSON yang mirip dengan contoh berikut:

    {
    "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:"
}

Menggunakan templat Azure Resource Manager

Berikut adalah contoh templat Azure Resource Manager untuk mengaktifkan pengaturan diagnostik untuk topik Event Grid. Saat Anda menyebarkan templat, sumber daya berikut ini dibuat.

  • Topik Event Grid
  • Ruang kerja Log Analytics

Kemudian, itu membuat pengaturan diagnostik pada topik untuk mengirim informasi diagnostik ke ruang kerja 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
                    }
                ]
            }
        }
    ]
}

Mengaktifkan log diagnostik untuk jejak audit

Event Grid dapat menerbitkan jejak audit untuk operasi data plane. Untuk mengaktifkan fitur tersebut, pilih audit di bagian Grup kategori atau pilih DataPlaneRequests di bagian Kategori.

Jejak audit dapat digunakan untuk memastikan bahwa akses data hanya diperbolehkan untuk tujuan yang sah. Audit ini mengumpulkan informasi tentang kontrol keamanan seperti nama sumber daya, jenis operasi, akses jaringan, tingkat, wilayah dan banyak lagi. Untuk informasi selengkapnya tentang cara mengaktifkan pengaturan diagnostik, lihat Log diagnostik di topik Event Grid dan domain Peristiwa. Screenshot that shows the Diagnostic settings page with Audit selected.

Penting

Untuk informasi selengkapnya tentang skema DataPlaneRequests, lihat Log diagnostik.

Langkah berikutnya

Untuk skema log dan informasi konseptual lainnya tentang log diagnostik untuk topik atau domain, lihat Log diagnostik.