Bagikan melalui


Mengaktifkan log diagnostik untuk sumber daya Event Grid

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.

      Cuplikan layar yang memperlihatkan portal Azure dengan topik Event Grid di kotak pencarian.

    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.

    Cuplikan layar memperlihatkan halaman Pengaturan diagnostik dari topik kustom.

  5. Tentukan nama untuk pengaturan diagnostik.

  6. Pilih opsi allLogs di bagian Log.

    Cuplikan layar yang memperlihatkan halaman Pengaturan diagnostik dengan Semua log dipilih.

  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.

      Cuplikan layar yang memperlihatkan halaman Pengaturan diagnostik dengan Kirim ke Analitik Log dipilih.

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

      Cuplikan layar yang memperlihatkan halaman Pengaturan diagnostik dengan Arsipkan ke akun penyimpanan Azure dicentang dan akun penyimpanan dipilih.

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

      Cuplikan layar yang menampilkan halaman

  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.

    Cuplikan layar yang memperlihatkan halaman

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. Mencari topik sistem
    2. Pilih topik sistem yang ingin Anda konfigurasikan pengaturan diagnostiknya. Pilih topik sistem
  3. Pilih Pengaturan diagnostik di bawah Pemantauan di panel kiri, lalu pilih Tambahkan pengaturan diagnostik. Menambahkan halaman pengaturan diagnostik
  4. Tentukan nama untuk pengaturan diagnostik.
  5. Pilih opsi allLogs di bagian Log. Pilih kegagalan pengiriman
  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. Mengirim ke Log Analytics
    • Jika Anda memilih Arsipkan ke akun penyimpanan, pilih Akun penyimpanan - Konfigurasikan, lalu pilih akun penyimpanan di langganan Azure Anda. Mengarsipkan ke akun penyimpanan Azure
    • Jika Anda memilih Alirkan ke Pusat Aktivitas, pilih Pusat Aktivitas - Konfigurasikan, lalu pilih namespace layanan Pusat Aktivitas, pusat aktivitas, dan kebijakan akses. Melakukan streaming ke hub acara
  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. Pengaturan diagnostik dalam daftar

Anda juga dapat mengaktifkan pengumpulan semua metrik untuk topik sistem. Topik sistem - aktifkan semua metrik

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.

    Penyimpanan - kontainer untuk log diagnostik

  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.

    File JSON di penyimpanan

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

    {
        "time": "2019-11-01T00:17:13.4389048Z",
        "resourceId": "/SUBSCRIPTIONS/SAMPLE-SUBSCRIPTION-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. Cuplikan layar yang memperlihatkan halaman Pengaturan diagnostik dengan Audit dipilih.

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.