Aktivera diagnostikloggar för Event Grid-resurser

Den här artikeln innehåller stegvisa instruktioner för att aktivera diagnostikinställningar för Event Grid-resurser. Diagnostikinställningar samlar in information om publicerings- och leveransfel så att du kan diagnostisera och felsöka problem med dina Event Grid-resurser. Följande tabell visar de inställningar som finns tillgängliga för olika typer av Event Grid-resurser: anpassade ämnen, systemämnen och domäner.

Diagnostikinställning Event Grid-ämnen Avsnitt om Event Grid-system Händelsedomäner Event Grid-partnernamnområden
DeliveryFailures Ja Ja Ja Nej
PublishFailures Ja Nej Ja Ja
DataPlaneRequests Ja Nej Ja Ja

Viktigt!

Scheman för leveransfel, publiceringsfel och dataplansbegäranden finns i Diagnostikloggar.

Förutsättningar

  • En etablerad Event Grid-resurs
  • Ett etablerat mål för insamling av diagnostikloggar:
    • Log Analytics-arbetsyta
    • Lagringskonto
    • Event Hubs
    • Partnerlösning

Aktivera diagnostikloggar för Event Grid-ämnen och domäner

Kommentar

Följande procedur innehåller stegvisa instruktioner för att aktivera diagnostikloggar för ämnen. Stegen för att aktivera diagnostiska loggar för en domän är liknande. I steg 2 går du till Event Grid-domänen i Azure Portal.

  1. Logga in på Azure-portalen.

  2. Gå till avsnittet Event Grid som du vill aktivera diagnostiklogginställningar för.

    1. Sök efter Event Grid-ämnen i sökfältet längst upp.

      Skärmbild som visar Azure Portal med Event Grid-ämnen i sökrutan.

    2. Välj det ämne i listan som du vill konfigurera diagnostikinställningar för.

  3. Välj Diagnostikinställningar under Övervakning på den vänstra menyn.

  4. På sidan Diagnostikinställningar väljer du Lägg till diagnostikinställning.

    Skärmdump som visar sidan för diagnostikinställningar för ett anpassat ämne.

  5. Ange ett namn för diagnostikinställningen.

  6. Välj alternativet allLogs i avsnittet Loggar.

    Skärmbild som visar sidan Diagnostikinställning med Alla loggar markerade.

  7. Aktivera en eller flera av inspelningsdestinationerna för loggarna och konfigurera dem sedan genom att välja en tidigare skapad inspelningsresurs.

    • Om du väljer Skicka till Log Analytics väljer du Log Analytics-arbetsytan.

      Skärmbild som visar sidan Diagnostikinställningar med Skicka till Log Analytics valt.

    • Om du väljer Arkivera till ett lagringskonto väljer du Lagringskonto – Konfigurera och väljer sedan lagringskontot i din Azure-prenumeration.

      Skärmbild som visar sidan Diagnostikinställningar med Arkiv till ett Azure Storage-konto markerat och ett valt lagringskonto.

    • Om du väljer Stream till en händelsehubb väljer du Händelsehubb – Konfigurera och sedan Event Hubs-namnområdet, händelsehubben och åtkomstprincipen.

      Skärmdump som visar sidan för diagnostikinställningar med Stream till en event hub vald.

  8. Välj Spara. Välj sedan X i det övre högra hörnet för att stänga sidan.

  9. Tillbaka på sidan för Diagnostikinställningar , bekräfta att du ser en ny post i tabellen Diagnostikinställningar .

    Skärmdump som visar sidan för Diagnostikinställningar med en ny post markerad i tabellen Diagnostikinställningar.

Du kan också aktivera insamling av alla mått för ämnet.

