Az Azure Event Hubs-adatok referenciáinak figyelése

  • Cikk

Az Azure Event Hubs monitorozási adatainak gyűjtésével és elemzésével kapcsolatos részletekért tekintse meg az Azure Event Hubs monitorozási adatait.

Feljegyzés

Az Azure Monitor nem tartalmaz dimenziókat az exportált metrikák adataiban, amelyeket olyan célhelyre küldenek, mint az Azure Storage, az Azure Event Hubs, a Log Analytics stb.

Mérőszámok

Ez a szakasz felsorolja az Azure Event Hubshoz gyűjtött összes automatikusan gyűjtött platformmetrikát. Ezeknek a metrikáknak az erőforrás-szolgáltatója a Microsoft.EventHub/clusters vagy a Microsoft.EventHub/namespaces.

Metrikák kérése

Megszámolja az adat- és felügyeleti műveleti kérelmek számát.

Metrika neve Diagnosztikai beállításokkal exportálható Unit (Egység) Összesítés típusa Leírás Dimenziók
Bejövő kérelmek Igen Darabszám Darabszám Az Event Hubs szolgáltatásnak adott időszakban küldött kérések száma. Ez a metrika az összes adat- és felügyeletisík-műveletet tartalmazza. Entitásnév
Sikeres kérelmek Nem Darabszám Darabszám Az Event Hubs szolgáltatásnak adott időszakban küldött sikeres kérések száma. Entitásnév

Művelet eredménye
Szabályozott kérelmek Nem Darabszám Darabszám A használat túllépése miatt szabályozott kérések száma. Entitásnév

Művelet eredménye

A rendszer a következő két hibatípust sorolja be felhasználói hibáknak:

  1. Ügyféloldali hibák (HTTP-ben ez 400 hiba lenne).
  2. Az üzenetek feldolgozása során előforduló hibák.

Üzenetmetrikák

Metrika neve Diagnosztikai beállításokkal exportálható Unit (Egység) Összesítés típusa Leírás Dimenziók
Bejövő üzenetek Igen Darabszám Darabszám Az Event Hubsnak adott időszakban küldött események vagy üzenetek száma. Entitásnév
Kimenő üzenetek Igen Darabszám Darabszám Az Event Hubstól egy adott időszakban fogadott események vagy üzenetek száma. Entitásnév
Rögzített üzenetek Nem Darabszám Darabszám A rögzített üzenetek száma. Entitásnév
Bejövő bájtok Igen Bájt Count Egy eseményközpont bejövő bájtjai egy adott időszakban. Entitásnév
Kimenő bájtok Igen Bájt Count Egy eseményközpont kimenő bájtjai egy adott időszakban. Entitásnév
Méret Nem Bájt Átlag Eseményközpont mérete bájtban. Entitásnév

Feljegyzés

  • Ezek az értékek időponthoz kötött értékek. Előfordulhat, hogy az adott időpont után közvetlenül felhasznált bejövő üzenetek nem jelennek meg ezekben a metrikákban.
  • A Bejövő kérelmek metrika tartalmazza az összes adat- és felügyeletisík-műveletet. A Bejövő üzenetek metrika az eseményközpontba küldött események teljes számát adja meg. Ha például 100 eseményt tartalmazó köteget küld egy eseményközpontba, az 1 bejövő kérésnek és 100 bejövő üzenetnek számít.

Metrikák rögzítése

Metrika neve Diagnosztikai beállításokkal exportálható Unit (Egység) Összesítés típusa Leírás Dimenziók
Rögzített üzenetek Nem Darabszám Darabszám A rögzített üzenetek száma. Entitásnév
Rögzített bájtok Nem Bájt Count Rögzített bájtok egy eseményközponthoz Entitásnév
Rögzítési hátralék Nem Darabszám Darabszám Eseményközpont hátralékának rögzítése Entitásnév

Csatlakozás ionmetrikák

Metrika neve Diagnosztikai beállításokkal exportálható Unit (Egység) Összesítés típusa Leírás Dimenziók
Aktív kapcsolatok Nem Count Átlag Egy névtéren és egy entitáson (eseményközponton) lévő aktív kapcsolatok száma a névtérben. A metrika értéke időponthoz kötött érték. Csatlakozás azok a Csatlakozás, amelyek közvetlenül az adott időpont után voltak aktívak, nem feltétlenül jelennek meg a metrikában. Entitásnév
megnyitott Csatlakozás ions Nem Count Átlag A nyitott kapcsolatok száma. Entitásnév
Csatlakozás ions Closed Nem Count Átlag A lezárt kapcsolatok száma. Entitásnév

Hibamutatók

Metrika neve Diagnosztikai beállításokkal exportálható Unit (Egység) Összesítés típusa Leírás Dimenziók
Kiszolgálóhibák Nem Darabszám Darabszám Az Event Hubs szolgáltatásban egy adott időszakban történt hiba miatt nem feldolgozott kérések száma. Entitásnév

