Event Grid kaynakları için tanılama günlüklerini etkinleştirme

Makale
10/26/2023

Bu makalede, Event Grid kaynakları için tanılama ayarlarını etkinleştirmeye yönelik adım adım yönergeler sağlanır. Bu ayarlar, tanılama bilgilerini yakalamanıza ve görüntülemenize olanak tanıyarak tüm hataları giderebilmenizi sağlar. Aşağıdaki tabloda, özel konular, sistem konuları ve etki alanları gibi farklı türde Event Grid kaynakları için kullanılabilen ayarlar gösterilmektedir.

Tanılama ayarı	Event Grid konuları	Event Grid sistem konuları	Olay etki alanları	Event Grid iş ortağı ad alanları
DeliveryFailures	Evet	Evet	Evet	Hayır
PublishFailures	Evet	Hayır	Evet	Evet
DataPlaneRequests	Evet	Hayır	Evet	Evet

Önemli

Teslim hatalarının, yayımlama hatalarının ve veri düzlemi isteklerinin şemaları için bkz . Tanılama günlükleri.

Ön koşullar

Sağlanan event grid kaynağı
Tanılama günlüklerini yakalamak için sağlanan bir hedef:
- Log Analytics çalışma alanı
- Depolama hesabı
- Event Hubs
- İş ortağı çözümü

Event Grid konuları ve etki alanları için tanılama günlüklerini etkinleştirme

Dekont

Aşağıdaki yordam, konu başlıkları için tanılama günlüklerini etkinleştirmeye yönelik adım adım yönergeler sağlar. Bir etki alanı için tanılama günlüklerini etkinleştirme adımları çok benzerdir. 2. adımda Azure portalında Event Grid etki alanına gidin.

Azure Portal oturum açın.
Tanılama günlüğü ayarlarını etkinleştirmek istediğiniz Event Grid konusuna gidin.
1. Üstteki arama çubuğunda Event Grid konularını arayın.
2. Tanılama ayarlarını yapılandırmak istediğiniz listeden konuyu seçin.
Soldaki menüde İzleme'nin altında Tanılama ayarları'nı seçin.
Tanılama ayarları sayfasında Yeni Tanılama Ayarı Ekle'yi seçin.
Tanılama ayarı için bir ad belirtin.
Günlükler bölümünde allLogs seçeneğini belirleyin.
Günlükler için yakalama hedeflerinden birini veya daha fazlasını etkinleştirin ve daha önce oluşturulmuş bir yakalama kaynağını seçerek bunları yapılandırın.
- Log Analytics'e Gönder'i seçerseniz Log Analytics çalışma alanını seçin.
- Depolama hesabında arşivle'yi seçerseniz Depolama hesabı - Yapılandır'ı ve ardından Azure aboneliğinizdeki depolama hesabını seçin.
- Bir olay hub'ına akışla aktar'ı seçerseniz Olay hub'ı - Yapılandır'ı seçin ve ardından Event Hubs ad alanını, olay hub'ını ve erişim ilkesini seçin.
Kaydet'i seçin. Ardından sağ köşedeki X işaretini seçerek sayfayı kapatın.
Şimdi Tanılama ayarları sayfasına dönüp Tanılama Ayarlar tablosunda yeni bir giriş gördüğünüzden emin olun.

Konu başlığı için tüm ölçümlerin toplanmasını da etkinleştirebilirsiniz.

Event Grid sistem konuları için tanılama günlüklerini etkinleştirme