Aktivera diagnostikloggar för Event Grid-systemämnen

  1. Logga in på Azure-portalen.

  2. Gå till systemämnet där du vill aktivera inställningar för diagnostikloggar.

    1. I sökfältet längst upp söker du efter Event Grid-systemämnen.

      Skärmdump som visar Azure-portalen med Event Grid-systemämnen i sökrutan.

    2. Välj systemämnet där du vill konfigurera diagnostiska inställningar.

      Skärmdump som visar listan över Event Grid-systemämnen.

  3. Välj Diagnostikinställningar under Övervakning på den vänstra menyn och välj sedan Lägg till diagnostikinställning.

    Skärmdump som visar sidan för diagnostiska inställningar för ett systemämne med knappen Lägg till diagnostik.

  4. Ange ett namn för diagnostikinställningen.

  5. Välj alternativet allLogs i avsnittet Loggar.

    Skärmdump som visar sidan för diagnostiska inställningar för ett systemämne med Alla loggar valda.

  6. Aktivera en eller flera av inspelningsdestinationerna för loggarna och konfigurera dem sedan genom att välja en tidigare skapad inspelningsresurs.

    • Om du väljer Skicka till Log Analytics väljer du Log Analytics-arbetsytan.

      Skärmdump som visar sidan Diagnostikinställningar för ett systemämne med Send to Log Analytics valt.

    • Om du väljer Arkivera till ett lagringskonto väljer du Lagringskonto – Konfigurera och väljer sedan lagringskontot i din Azure-prenumeration.

      Skärmdump som visar sidan Diagnostikinställningar för ett systemämne med Arkiv till ett valt lagringskonto.

    • Om du väljer Stream till en händelsehubb väljer du Händelsehubb – Konfigurera och sedan Event Hubs-namnområdet, händelsehubben och åtkomstprincipen.

      Skärmdump som visar sidan för diagnostikinställningar för ett systemämne med Stream till en händelsehubb vald.

  7. Välj Spara. Välj sedan X i det övre högra hörnet för att stänga sidan.

  8. Tillbaka på sidan för Diagnostikinställningar , bekräfta att du ser en ny post i tabellen Diagnostikinställningar .

    Skärmdump som visar sidan för diagnostiska inställningar för ett systemämne med en ny post i tabellen.

Du kan också aktivera insamling av alla mätvärden för systemämnet.

Skärmdump som visar sidan för diagnostiska inställningar för ett systemämne med alla mätvärden valda.

Visa diagnostikloggar i Azure Storage

  1. När du aktiverar ett lagringskonto som inspelningsdestination börjar Event Grid sända diagnostiska loggar. Du ser nya containrar som heter insights-logs-deliveryfailures och insights-logs-publishfailures i lagringskontot.

    Skärmdump som visar lagringskontots containrar för diagnostiska loggar.

  2. När du navigerar genom en av containrarna når du en blob i JSON-format. Filen innehåller loggposter för antingen ett leveransfel eller ett publiceringsfel. Navigationsvägen representerar ResourceId för Event Grid-ämnet och tidsstämpeln (minutnivå) när Event Grid skickade loggposterna. Blob/JSON-filen, som du kan ladda ner, följer schemat som beskrivs i nästa avsnitt.

    Skärmdump som visar en JSON-blobfil i lagringskontot.

  3. Du ser innehåll i JSON-filen liknande följande exempel:

    {
        "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=SAMPLE-TOPIC-NAME.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://sample-namespace.servicebus.windows.net/, deliveryResponse=NotFound: The messaging entity 'sb://sample-namespace.servicebus.windows.net/sample-eventhub' could not be found. TrackingId:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_G14, SystemTracker:sample-namespace.servicebus.windows.net:sample-eventhub, Timestamp:2019-11-01T00:17:13, referenceId: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_G14:"
    }
    

Använd Azure Resource Manager-mallar

Här är ett exempel på en Azure Resource Manager-mall för att aktivera diagnostikinställningar för ett Event Grid-ämne. När du distribuerar denna exempelmall skapar den följande resurser:

  • Ett Event Grid-ämne
  • En Log Analytics-arbetsyta

Sedan skapas en diagnostikinställning för ämnet för att skicka diagnostikinformation till Log Analytics-arbetsytan.

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

Aktivera diagnostikloggar för granskningsspårningar

Event Grid kan publicera granskningsloggar för åtgärder i dataplanet. Om du vill aktivera funktionen väljer du granska i avsnittet Kategorigrupper eller väljer DataPlaneRequests i avsnittet Kategorier .

Använd revisionsspårningen för att säkerställa att dataåtkomst endast tillåts för auktoriserade ändamål. Den samlar in information om säkerhetskontroller, såsom resursnamn, operationstyp, nätverksåtkomst, nivå och region. För mer information om hur man aktiverar diagnostikinställningen, se Aktivera diagnostiska loggar för Event Grid-ämnen och domäner.

Skärmdump som visar sidan för diagnostiska inställningar med Revision valt.

Viktigt!

Mer information om schemat finns i DataPlaneRequests Diagnostikloggar.

Nästa steg

Loggschemat och annan konceptuell information om diagnostikloggar för ämnen eller domäner finns i Diagnostikloggar.