Művelet eredménye
Felhasználói hibák Nem Darabszám Darabszám Azoknak a kérelmeknek a száma, amelyet egy adott időszak felhasználói hibái miatt nem dolgoztak fel. Entitásnév

Művelet eredménye
Kvótatúllépési hibák Nem Darabszám Darabszám A kvóták meghatározott időszakon keresztüli túllépése által okozott hibák száma. Entitásnév

Művelet eredménye

Feljegyzés

A Logic Apps rendszerállapot-fogadókat hoz létre, és a fogadók a szolgáltatás terhelésétől függően áthelyezhetők az egyik csomópontról a másikra. Ezekben az áthelyezések ReceiverDisconnection során kivételek léphetnek fel. Ezek felhasználói hibáknak számítanak az Event Hubs szolgáltatás oldalán. A Logic Apps összegyűjtheti az Event Hubs-ügyfelek hibáit, hogy ön megtekinthesse őket a felhasználói naplókban.

Metrikadimenziók

Az Azure Event Hubs az alábbi dimenziókat támogatja az Azure Monitor metrikáihoz. Nem kötelező dimenziókat hozzáadni a metrikákhoz. Ha nem ad hozzá dimenziókat, a rendszer a névtér szintjén adja meg a metrikákat.

Dimenzió neve Leírás
Entitás neve Az eseményközpont neve. A "Bejövő kérések" metrika esetén az Entitásnév dimenzió az összes eseményközpont mellett a "-NamespaceOnlyMetric" értékkel is rendelkezik. A névtér szintjén végrehajtott kéréseket jelöli. Ilyenek például a névtérben található összes eseményközpont listázására irányuló kérések, illetve a hitelesítést vagy engedélyezést sikertelen entitásokra irányuló kérések.

Erőforrásnaplók

Az Azure Event Hubs mostantól képes naplókat küldeni két céltáblára – Az Azure Diagnostic vagy az Erőforrás-specifikus táblák a Log Analyticsben. Az Azure Portalon elérhető kapcsolóval kiválaszthatja a céltáblákat.

Képernyőkép a céltábla beállítására szolgáló párbeszédpanelről.

Az Event Hubs a következő kategóriák diagnosztikai naplóit rögzíti:

Kategória Leírás
Archív naplók Rögzíti az Event Hubs Capture-műveletekkel kapcsolatos információkat, különösen a rögzítési hibákhoz kapcsolódó naplókat.
Működési naplók Rögzítse az Azure Event Hubs-névtéren végrehajtott összes felügyeleti műveletet. Az adatműveleteket nem rögzíti a rendszer, mert az Azure Event Hubsban nagy mennyiségű adatművelet történik.
Naplók automatikus méretezése Rögzíti az Event Hubs-névtéren végzett automatikus feltöltési műveleteket.
Kafka-koordinátor naplói Rögzíti az Event Hubshoz kapcsolódó Kafka-koordinátori műveleteket.
Kafka felhasználói hibanaplók Az Event Hubson hívott Kafka API-kkal kapcsolatos információkat rögzíti.
Event Hubs virtuális hálózati kapcsolat eseménye Az Event Hubsba forgalmat küldő IP-címekre és virtuális hálózatokra vonatkozó információkat rögzíti.
Ügyfél által felügyelt kulcs felhasználói naplói Rögzíti az ügyfél által felügyelt kulccsal kapcsolatos műveleteket.
Futásidejű naplózási naplók Az Event Hubs összes adatsík-hozzáférési műveletére (például események küldésére vagy fogadására) vonatkozó összesített diagnosztikai információk rögzítése.
Alkalmazásmetrikanaplók Rögzítse az adatsík-műveletekhez kapcsolódó egyes metrikák összesített adatait.

Minden napló JavaScript Object Notation (JSON) formátumban van tárolva. Minden bejegyzéshez a következő szakaszokban ismertetett formátumot használó karakterláncmezők vannak beírva.

Archiválási naplók sémája

Az archív napló JSON-sztringjei az alábbi táblázatban felsorolt elemeket tartalmazzák:

Név Leírás Az Azure Diagnosticsban támogatott Támogatott az AZMSArchiveLogs (Erőforrás-specifikus tábla)
TaskName A sikertelen tevékenység leírása Igen Igen
ActivityId Nyomon követéshez használt belső azonosító Igen Igen
trackingId Nyomon követéshez használt belső azonosító Igen Igen
resourceId Azure Resource Manager-erőforrás-azonosító igen Igen
eventHub Event Hub teljes neve (a névtér nevét is tartalmazza) Igen Nem
EventhubName Event Hub-entitás neve Nem Igen
partitionId Az Event Hub partíciója a következőre van megírva: Igen Igen
archiveStep lehetséges értékek: ArchiveFlushWriter, DestinationInit Igen Igen
startTime Hiba kezdési időpontja Igen Nem
Time Generated (UTC) A művelet időbélyege Nem Igen
failures A hiba előfordulásának száma Igen Igen
durationInSeconds A hiba időtartama Igen Igen
message Hibaüzenet Igen Igen
category Naplókategória Igen Nem
Provider A naplókat kibocsátó szolgáltatás neve, például Event Hubs Nem Igen
Type A kibocsátott napló típusa Nem Igen