Azure Portal oturum açın.
Tanılama günlüğü ayarlarını etkinleştirmek istediğiniz sistem konusuna gidin.
1. Üstteki arama çubuğunda Event Grid sistem konularını arayın.
2. Tanılama ayarlarını yapılandırmak istediğiniz sistem konusunu seçin.
Soldaki menüde İzleme'nin altında Tanılama ayarları'nı ve ardından Tanılama ayarı ekle'yi seçin.
Tanılama ayarı için bir ad belirtin.
Günlükler bölümünde allLogs seçeneğini belirleyin.
Günlükler için yakalama hedeflerinden birini veya daha fazlasını etkinleştirin ve daha önce oluşturulmuş bir yakalama kaynağını seçerek bunları yapılandırın.
- Log Analytics'e Gönder'i seçerseniz Log Analytics çalışma alanını seçin.
- Depolama hesabında arşivle'yi seçerseniz Depolama hesabı - Yapılandır'ı ve ardından Azure aboneliğinizdeki depolama hesabını seçin.
- Bir Olay Hub'ına AkışLa'yı seçerseniz Olay Hub'ı - Yapılandır'ı ve ardından Event Hubs ad alanını, olay hub'ını ve erişim ilkesini seçin.
Kaydet'i seçin. Ardından sağ köşedeki X işaretini seçerek sayfayı kapatın.
Şimdi Tanılama ayarları sayfasına dönüp Tanılama Ayarlar tablosunda yeni bir giriş gördüğünüzden emin olun.

Sistem konusu için tüm ölçümlerin toplanmasını da etkinleştirebilirsiniz. System topic - enable all metrics

Azure Depolama tanılama günlüklerini görüntüleme

Bir depolama hesabını yakalama hedefi olarak etkinleştirdikten sonra Event Grid tanılama günlüklerini yaymaya başlar. Depolama hesabında insights-logs-deliveryfailures ve insights-logs-publishfailures adlı yeni kapsayıcılar görmeniz gerekir.
Kapsayıcılardan birinde gezinirken JSON biçiminde bir bloba sahip olursunuz. Dosya, teslim hatası veya yayımlama hatası için günlük girdileri içerir. Gezinti yolu, Event Grid konusunun ResourceId değerini ve günlük girdilerinin ne zaman yayıldığına ilişkin zaman damgasını (dakika düzeyi) temsil eder. İndirilebilen blob/JSON dosyası, sonunda bir sonraki bölümde açıklanan şemaya bağlıdır.

JSON dosyasında aşağıdaki örneğe benzer bir içerik görmeniz gerekir:

{
    "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 şablonu kullanma

Event Grid konusu için tanılama ayarlarını etkinleştirmek için örnek bir Azure Resource Manager şablonu aşağıda verilmiştır. Bu örnek şablonu dağıttığınızda aşağıdaki kaynaklar oluşturulur.

Event Grid konusu
Log Analytics çalışma alanı

Ardından, log analytics çalışma alanına tanılama bilgileri göndermek için konu başlığında bir tanılama ayarı oluşturur.

{
    "$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
                    }
                ]
            }
        }
    ]
}

Denetim izlemeleri için tanılama günlüklerini etkinleştirme

Event Grid, veri düzlemi işlemleri için denetim izlemeleri yayımlayabilir. Özelliği etkinleştirmek için Kategori grupları bölümünden denetim'i seçin veya Kategoriler bölümünde DataPlaneRequests'i seçin.

Denetim izlemesi, veri erişimine yalnızca yetkili amaçlarla izin verildiğinden emin olmak için kullanılabilir. Kaynak adı, işlem türü, ağ erişimi, düzey, bölge ve daha fazlası gibi güvenlik denetimi hakkında bilgi toplar. Tanılama ayarını etkinleştirme hakkında daha fazla bilgi için bkz . Event Grid konu başlıklarındaki tanılama günlükleri ve Olay etki alanları. Screenshot that shows the Diagnostic settings page with Audit selected.

Önemli

Şema hakkında DataPlaneRequests daha fazla bilgi için bkz . Tanılama günlükleri.

Sonraki adımlar

Günlük şeması ve konu başlıkları veya etki alanları için tanılama günlükleri hakkında diğer kavramsal bilgiler için bkz . Tanılama günlükleri.

Aracılığıyla paylaş