Aracılığıyla paylaş


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

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 Yes Evet Evet Hayır
PublishFailures Yes Hayı Evet Yes
DataPlaneRequests Yes Hayı Evet Yes

Önemli

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

Önkoşullar

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

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

Not

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.

  1. Azure Portal’ında oturum açın.

  2. 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.

      Arama kutusunda Event Grid konularını içeren Azure portalını gösteren ekran görüntüsü.

    2. Tanılama ayarlarını yapılandırmak istediğiniz listeden konuyu seçin.

  3. Soldaki menüde İzleme'nin altında Tanılama ayarları'nı seçin.

  4. Tanılama ayarları sayfasında Yeni Tanılama Ayarı Ekle'yi seçin.

    Özel bir konunun Tanılama ayarları sayfasını gösteren ekran görüntüleri.

  5. Tanılama ayarı için bir ad belirtin.

  6. Günlükler bölümünde allLogs seçeneğini belirleyin.

    Tüm günlüklerin seçili olduğu Tanılama ayarı sayfasını gösteren ekran görüntüsü.

  7. 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.

      Log Analytics'e Gönder'in seçili olduğu Tanılama ayarları sayfasını gösteren ekran görüntüsü.

    • Depolama hesabında arşivle'yi seçerseniz Depolama hesabı - Yapılandır'ı ve ardından Azure aboneliğinizdeki depolama hesabını seçin.

      Azure depolama hesabına arşivle seçeneğinin işaretli ve bir depolama hesabının seçili olduğu Tanılama ayarları sayfasını gösteren ekran görüntüsü.

    • 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.

  8. Kaydet'i seçin. Ardından sağ köşedeki X işaretini seçerek sayfayı kapatın.

  9. Şimdi Tanılama ayarları sayfasına dönüp Tanılama Ayarları tablosunda yeni bir girdi 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

  1. Azure Portal’ında oturum açın.
  2. 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. Sistem konularını arama
    2. Tanılama ayarlarını yapılandırmak istediğiniz sistem konusunu seçin. Sistem konusunu seçin
  3. Soldaki menüde İzleme'nin altında Tanılama ayarları'nı ve ardından Tanılama ayarı ekle'yi seçin. Tanılama ayarları ekleme - düğme
  4. Tanılama ayarı için bir ad belirtin.
  5. Günlükler bölümünde allLogs seçeneğini belirleyin. Teslim hatalarını seçme
  6. 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. Log Analytics’e gönderme
    • Depolama hesabında arşivle'yi seçerseniz Depolama hesabı - Yapılandır'ı ve ardından Azure aboneliğinizdeki depolama hesabını seçin. Azure depolama hesabına arşivle
    • 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. Olay hub’ına akış yapma
  7. Kaydet'i seçin. Ardından sağ köşedeki X işaretini seçerek sayfayı kapatın.
  8. Şimdi Tanılama ayarları sayfasına dönüp Tanılama Ayarları tablosunda yeni bir girdi gördüğünüzden emin olun. Listedeki tanılama ayarı

Sistem konusu için tüm ölçümlerin toplanmasını da etkinleştirebilirsiniz. Sistem konusu - tüm ölçümleri etkinleştirme

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

  1. 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.

    Depolama - tanılama günlükleri için kapsayıcılar

  2. 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.

    Depolamadaki JSON dosyası

  3. 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-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:"
    }
    

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ı. Denetim'in seçili olduğu Tanılama ayarları sayfasını gösteren ekran görüntüsü.

Ö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.