Az alábbi kód egy archív napló JSON-sztringjének példája:

AzureDiagnostics:

{
   "TaskName": "EventHubArchiveUserError",
   "ActivityId": "000000000-0000-0000-0000-0000000000000",
   "trackingId": "0000000-0000-0000-0000-00000000000000000",
   "resourceId": "/SUBSCRIPTIONS/000000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs Namespace Name>",
   "eventHub": "<Event Hub full name>",
   "partitionId": "1",
   "archiveStep": "ArchiveFlushWriter",
   "startTime": "9/22/2016 5:11:21 AM",
   "failures": 3,
   "durationInSeconds": 360,
   "message": "Microsoft.WindowsAzure.Storage.StorageException: The remote server returned an error: (404) Not Found. ---> System.Net.WebException: The remote server returned an error: (404) Not Found.\r\n   at Microsoft.WindowsAzure.Storage.Shared.Protocol.HttpResponseParsers.ProcessExpectedStatusCodeNoException[T](HttpStatusCode expectedStatusCode, HttpStatusCode actualStatusCode, T retVal, StorageCommandBase`1 cmd, Exception ex)\r\n   at Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob.<PutBlockImpl>b__3e(RESTCommand`1 cmd, HttpWebResponse resp, Exception ex, OperationContext ctx)\r\n   at Microsoft.WindowsAzure.Storage.Core.Executor.Executor.EndGetResponse[T](IAsyncResult getResponseResult)\r\n   --- End of inner exception stack trace ---\r\n   at Microsoft.WindowsAzure.Storage.Core.Util.StorageAsyncResult`1.End()\r\n   at Microsoft.WindowsAzure.Storage.Core.Util.AsyncExtensions.<>c__DisplayClass4.<CreateCallbackVoid>b__3(IAsyncResult ar)\r\n--- End of stack trace from previous location where exception was thrown ---\r\n   at System.",
   "category": "ArchiveLogs"
}

Erőforrás-specifikus táblabejegyzés:

{
   "TaskName": "EventHubArchiveUserError",
   "ActivityId": "000000000-0000-0000-0000-0000000000000",
   "trackingId": "0000000-0000-0000-0000-00000000000000000",
   "resourceId": "/SUBSCRIPTIONS/000000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs Namespace Name>",
   "EventHubName": "<Event Hub full name>",
   "partitionId": "1",
   "archiveStep": "ArchiveFlushWriter",
   "TimeGenerated(UTC)": "9/22/2016 5:11:21 AM",
   "failures": 3,
   "durationInSeconds": 360,
   "message": "Microsoft.WindowsAzure.Storage.StorageException: The remote server returned an error: (404) Not Found. ---> System.Net.WebException: The remote server returned an error: (404) Not Found.\r\n   at Microsoft.WindowsAzure.Storage.Shared.Protocol.HttpResponseParsers.ProcessExpectedStatusCodeNoException[T](HttpStatusCode expectedStatusCode, HttpStatusCode actualStatusCode, T retVal, StorageCommandBase`1 cmd, Exception ex)\r\n   at Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob.<PutBlockImpl>b__3e(RESTCommand`1 cmd, HttpWebResponse resp, Exception ex, OperationContext ctx)\r\n   at Microsoft.WindowsAzure.Storage.Core.Executor.Executor.EndGetResponse[T](IAsyncResult getResponseResult)\r\n   --- End of inner exception stack trace ---\r\n   at Microsoft.WindowsAzure.Storage.Core.Util.StorageAsyncResult`1.End()\r\n   at Microsoft.WindowsAzure.Storage.Core.Util.AsyncExtensions.<>c__DisplayClass4.<CreateCallbackVoid>b__3(IAsyncResult ar)\r\n--- End of stack trace from previous location where exception was thrown ---\r\n   at System.",
   "Provider":"EVENTHUB",
   "Type":"AZMSArchiveLogs"
}

Működési naplók sémája

Az operatív napló JSON-sztringjei az alábbi táblázatban felsorolt elemeket tartalmazzák:

Név Leírás Az AzureDiagnosticsben támogatott Támogatott az AZMSOperationalLogs (Erőforrás-specifikus tábla)
ActivityId Nyomon követés céljából használt belső azonosító Igen Igen
EventName A művelet neve. Az elem értékeinek listájáért tekintse meg az eseményneveket Igen Igen
resourceId Azure Resource Manager-erőforrás-azonosító Igen Igen
SubscriptionId Előfizetés azonosítója Igen Igen
EventTimeString Műveleti idő Igen Nem
Time Generated (UTC) A művelet időbélyege Nem Igen
EventProperties A művelet tulajdonságai. Ez az elem további információt nyújt az eseményről az alábbi példában látható módon. Igen Igen
Status Művelet állapota. Az érték lehet sikeres vagy sikertelen. Igen Igen
Caller A művelet hívója (Azure Portal vagy felügyeleti ügyfél) Igen Igen
Category Naplókategória Igen Nem
Provider A naplókat kibocsátó szolgáltatás neve, például Event Hubs Nem Igen
Type A kibocsátott naplók típusa Nem Igen

