Diagnosztikai naplók engedélyezése Event Grid-erőforrásokhoz

  • Cikk

Ez a cikk részletes útmutatást nyújt az Event Grid-erőforrások diagnosztikai beállításainak engedélyezéséhez. Ezek a beállítások lehetővé teszik a diagnosztikai adatok rögzítését és megtekintését, hogy elháríthassa a hibákat. Az alábbi táblázat az Event Grid különböző típusú erőforrásaihoz – egyéni témakörökhöz, rendszertémakörökhöz és tartományokhoz – elérhető beállításokat mutatja be.

Diagnosztikai beállítás Event Grid-témakörök Event Grid rendszertémakörök Eseménytartományok Event Grid-partnernévterek
DeliveryFailures Igen Yes Yes Nem
PublishFailures Igen No Igen Igen
DataPlaneRequests Igen No Igen Igen

Fontos

A kézbesítési hibák sémáiról, a közzétételi hibákról és az adatsík-kérelmekről a diagnosztikai naplókban olvashat.

Előfeltételek

  • Kiépített Event Grid-erőforrás
  • Kiépített célhely a diagnosztikai naplók rögzítéséhez:
    • Log Analytics-munkaterület
    • Storage account
    • Event Hubs
    • Partnermegoldás

Diagnosztikai naplók engedélyezése Event Grid-témakörökhöz és tartományokhoz

Megjegyzés:

Az alábbi eljárás részletes útmutatást nyújt a diagnosztikai naplók témakörökhöz való engedélyezéséhez. A diagnosztikai naplók tartományhoz való engedélyezésének lépései nagyon hasonlóak. A 2. lépésben lépjen az Event Grid tartományra az Azure Portalon.

  1. Jelentkezzen be az Azure Portalra.

  2. Keresse meg azt az Event Grid-témakört, amelyhez engedélyezni szeretné a diagnosztikai napló beállításait.

    1. A felső keresősávon keresse meg az Event Grid-témaköröket.

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

    2. Válassza ki azt a témakört a listából, amelyhez diagnosztikai beállításokat szeretne konfigurálni.

  3. A bal oldali menü Figyelés területén válassza a Diagnosztikai beállítások lehetőséget.

  4. A Diagnosztikai beállítások lapon válassza az Új diagnosztikai beállítás hozzáadása lehetőséget.

    Screenshots showing the Diagnostic settings page of a custom topic.

  5. Adja meg a diagnosztikai beállítás nevét.

  6. Válassza az allLogs lehetőséget a Naplók szakaszban.

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

  7. Engedélyezze egy vagy több rögzítési célhelyet a naplókhoz, majd konfigurálja őket egy korábbi létrehozott rögzítési erőforrás kiválasztásával.

    • Ha a Küldés a Log Analyticsbe lehetőséget választja, válassza a Log Analytics-munkaterületet.

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

    • Ha az Archiválás tárfiókba lehetőséget választja, válassza a Tárfiók – Konfigurálás lehetőséget, majd válassza ki a tárfiókot az Azure-előfizetésében.

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

    • Ha a Stream egy eseményközpontba lehetőséget választja, válassza az Event Hub – Konfigurálás lehetőséget, majd válassza ki az Event Hubs-névteret, az eseményközpontot és a hozzáférési szabályzatot.

      Screenshot that shows the

  8. Válassza a Mentés parancsot. Ezután a jobb sarokban lévő X elemet választva zárja be az oldalt.

  9. Most, a Diagnosztikai beállítások lapon ellenőrizze, hogy megjelenik-e egy új bejegyzés a Diagnosztikai Gépház táblában.

    Screenshot that shows the

A témakör összes metrikájának gyűjtését is engedélyezheti.

