Skicka data från Windows Azure-diagnostiktillägget till Azure Event Hubs

Artikel
11/14/2024

Azure Diagnostics-tillägget är en agent i Azure Monitor som samlar in övervakningsdata från gästoperativsystemet och arbetsbelastningar för virtuella Azure-datorer och andra beräkningsresurser. Den här artikeln beskriver hur du skickar data från WAD-tillägget (Windows Azure Diagnostic) till Azure Event Hubs så att du kan vidarebefordra till platser utanför Azure.

Data som stöds

De data som samlas in från gästoperativsystemet som kan skickas till Event Hubs innehåller följande. Andra datakällor som samlas in av WAD, inklusive IIS-loggar och kraschdumpar, kan inte skickas till Event Hubs.

ETW-händelser (Event Tracing for Windows)
Prestandaräknare
Windows-händelseloggar, inklusive programloggar i Windows-händelseloggen
Azure Diagnostics-infrastrukturloggar

Förutsättningar

Windows-diagnostiktillägg 1.6 eller senare. Se Konfigurationsschemaversioner och historik för Azure Diagnostics-tillägg för en översikt över versionshistorik och Azure Diagnostics-tillägg för resurser som stöds.
Event Hubs-namnområdet måste alltid etableras. Mer information finns i Kom igång med Event Hubs.
Händelsehubben måste vara minst standardnivå. Basic-nivån stöds inte.

Konfigurationsschema

Se Installera och konfigurera Windows Azure-diagnostiktillägg (WAD) för olika alternativ för att aktivera och konfigurera diagnostiktillägget och Azure Diagnostics-konfigurationsschemat för en referens till konfigurationsschemat. Resten av den här artikeln beskriver hur du använder den här konfigurationen för att skicka data till en händelsehubb.

Azure Diagnostics skickar alltid loggar och mått till ett Azure Storage-konto. Du kan konfigurera en eller flera datamottagare som skickar data till ytterligare platser. Varje mottagare definieras i sinksConfig-elementet i den offentliga konfigurationen med känslig information i den privata konfigurationen. Den här konfigurationen för händelsehubbar använder värdena i följande tabell.

Property	Beskrivning
Name	Beskrivande namn för mottagaren. Används i konfigurationen för att ange vilka datakällor som ska skickas till mottagaren.
URL	Url för händelsehubben i formatet <event-hubs-namespace.servicebus.windows.net/>< event-hub-name>.
SharedAccessKeyName	Namn på en princip för delad åtkomst för händelsehubben som har minst Skicka utfärdare.
SharedAccessKey	Primär eller sekundär nyckel från principen för delad åtkomst för händelsehubben.

Exempel på offentliga och privata konfigurationer visas nedan. Det här är en minimal konfiguration med en enda prestandaräknare och händelselogg för att illustrera hur du konfigurerar och använder händelsehubbens datamottagare. Ett mer komplext exempel finns i Konfigurationsschema för Azure Diagnostics.

Offentlig konfiguration

{
    "WadCfg": {
        "DiagnosticMonitorConfiguration": {
            "overallQuotaInMB": 5120,
            "PerformanceCounters": {
                "scheduledTransferPeriod": "PT1M",
                "sinks": "myEventHub",
                "PerformanceCounterConfiguration": [
                    {
                        "counterSpecifier": "\\Processor(_Total)\\% Processor Time",
                        "sampleRate": "PT3M"
                    }
                ]
            },
            "WindowsEventLog": {
                "scheduledTransferPeriod": "PT1M",
                "sinks": "myEventHub",
                    "DataSource": [
                    {
                        "name": "Application!*[System[(Level=1 or Level=2 or Level=3)]]"
                    }
                ]
            }
        },
        "SinksConfig": {
            "Sink": [
                {
                    "name": "myEventHub",
                    "EventHub": {
                        "Url": "https://diags-mycompany-ns.servicebus.windows.net/diageventhub",
                        "SharedAccessKeyName": "SendRule"
                    }
                }
            ]
        }
    },
    "StorageAccount": "mystorageaccount",
}

Privat konfiguration

{
    "storageAccountName": "mystorageaccount",
    "storageAccountKey": "{base64 encoded key}",
    "storageAccountEndPoint": "https://core.windows.net",
    "EventHub": {
        "Url": "https://diags-mycompany-ns.servicebus.windows.net/diageventhub",
        "SharedAccessKeyName": "SendRule",
        "SharedAccessKey": "{base64 encoded key}"
    }
}

Konfigurationsalternativ

Om du vill skicka data till en datamottagare anger du attributet mottagare på datakällans nod. Var du placerar mottagarattributet avgör tilldelningens omfattning. I följande exempel definieras mottagarattributet till noden PerformanceCounters, vilket gör att alla underordnade prestandaräknare skickas till händelsehubben.

"PerformanceCounters": {
    "scheduledTransferPeriod": "PT1M",
    "sinks": "MyEventHub",
    "PerformanceCounterConfiguration": [
        {
            "counterSpecifier": "\\Processor(_Total)\\% Processor Time",
            "sampleRate": "PT3M"
        },
        {
            "counterSpecifier": "\\Memory\\Available MBytes",
            "sampleRate": "PT3M"
        },
        {
            "counterSpecifier": "\\Web Service(_Total)\\ISAPI Extension Requests/sec",
            "sampleRate": "PT3M"
        }
    ]
}

I följande exempel tillämpas mottagarattributet direkt på tre räknare, vilket gör att endast dessa prestandaräknare skickas till händelsehubben.

"PerformanceCounters": {
    "scheduledTransferPeriod": "PT1M",
    "PerformanceCounterConfiguration": [
        {
            "counterSpecifier": "\\Processor(_Total)\\% Processor Time",
            "sampleRate": "PT3M",
            "sinks": "MyEventHub"
        },
        {
            "counterSpecifier": "\\Memory\\Available MBytes",
            "sampleRate": "PT3M"
        },
        {
            "counterSpecifier": "\\Web Service(_Total)\\ISAPI Extension Requests/sec",
            "sampleRate": "PT3M"
        },
        {
            "counterSpecifier": "\\ASP.NET\\Requests Rejected",
            "sampleRate": "PT3M",
            "sinks": "MyEventHub"
        },
        {
            "counterSpecifier": "\\ASP.NET\\Requests Queued",
            "sampleRate": "PT3M",
            "sinks": "MyEventHub"
        }
    ]
}

Verifiera konfiguration

Du kan använda en mängd olika metoder för att verifiera att data skickas till händelsehubben. En enkel metod är att använda Event Hubs Capture enligt beskrivningen i Avbilda händelser via Azure Event Hubs i Azure Blob Storage eller Azure Data Lake Storage.

Felsöka Event Hubs-mottagare

Titta på Azure Storage-tabellen WADDiagnosticInfrastructureLogsTable som innehåller loggar och fel för själva Azure Diagnostics. Ett alternativ är att använda ett verktyg som Azure Storage Explorer för att ansluta till det här lagringskontot, visa den här tabellen och lägga till en fråga för TimeStamp under de senaste 24 timmarna. Du kan använda verktyget för att exportera en .csv fil och öppna den i ett program som Microsoft Excel. Excel gör det enkelt att söka efter kortsträngar för samtal, till exempel EventHubs, för att se vilket fel som rapporteras.
Kontrollera att händelsehubben har etablerats. All anslutningsinformation i avsnittet PrivateConfig i konfigurationen måste matcha värdena för resursen enligt portalen. Kontrollera att du har definierat en SAS-princip (SendRule i exemplet) i portalen och att Behörigheten Skicka har beviljats.

Dela via