Az alábbi kód egy működési napló JSON-sztringjének példája:

AzureDiagnostics:

Example:
{
   "ActivityId": "00000000-0000-0000-0000-00000000000000",
   "EventName": "Create EventHub",
   "resourceId": "/SUBSCRIPTIONS/00000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace name>",
   "SubscriptionId": "000000000-0000-0000-0000-000000000000",
   "EventTimeString": "9/28/2016 8:40:06 PM +00:00",
   "EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-000000000000\",\"Namespace\":\"<Namespace Name>\",\"Via\":\"https://<Namespace Name>.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
   "Status": "Succeeded",
   "Caller": "ServiceBus Client",
   "category": "OperationalLogs"
}

Erőforrás-specifikus táblabejegyzés:

Example:
{
   "ActivityId": "00000000-0000-0000-0000-00000000000000",
   "EventName": "Create EventHub",
   "resourceId": "/SUBSCRIPTIONS/00000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace name>",
   "SubscriptionId": "000000000-0000-0000-0000-000000000000",
   "TimeGenerated (UTC)": "9/28/2016 8:40:06 PM +00:00",
   "EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-000000000000\",\"Namespace\":\"<Namespace Name>\",\"Via\":\"https://<Namespace Name>.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
   "Status": "Succeeded",
   "Caller": "ServiceBus Client",
   "Provider": "EVENTHUB",
   "Type":"AZMSOperationalLogs"
}

Eseménynevek

Az esemény neve művelettípusként és erőforrástípusként van kitöltve az alábbi felsorolásokból. Például, Create Queuevagy Retrieve Event HubDelete Rule.

Művelettípus Erőforrás típusa
-Létrehozása
-Frissítés
-Töröl
-Elhoz
-Ismeretlen		 -Névtér
-Várólista
-Téma
-Előfizetés
- Event Hubs
- SharedAccessPolicy
- UsageCredit
-Szabály
- ConsumerGroup

Naplók automatikus méretezési sémája

Az automatikus skálázási napló JSON-tartalma az alábbi táblázatban felsorolt elemeket tartalmazza:

Név Leírás Az Azure Diagnosticsban támogatott Támogatott az AZMSAutoscaleLogs (Erőforrás-specifikus tábla)
TrackingId Nyomkövetési célokra használt belső azonosító Igen Igen
ResourceId Azure Resource Manager-erőforrás-azonosító. Igen Igen
Message Tájékoztató üzenet, amely részletesen ismerteti az automatikus feltöltési műveletet. Az üzenet egy adott névtér átviteli sebességegységének korábbi és aktuális értékét tartalmazza, és azt, hogy mi váltotta ki a TU felfújását. Igen Igen
Time Generated (UTC) A művelet időbélyege Nem Igen
Provider A naplókat kibocsátó szolgáltatás neve, például Event Hubs Nem Igen
Type A kibocsátott naplók típusa Nem Igen

Íme egy példa automatikus skálázási eseményre:

AzureDiagnostics:

{
    "TrackingId": "fb1b3676-bb2d-4b17-85b7-be1c7aa1967e",
    "Message": "Scaled-up EventHub TUs (UpdateStartTimeUTC: 5/13/2021 7:48:36 AM, PreviousValue: 1, UpdatedThroughputUnitValue: 2, AutoScaleReason: 'IncomingMessagesPerSecond reached 2170')",
    "ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name"
}

Erőforrás-specifikus táblabejegyzés:

{
    "TrackingId": "fb1b3676-bb2d-4b17-85b7-be1c7aa1967e",
    "Message": "Scaled-up EventHub TUs (UpdateStartTimeUTC: 5/13/2021 7:48:36 AM, PreviousValue: 1, UpdatedThroughputUnitValue: 2, AutoScaleReason: 'IncomingMessagesPerSecond reached 2170')",
    "ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
    "timeGenerated (UTC) : "9/28/2022 8:40:06 PM +00:00",
    "Provider" : "EVENTHUB",
    "Type" : "AZMSAutoscaleLogs"
}

Kafka-koordinátor naplóinak sémája

A Kafka-koordinátor naplójának JSON-ja az alábbi táblázatban felsorolt elemeket tartalmazza:

Név Leírás Az Azure Diagnosticsban támogatott Támogatott az AZMSKafkaCoordinatorLogs (Erőforrás-specifikus tábla)
RequestId Nyomkövetési célokra használt kérelemazonosító Igen Igen
ResourceId Azure Resource Manager-erőforrás-azonosító Igen Igen
Operation A csoportkoordináció során végrehajtott művelet neve Igen Igen
ClientId Ügyfél azonosítója Igen Igen
NamespaceName Névtér neve Igen Igen
SubscriptionId Azure-előfizetés azonosítója Igen Igen
Message Tájékoztató vagy figyelmeztető üzenet, amely részletesen ismerteti a csoportkoordináció során végrehajtott műveleteket. Igen Igen
Time Generated (UTC) A művelet időbélyege Nem Igen
Provider A naplókat kibocsátó szolgáltatás neve, például ServiceBus Nem Igen
Type A kibocsátott napló típusa Nem Igen