Diagnosztikai naplók engedélyezése Event Grid-rendszertémakörökhöz

  1. Jelentkezzen be az Azure Portalra.
  2. Keresse meg azt a rendszertémakört, amelyhez engedélyezni szeretné a diagnosztikai napló beállításait.
    1. A felső keresősávon keresse meg az Event Grid rendszertémaköröket. Search for system topics
    2. Válassza ki azt a rendszertémakört , amelyhez diagnosztikai beállításokat szeretne konfigurálni. Select system topic
  3. A bal oldali menü Figyelés területén válassza a Diagnosztikai beállítások lehetőséget, majd válassza a Diagnosztikai beállítás hozzáadása lehetőséget. Add diagnostic settings - button
  4. Adja meg a diagnosztikai beállítás nevét.
  5. Válassza az allLogs lehetőséget a Naplók szakaszban. Select delivery failures
  6. Engedélyezze egy vagy több rögzítési célhelyet a naplókhoz, majd konfigurálja őket egy korábbi létrehozott rögzítési erőforrás kiválasztásával.
    • Ha a Küldés a Log Analyticsbe lehetőséget választja, válassza a Log Analytics-munkaterületet. Send to Log Analytics
    • Ha az Archiválás tárfiókba lehetőséget választja, válassza a Tárfiók – Konfigurálás lehetőséget, majd válassza ki a tárfiókot az Azure-előfizetésében. Archive to an Azure storage account
    • Ha a Stream egy eseményközpontba lehetőséget választja, válassza az Event Hub – Konfigurálás lehetőséget, majd válassza ki az Event Hubs-névteret, az eseményközpontot és a hozzáférési szabályzatot. Stream to an event hub
  7. Válassza a Mentés parancsot. Ezután a jobb sarokban lévő X elemet választva zárja be az oldalt.
  8. Most, a Diagnosztikai beállítások lapon ellenőrizze, hogy megjelenik-e egy új bejegyzés a Diagnosztikai Gépház táblában. Diagnostic setting in the list

A rendszertéma összes metrikájának gyűjtését is engedélyezheti. System topic - enable all metrics

Diagnosztikai naplók megtekintése az Azure Storage-ban

  1. Miután engedélyezte a tárfiókot rögzítési célhelyként, az Event Grid megkezdi a diagnosztikai naplók kibocsátását. A tárfiókban új, insights-logs-deliveryfailures és insights-logs-publishfailures nevű tárolóknak kell megjelennie.

    Storage - containers for diagnostic logs

  2. Az egyik tárolóban való navigálás során egy JSON formátumú blobba kerül. A fájl egy kézbesítési vagy közzétételi hibához tartozó naplóbejegyzéseket tartalmaz. A navigációs útvonal az Event Grid-témakör ResourceId azonosítóját és a naplóbejegyzések kibocsátásának időbélyegét (percszint) jelöli. A letölthető blob-/JSON-fájl a következő szakaszban ismertetett sémához igazodik.

    JSON file in the storage

  3. A JSON-fájl tartalma az alábbi példához hasonlóan jelenik meg:

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

Az Azure Resource Manager sablonjainak használata

Íme egy minta Azure Resource Manager-sablon az Event Grid-témakör diagnosztikai beállításainak engedélyezéséhez. A mintasablon üzembe helyezésekor a következő erőforrások jönnek létre.

  • Event Grid-témakör
  • Log Analytics-munkaterület

Ezután létrehoz egy diagnosztikai beállítást a témakörben, amely diagnosztikai információkat küld a Log Analytics-munkaterületnek.

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

Diagnosztikai naplók engedélyezése naplózási nyomkövetésekhez

Az Event Grid naplókövetéseket tehet közzé adatsík-műveletekhez. A funkció engedélyezéséhez válassza a Naplózás lehetőséget a Kategóriacsoportok szakaszban, vagy válassza a DataPlaneRequests lehetőséget a Kategóriák szakaszban.

A naplózási nyomkövetéssel biztosítható, hogy az adathozzáférés csak engedélyezett célokra legyen engedélyezve. Információkat gyűjt a biztonsági vezérlésről, például az erőforrás nevéről, a művelet típusáról, a hálózati hozzáférésről, a szintről, a régióról és egyebekről. A diagnosztikai beállítás engedélyezéséről további információt az Event Grid-témakörökben és eseménytartományokban található diagnosztikai naplókban talál. Screenshot that shows the Diagnostic settings page with Audit selected.

Fontos

A sémával kapcsolatos további információkért lásd a DataPlaneRequests diagnosztikai naplókat.

Következő lépések

A naplóséma és a témakörök vagy tartományok diagnosztikai naplóinak egyéb fogalmi információiért lásd a diagnosztikai naplókat.