Példa

AzureDiagnostics:

{
    "RequestId": "FE01001A89E30B020000000304620E2A_KafkaExampleConsumer#0",
    "Operation": "Join.Start",
    "ClientId": "KafkaExampleConsumer#0",
    "Message": "Start join group for new member namespace-name:c:$default:I:KafkaExampleConsumer#0-cc40856f7f3c4607915a571efe994e82, current group size: 0, API version: 2, session timeout: 10000ms, rebalance timeout: 300000ms.",
    "SubscriptionId": "0000000-0000-0000-0000-000000000000",
    "NamespaceName": "namespace-name",
    "ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
    "Category": "KafkaCoordinatorLogs"
}

Erőforrás-specifikus táblabejegyzés:

{
    "RequestId": "FE01001A89E30B020000000304620E2A_KafkaExampleConsumer#0",
    "Operation": "Join.Start",
    "ClientId": "KafkaExampleConsumer#0",
    "Message": "Start join group for new member namespace-name:c:$default:I:KafkaExampleConsumer#0-cc40856f7f3c4607915a571efe994e82, current group size: 0, API version: 2, session timeout: 10000ms, rebalance timeout: 300000ms.",
    "SubscriptionId": "0000000-0000-0000-0000-000000000000",
    "NamespaceName": "namespace-name",
    "ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
    "Time Generated (UTC) ": "9/28/2022 8:40:06 PM +00:00", 
    "Provider" : "EVENTHUB",
    "Type" : "AZMSKafkaCoordinatorLogs"
}

Kafka felhasználói hibanaplók sémája

A Kafka felhasználói hibanapló JSON-ja az alábbi táblázatban felsorolt elemeket tartalmazza:

Név Leírás Az Azure Diagnosticsban támogatott Támogatott az AZMSKafkaUserErrorLogs (Erőforrás-specifikus tábla)
TrackingId Nyomkövetési célokra használt nyomkövetési azonosító. Igen Igen
NamespaceName Névtér neve Igen Igen
Eventhub Eseményközpont neve Igen Igen
PartitionId Partícióazonosító Igen Igen
GroupId Csoportazonosító Igen Igen
ClientId Ügyfél azonosítója Igen Igen
ResourceId Azure Resource Manager-erőforrás-azonosító. Igen Igen
Message Tájékoztató üzenet, amely egy hiba részleteit tartalmazza Igen Igen
TimeGenerated (UTC) Végrehajtott művelet időbélyege Nem Igen
Provider A naplókat kibocsátó szolgáltatás neve, például Event Hubs Nem Igen
Type A kibocsátott napló típusa NEM Igen

Event Hubs virtuális hálózati kapcsolat eseményséma

Az Event Hubs virtuális hálózat (virtuális hálózat) kapcsolati eseményének JSON-eseménye az alábbi táblázatban felsorolt elemeket tartalmazza:

Név Leírás Az Azure Diagnosticsban támogatott Támogatott az AZMSVNet Csatlakozás ionevents (Erőforrás-specifikus tábla)
SubscriptionId Azure-előfizetés azonosítója Igen Igen
NamespaceName Névtér neve Igen Igen
IPAddress Az Event Hubs szolgáltatáshoz csatlakozó ügyfél IP-címe Igen Igen
Action Az Event Hubs szolgáltatás által végzett művelet a kapcsolatkérések kiértékelésekor. A támogatott műveletek a Accept Csatlakozás ion és a Deny Csatlakozás ion . Igen Igen
Reason A művelet végrehajtásának okát adja meg Igen Nem
Message A művelet végrehajtásának okát adja meg Nem Igen
Count Az adott művelet előfordulásainak száma Igen Igen
ResourceId Azure Resource Manager-erőforrás-azonosító. Igen Igen
Time Generated (UTC) A művelet időbélyege Nem Igen
Provider A naplókat kibocsátó szolgáltatás neve, például ServiceBus Nem Igen
Type AZMSVNet Csatlakozás ionevents Nem Igen

A virtuális hálózati naplók csak akkor jönnek létre, ha a névtér lehetővé teszi a hozzáférést a kiválasztott hálózatokról vagy adott IP-címekről (IP-szűrési szabályok). Ha nem szeretné korlátozni a névtérhez való hozzáférést ezekkel a funkciókkal, és továbbra is szeretné lekérni a virtuális hálózati naplókat az Event Hubs-névtérhez csatlakozó ügyfelek IP-címeinek nyomon követéséhez, használhatja az alábbi kerülő megoldást. Engedélyezze az IP-szűrést, és adja hozzá a teljes címzhető IPv4-tartományt (128.0.0.0/1 - 0.0.0.0/1) és az IPv6-tartományt ().::/1 - 8000::/1 Az Event Hubs IP-szűrése nem támogatja az IPv6-tartományokat. Előfordulhat, hogy a privát végpontcímek IPv6 formátumban láthatók a naplóban.

Példa

AzureDiagnostics:

{
    "SubscriptionId": "0000000-0000-0000-0000-000000000000",
    "NamespaceName": "namespace-name",
    "IPAddress": "1.2.3.4",
    "Action": "Deny Connection",
    "Reason": "IPAddress doesn't belong to a subnet with Service Endpoint enabled.",
    "Count": "65",
    "ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
    "Category": "EventHubVNetConnectionEvent"
}

Erőforrás-specifikus táblabejegyzés:

{
    "SubscriptionId": "0000000-0000-0000-0000-000000000000",
    "NamespaceName": "namespace-name",
    "IPAddress": "1.2.3.4",
    "Action": "Deny Connection",
    "Message": "IPAddress doesn't belong to a subnet with Service Endpoint enabled.",
    "Count": "65",
    "ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
    "Provider": "EVENTHUB",
    "Time Generated (UTC) ": "9/28/2022 8:40:06 PM +00:00",
    "Type" : "AZMSKafkauserErrorlogs"
     
}

Ügyfél által felügyelt kulcs felhasználói naplóinak sémája

Az ügyfél által felügyelt kulcsfelhasználói napló JSON-fájlja az alábbi táblázatban felsorolt elemeket tartalmazza:

Név Leírás Az Azure Diagnosticsban támogatott Támogatott az AZMSCustomerManagedKeyUserLogs (Erőforrás-specifikus tábla)
Category Az üzenet kategóriáinak típusa. Ez az alábbi értékek egyike: hiba és információ. Ha például a kulcstartóban lévő kulcs le van tiltva, akkor az egy információkategória lenne, vagy ha egy kulcs nem írható fel, akkor hiba lehet. Igen Igen
ResourceId Belső erőforrás-azonosító, amely magában foglalja az Azure-előfizetés azonosítóját és a névtér nevét Igen Igen
KeyVault A Key Vault-erőforrás neve Igen Igen
Key Az Event Hubs-névtér titkosításához használt Key Vault-kulcs neve. Igen Igen
Version A Key Vault-kulcs verziója. Igen Igen
Operation A kulcstartó kulcsán végrehajtott művelet. Tiltsa le/engedélyezze például a kulcsot, a körbefuttatást vagy a kicsomagolást. Igen Igen
Code A művelethez társított kód. Például: A 404 hibakód azt jelenti, hogy a kulcs nem található. Igen Igen
Message Hibaüzenet, amely egy hiba vagy tájékoztató üzenet részleteit tartalmazza Igen Igen
Time Generated (UTC) A művelet időbélyege Nem Igen
Provider A naplókat kibocsátó szolgáltatás neve, például ServiceBus Nem Igen
Type A kibocsátott napló típusa Nem Igen

Íme egy példa egy ügyfél által felügyelt kulcs naplójára:

AzureDiagnostics:

{
   "TaskName": "CustomerManagedKeyUserLog",
   "ActivityId": "11111111-1111-1111-1111-111111111111",
   "category": "error"
   "resourceId": "/SUBSCRIPTIONS/11111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
   "keyVault": "https://mykeyvault.vault-int.azure-int.net",
   "key": "mykey",
   "version": "1111111111111111111111111111111",
   "operation": "wrapKey",
   "code": "404",
   "message": "Key not found: ehbyok0/111111111111111111111111111111"
}
{
   "TaskName": "CustomerManagedKeyUserLog",
   "ActivityId": "11111111111111-1111-1111-1111111111111",
   "category": "info"
   "resourceId": "/SUBSCRIPTIONS/111111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
   "keyVault": "https://mykeyvault.vault-int.azure-int.net",
   "key": "mykey",
   "version": "111111111111111111111111111111",
   "operation": "disable | restore",
   "code": "",
   "message": ""
}

Erőforrás-specifikus táblabejegyzés:

{
   "TaskName": "CustomerManagedKeyUserLog",
   "ActivityId": "11111111-1111-1111-1111-111111111111",
   "category": "error"
   "resourceId": "/SUBSCRIPTIONS/11111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
   "keyVault": "https://mykeyvault.vault-int.azure-int.net",
   "key": "mykey",
   "version": "1111111111111111111111111111111",
   "operation": "wrapKey",
   "code": "404",
   "message": "Key not found: ehbyok0/111111111111111111111111111111",
   "Provider": "EVENTHUB",
   "Time Generated (UTC) ": "9/28/2022 8:40:06 PM +00:00",
   "Type" : "AZMSCustomerManagedKeyUserLogs"
}
{
   "TaskName": "CustomerManagedKeyUserLog",
   "ActivityId": "11111111111111-1111-1111-1111111111111",
   "category": "info"
   "resourceId": "/SUBSCRIPTIONS/111111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
   "keyVault": "https://mykeyvault.vault-int.azure-int.net",
   "key": "mykey",
   "version": "111111111111111111111111111111",
   "operation": "disable | restore",
   "code": "",
   "message": "",
   "Provider": "EVENTHUB",
   "Time Generated (UTC) ": "9/28/2022 8:40:06 PM +00:00",
   "Type" : "AZMSCustomerManagedKeyUserLogs"
  
}

Az alábbiakban azokat a gyakori hibakódokat vizsgáljuk, amelyek a BYOK-titkosítás engedélyezésekor keresendők.

Művelet Hibakód Az adatok eredményként kapott állapota
Sortörési/kicsomagolási engedély eltávolítása egy kulcstartóból 403 Hozzáférhetetlen
A Microsoft Entra ID szerepkör tagságának eltávolítása egy Olyan Microsoft Entra-tagból, amely a wrap/unwrap engedélyt kapta 403 Hozzáférhetetlen
Titkosítási kulcs törlése a kulcstartóból 404 Hozzáférhetetlen
A kulcstartó törlése 404 Nem érhető el (feltételezi, hogy a helyreállítható törlés engedélyezve van, ami kötelező beállítás.)
A titkosítási kulcs lejárati idejének módosítása úgy, hogy az már lejárt 403 Hozzáférhetetlen
Az NBF módosítása (korábban nem), hogy a kulcstitkosítási kulcs ne aktív 403 Hozzáférhetetlen
Válassza az MSFT-szolgáltatások engedélyezése lehetőséget a kulcstartó tűzfalához, vagy egyéb módon blokkolja a titkosítási kulccsal rendelkező kulcstartó hálózati hozzáférését 403 Hozzáférhetetlen
A kulcstartó áthelyezése másik bérlőre 404 Hozzáférhetetlen
Időszakos hálózati probléma vagy DNS/AAD/MSI-kimaradás Elérhető gyorsítótárazott adattitkosítási kulccsal

Futtatókörnyezeti naplózási naplók

A futásidejű naplózási naplók az Event Hubs összes adatsík-hozzáférési műveletéhez (például események küldéséhez vagy fogadásához) összesített diagnosztikai adatokat rögzítenek.

Feljegyzés

A futtatókörnyezeti naplók csak prémium és dedikált szinteken érhetők el.

A futásidejű naplózási naplók az alábbi táblázatban felsorolt elemeket tartalmazzák:

Név Leírás Az Azure Diagnosticsban támogatott Az Erőforrás-specifikus táblában támogatott
ActivityId Véletlenszerűen létrehozott UUID, amely biztosítja a naplózási tevékenység egyediségét. Igen Igen
ActivityName Futtatókörnyezeti művelet neve. Igen Igen
ResourceId A tevékenységhez társított erőforrás. Igen Igen
Timestamp Összesítési idő. Igen Nem
TimeGenerated [UTC] A végrehajtott művelet időpontja (UTC-ben) Nem Igen
Status A tevékenység állapota (sikeres vagy sikertelen). Igen Igen
Protocol A művelethez társított protokoll típusa. Igen Igen
AuthType A hitelesítés típusa (Azure Active Directory vagy SAS-szabályzat). Igen Igen
AuthKey Azure Active Directory-alkalmazásazonosító vagy SAS-szabályzatnév, amely egy erőforrás hitelesítéséhez használatos. Igen Igen
NetworkType A hálózati hozzáférés típusa: Public vagy Private. Igen Igen
ClientIP Az ügyfélalkalmazás IP-címe. Igen Igen
Count Az összesített 1 perces időszakban végrehajtott műveletek teljes száma. Igen Igen
Properties Az adatsík műveletére jellemző metaadatok. Igen Igen
Category Naplókategória Igen NEM
Provider A naplókat kibocsátó szolgáltatás neve, pl. Eventhub Nem Igen
Type A kibocsátott naplók típusa Nem Igen

Íme egy példa egy futtatókörnyezeti naplóbejegyzésre:

AzureDiagnostics:

{
    "ActivityId": "<activity id>",
    "ActivityName": "ConnectionOpen | Authorization | SendMessage | ReceiveMessage",
    "ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace>/eventhubs/<event hub name>",
    "Time": "1/1/2021 8:40:06 PM +00:00",
    "Status": "Success | Failure",
    "Protocol": "AMQP | KAFKA | HTTP | Web Sockets", 
    "AuthType": "SAS | Azure Active Directory", 
    "AuthId": "<AAD application name | SAS policy name>",
    "NetworkType": "Public | Private", 
    "ClientIp": "x.x.x.x",
    "Count": 1,
    "Category": "RuntimeAuditLogs"
 }

Erőforrás-specifikus táblabejegyzés:

{
    "ActivityId": "<activity id>",
    "ActivityName": "ConnectionOpen | Authorization | SendMessage | ReceiveMessage",
    "ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace>/eventhubs/<event hub name>",
    "TimeGenerated (UTC)": "1/1/2021 8:40:06 PM +00:00",
    "Status": "Success | Failure",
    "Protocol": "AMQP | KAFKA | HTTP | Web Sockets", 
    "AuthType": "SAS | Azure Active Directory", 
    "AuthId": "<AAD application name | SAS policy name>",
    "NetworkType": "Public | Private", 
    "ClientIp": "x.x.x.x",
    "Count": 1,
    "Type": "AZMSRuntimeAUditLogs",
    "Provider":"EVENTHUB"
 }

Alkalmazásmetrikanaplók

Az alkalmazásmetrikanaplók rögzítik az adatsík-műveletekhez kapcsolódó egyes metrikák összesített adatait. A rögzített adatok a következő futtatókörnyezeti metrikákat tartalmazzák.

Feljegyzés

Az alkalmazásmetrikanaplók csak prémium és dedikált szinteken érhetők el.

Név Leírás
ConsumerLag Jelezze a fogyasztók és a termelők közötti késést.
NamespaceActiveConnections Az ügyfél és az eseményközpont közötti aktív kapcsolatok részletei.
GetRuntimeInfo A futtatási idő adatainak lekérése az Event Hubsból.
GetPartitionRuntimeInfo Szerezze be az eseményközpont logikai partíciójának hozzávetőleges futásidejű adatait.
IncomingMessages Az Event Hubsban közzétett üzenetek számának részletei.
IncomingBytes Az Event Hubsnak küldött Publisher-átviteli sebesség részletei
OutgoinMessages Az Event Hubsból felhasznált üzenetek számának részletei.
OutgoingBytes Az Event Hubs fogyasztói átviteli sebességének részletei.
OffsetCommit Az eseményközpontban végrehajtott eltolás-véglegesítési hívások száma
OffsetFetch Az eseményközpontba irányuló eltoláshívási hívások száma.

Diagnosztikai hibanaplók

A diagnosztikai hibanaplók rögzítik az ügyféloldali hibaüzeneteket, a szabályozást és a kvóta túllépett hibáit. Részletes diagnosztikát nyújtanak a hibaazonosításhoz.

A diagnosztikai hibanaplók az alábbi táblázatban felsorolt elemeket tartalmazzák:

Név Leírás Az Azure Diagnosticsban támogatott Támogatott az AZMSDiagnosticErrorLogs (Erőforrás-specifikus tábla)
ActivityId Véletlenszerűen létrehozott UUID, amely biztosítja a naplózási tevékenység egyediségét. Igen Igen
ActivityName Művelet neve Igen Igen
NamespaceName Névtér neve Igen igen
EntityType Az entitás típusa Igen Igen
EntityName Entitás neve Igen Igen
OperationResult Hiba típusa a műveletben (Clienterror vagy Serverbusy vagy quotaexceeded) Igen Igen
ErrorCount Azonos hibák száma az 1 perces összesítési időszakban. Igen Igen
ErrorMessage Részletes hibaüzenet Igen Igen
ResourceProvider A naplókat kibocsátó szolgáltatás neve. Lehetséges értékek: Microsoft.Eventhub és Microsoft.Servicebus Igen Igen
Time Generated (UTC) Műveleti idő Nem Igen
EventTimestamp Műveleti idő Igen Nem
Category Naplókategória Igen Nem
Type A kibocsátott naplók típusa Nem Igen

Íme egy példa a diagnosztikai hibanapló bejegyzésére:

{
    "ActivityId": "0000000000-0000-0000-0000-00000000000000",
    "SubscriptionId": "<Azure Subscription Id",
    "NamespaceName": "Name of Event Hubs Namespace",
    "EntityType": "EventHub",
    "EntityName": "Name of Event Hub",
    "ActivityName": "SendMessage",
    "ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event hub namespace name>",,
    "OperationResult": "ServerBusy",
    "ErrorCount": 1,
    "EventTimestamp": "3/27/2024 1:02:29.126 PM +00:00",
    "ErrorMessage": "the request was terminated because the entity is being throttled by the application group with application group name <application group name> and policy name <throttling policy name>.error code: 50013.",
    "category": "DiagnosticErrorLogs"
 }

Erőforrás-specifikus táblabejegyzés:

{
    "ActivityId": "0000000000-0000-0000-0000-00000000000000",
    "NamespaceName": "Name of Event Hubs Namespace",
    "EntityType": "Event Hub",
    "EntityName": "Name of Event Hub",
    "ActivityName": "SendMessage",
    "ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event hub namespace name>",,
    "OperationResult": "ServerBusy",
    "ErrorCount": 1,
    "TimeGenerated [UTC]": "1/27/2024 4:02:29.126 PM +00:00",
    "ErrorMessage": "The request was terminated because the entity is being throttled by the application group with application group name <application group name> and policy name <throttling policy name>.error code: 50013.",
    "Type": "AZMSDiagnosticErrorLogs"
 }

Azure Monitor-naplók táblái

Az Azure Event Hubs Kusto-táblákat használ az Azure Monitor-naplókból. Ezeket a táblákat a Log Analytics segítségével kérdezheti le. A szolgáltatás által használt Kusto-táblák listájáért tekintse meg az Azure Monitor Naplók táblareferenciáját.

A minta lekérdezéseinket a különböző naplókategóriák használatának megkezdéséhez tekintheti meg.

Fontos

A dimenziók nem exportálhatók Log Analytics-munkaterületre.

Következő lépések