Informazioni di riferimento sul monitoraggio dei dati Hub eventi di Azure
Per informazioni dettagliate sulla raccolta e l'analisi dei dati di monitoraggio per Hub eventi di Azure, vedere Monitoraggio Hub eventi di Azure.
Nota
Monitoraggio di Azure non include dimensioni nei dati delle metriche esportate, inviate a una destinazione come Archiviazione di Azure, Hub eventi di Azure, Log Analytics e così via.
Metrica
Questa sezione elenca tutte le metriche della piattaforma raccolte automaticamente per Hub eventi di Azure. Il provider di risorse per queste metriche è Microsoft.EventHub/clusters o Microsoft.EventHub/namespaces.
Metriche per le richieste
Conta il numero di richieste di operazioni di dati e gestione.
| Nome misurazione | Esportabile tramite impostazioni di diagnostica | Unità | Tipo di aggregazione | Descrizione | Dimensioni |
|---|---|---|---|---|---|
| Richieste in ingresso | Sì | Conteggio | Conteggio | Numero di richieste effettuate al servizio Hub eventi in un periodo specificato. Questa metrica include tutte le operazioni del piano di gestione e dati. | Nome entità |
| Richieste riuscite | No | Conteggio | Conteggio | Numero di richieste riuscite effettuate al servizio Hub eventi in un periodo specificato. | Nome entità Risultato operazione |
| Richieste limitate | No | Conteggio | Conteggio | Numero di richieste che sono state limitate perché è stata superata la soglia di utilizzo. | Nome entità Risultato operazione |
I due tipi di errori seguenti vengono classificati come errori utente:
- Errori sul lato client (in HTTP sono errori 400).
- Errori che si verificano durante l'elaborazione dei messaggi.
Metriche per i messaggi
| Nome misurazione | Esportabile tramite impostazioni di diagnostica | Unità | Tipo di aggregazione | Descrizione | Dimensioni |
|---|---|---|---|---|---|
| Messaggi in ingresso | Sì | Conteggio | Conteggio | Numero di eventi o messaggi inviati agli hub eventi in un periodo specificato. | Nome entità |
| Messaggi in uscita | Sì | Conteggio | Conteggio | Numero di eventi o messaggi ricevuti da Hub eventi in un periodo specificato. | Nome entità |
| Messaggi acquisiti | No | Conteggio | Conteggio | Numero di messaggi acquisiti. | Nome entità |
| Byte in ingresso | Sì | Byte | Conteggio | Byte in ingresso per un hub eventi in un periodo specificato. | Nome entità |
| Byte in uscita | Sì | Byte | Conteggio | Byte in uscita per un hub eventi in un periodo specificato. | Nome entità |
| Dimensione | No | Byte | Media | Dimensioni di un hub eventi in byte. | Nome entità |
Nota
- Questi valori sono valori temporizzato. I messaggi in arrivo usati immediatamente dopo tale temporizzazione potrebbero non essere riportati in queste metriche.
- La metrica Richieste in ingresso include tutte le operazioni del piano di gestione e dati. La metrica Messaggi in arrivo fornisce il numero totale di eventi inviati all'hub eventi. Ad esempio, se si invia un batch di 100 eventi a un hub eventi, verrà conteggiato come 1 richiesta in ingresso e 100 messaggi in arrivo.
Acquisire le metriche
| Nome misurazione | Esportabile tramite impostazioni di diagnostica | Unità | Tipo di aggregazione | Descrizione | Dimensioni |
|---|---|---|---|---|---|
| Messaggi acquisiti | No | Conteggio | Conteggio | Numero di messaggi acquisiti. | Nome entità |
| Byte acquisiti | No | Byte | Conteggio | Byte acquisiti per un hub eventi | Nome entità |
| Backlog acquisiti | No | Conteggio | Conteggio | Acquisire il backlog per un hub eventi | Nome entità |
Metriche di connessione
| Nome misurazione | Esportabile tramite impostazioni di diagnostica | Unità | Tipo di aggregazione | Descrizione | Dimensioni |
|---|---|---|---|---|---|
| Connessioni attive | No | Conteggio | Media | Numero di connessioni attive in uno spazio dei nomi e in un'entità (hub eventi) nello spazio dei nomi. Il valore per questa metrica è un valore temporizzato. Connessione ioni attive immediatamente dopo quel punto nel tempo potrebbero non essere riflesse nella metrica. | Nome entità |
| Connessioni aperte | No | Conteggio | Media | Numero di connessioni aperte. | Nome entità |
| Connessioni chiuse | No | Conteggio | Media | Numero di connessioni chiuse. | Nome entità |
Metrica di errore
| Nome misurazione | Esportabile tramite impostazioni di diagnostica | Unità | Tipo di aggregazione | Descrizione | Dimensioni |
|---|---|---|---|---|---|
| Errori server | No | Conteggio | Conteggio | Numero di richieste non elaborate a causa di un errore nel servizio Hub eventi in un periodo specificato. | Nome entità Risultato operazione |
| Errori utente | No | Conteggio | Conteggio | Numero di richieste non elaborate a causa di errori utente in un periodo specificato. | Nome entità Risultato operazione |
| Errori di quota superata | No | Conteggio | Conteggio | Numero di errori causati dal superamento delle quote in un periodo specificato. | Nome entità Risultato operazione |
Nota
Le app per la logica creano ricevitori e ricevitori di periodi possono essere spostati da un nodo a un altro a seconda del carico del servizio. Durante questi spostamenti, ReceiverDisconnection possono verificarsi eccezioni. Vengono conteggiati come errori utente sul lato del servizio Hub eventi. App per la logica può raccogliere errori dai client di Hub eventi in modo che sia possibile visualizzarli nei log utente.
Dimensioni delle metriche
Hub eventi di Azure supporta le dimensioni seguenti per le metriche in Monitoraggio di Azure. L'aggiunta di dimensioni alle metriche è facoltativa. Se non si aggiungono dimensioni, le metriche vengono specificate a livello di spazio dei nomi.
| Nome della dimensione | Descrizione |
|---|---|
| Nome entità | Nome dell'hub eventi. Con la metrica "Richieste in ingresso", la dimensione Nome entità ha un valore "-NamespaceOnlyMetric-" oltre a tutti gli hub eventi. Rappresenta le richieste effettuate a livello di spazio dei nomi. Ad esempio, una richiesta di elencare tutti gli hub eventi nello spazio dei nomi o le richieste alle entità che non hanno superato l'autenticazione o l'autorizzazione. |
Log risorse
Hub eventi di Azure ora ha la possibilità di inviare i log a una delle due tabelle di destinazione: Diagnostica di Azure o Tabelle specifiche delle risorse in Log Analytics. È possibile usare l'interruttore disponibile in portale di Azure per scegliere le tabelle di destinazione.
Hub eventi consente di acquisire i log di diagnostica per le categorie seguenti:
| Categoria | Descrizione |
|---|---|
| Log di archiviazione | Acquisisce informazioni sulle operazioni di Acquisizione hub eventi, in particolare i log relativi agli errori di acquisizione. |
| Log operativi | Permettono di acquisire tutte le operazioni di gestione eseguite nello spazio dei nomi di hub eventi di Azure. Le operazioni sui dati non vengono acquisite, a causa dell'elevato volume di operazioni sui dati eseguite su Hub eventi di Azure. |
| Log di scalabilità automatica | Acquisisce le operazioni di aumento automatico eseguite su uno spazio dei nomi di Hub eventi. |
| Log del coordinatore Kafka | Acquisisce le operazioni del coordinatore Kafka correlate a hub eventi. |
| Log degli errori utente Kafka | Acquisisce informazioni sulle API Kafka chiamate su Hub eventi. |
| Evento di connessione alla rete virtuale di Hub eventi | Acquisisce informazioni sugli indirizzi IP e sulle reti virtuali che inviano traffico a hub eventi. |
| Log utente della chiave gestita dal cliente | Acquisisce le operazioni correlate alla chiave gestita dal cliente. |
| Log di controllo di runtime | Acquisire informazioni di diagnostica aggregate per tutte le operazioni di accesso al piano dati ,ad esempio eventi di invio o ricezione, in Hub eventi. |
| Log delle metriche dell'applicazione | Acquisire le informazioni aggregate su determinate metriche correlate alle operazioni del piano dati. |
Tutti i log vengono archiviati in formato JavaScript Object Notation (JSON). Ogni voce presenta campi stringa che usano il formato descritto nelle sezioni seguenti.
Schema dei log di archiviazione
Le stringhe JSON dei log di archiviazione includono gli elementi elencati nella tabella seguente:
| Nome | Descrizione | Supportato in Diagnostica di Azure | Supportato in AZMSArchiveLogs (tabella specifica della risorsa) |
|---|---|---|---|
TaskName |
Descrizione dell'attività non riuscita | Sì | Sì |
ActivityId |
ID interno, usato a scopo di rilevamento | Sì | Sì |
trackingId |
ID interno, usato a scopo di rilevamento | Sì | Sì |
resourceId |
ID della risorsa Azure Resource Manager | yes | Sì |
eventHub |
Nome completo dell'hub eventi (include il nome dello spazio dei nomi) | Sì | No |
EventhubName |
Nome dell'entità dell'hub eventi | No | Sì |
partitionId |
Partizione dell'hub eventi scritta in | Sì | Sì |
archiveStep |
valori possibili: ArchiveFlushWriter, DestinationInit | Sì | Sì |
startTime |
Ora di inizio di un errore | Sì | No |
Time Generated (UTC) |
Timestamp dell'operazione | No | Sì |
failures |
Numero di volte in cui si è verificato l'errore | Sì | Sì |
durationInSeconds |
Durata dell'errore | Sì | Sì |
message |
Messaggio di errore | Sì | Sì |
category |
Categoria di log | Sì | No |
Provider |
Nome del servizio che emette i log, ad esempio Hub eventi | No | Sì |
Type |
Tipo di log generato | No | Sì |
Il codice seguente è un esempio di stringa JSON di log di archiviazione:
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"
}
Voce di tabella specifica della risorsa:
{
"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"
}
Schema di log operativi
Le stringhe JSON dei log operativi includono gli elementi elencati nella seguente tabella:
| Nome | Descrizione | Supportato in AzureDiagnostics | Supportato in AZMSOperationalLogs (tabella specifica della risorsa) |
|---|---|---|---|
ActivityId |
ID interno, usato a scopo di rilevamento | Sì | Sì |
EventName |
Nome operazione. Per un elenco di valori per questo elemento, vedere i nomi degli eventi | Sì | Sì |
resourceId |
ID della risorsa Azure Resource Manager | Sì | Sì |
SubscriptionId |
ID sottoscrizione | Sì | Sì |
EventTimeString |
Durata dell'operazione | Sì | No |
Time Generated (UTC) |
Timestamp dell'operazione | No | Sì |
EventProperties |
Proprietà per l'operazione. Questo elemento fornisce altre informazioni sull'evento, come illustrato nell'esempio seguente. | Sì | Sì |
Status |
Stato dell'operazione. Il valore può essere Succeeded o Failed. | Sì | Sì |
Caller |
Chiamante dell'operazione (Portale di Azure o client di gestione) | Sì | Sì |
Category |
Categoria di log | Sì | No |
Provider |
Nome del servizio che emette i log, ad esempio Hub eventi | No | Sì |
Type |
Tipo di log generati | No | Sì |
Il codice seguente è un esempio di stringa JSON di log operativo:
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"
}
Voce di tabella specifica della risorsa:
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"
}
Nomi degli eventi
Il nome dell'evento viene popolato come tipo di operazione + tipo di risorsa dalle enumerazioni seguenti. Ad esempio, Create Queue, Retrieve Event Hub o Delete Rule.
| Tipo di operazione | Tipo di risorsa |
|---|---|
| - Creare -Aggiornamento - Elimina -Recuperare -Sconosciuto |
-Namespace -Coda -Argomento -Sottoscrizione - Hub eventi - SharedAccessPolicy - UsageCredit -Regola - ConsumerGroup |
Schema dei log di scalabilità automatica
Le stringhe JSON dei log di scalabilità automatica includono gli elementi elencati nella tabella seguente:
| Nome | Descrizione | Supportato in Diagnostica di Azure | Supportato in AZMSAutoscaleLogs (tabella specifica della risorsa) |
|---|---|---|---|
TrackingId |
ID interno, usato a scopo di analisi | Sì | Sì |
ResourceId |
ID della risorsa di Azure Resource Manager. | Sì | Sì |
Message |
Messaggio informativo, che fornisce informazioni dettagliate sull'azione di aumento automatico. Il messaggio contiene il valore precedente e quello corrente delle unità elaborate per un dato spazio dei nomi e indica che cosa ne ha attivato l'aumento automatico. | Sì | Sì |
Time Generated (UTC) |
Timestamp dell'operazione | No | Sì |
Provider |
Nome del servizio che genera i log, ad esempio Hub eventi | No | Sì |
Type |
Tipo di log generati | No | Sì |
Di seguito viene riportato un evento di scalabilità automatica di esempio:
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"
}
Voce di tabella specifica della risorsa:
{
"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"
}
Schema dei log del coordinatore Kafka
Le stringhe JSON dei log del coordinatore Kafka includono gli elementi elencati nella tabella seguente:
| Nome | Descrizione | Supportato in Diagnostica di Azure | Supportato in AZMSKafkaCoordinatorLogs (tabella specifica della risorsa) |
|---|---|---|---|
RequestId |
ID richiesta, usato a scopo di analisi | Sì | Sì |
ResourceId |
ID della risorsa Azure Resource Manager | Sì | Sì |
Operation |
Nome dell'operazione eseguita durante il coordinamento del gruppo | Sì | Sì |
ClientId |
ID client | Sì | Sì |
NamespaceName |
Nome spazio dei nomi | Sì | Sì |
SubscriptionId |
ID sottoscrizione di Azure | Sì | Sì |
Message |
Messaggio informativo o di avviso, che fornisce informazioni dettagliate sulle azioni eseguite durante il coordinamento del gruppo. | Sì | Sì |
Time Generated (UTC) |
Timestamp dell'operazione | No | Sì |
Provider |
Nome del servizio che emette i log, ad esempio ServiceBus | No | Sì |
Type |
Tipo di log generato | No | Sì |
Esempio
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"
}
Voce della tabella specifica della risorsa:
{
"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"
}
Schema dei log degli errori utente Kafka
Le stringhe JSON dei log degli errori utente Kafka includono gli elementi elencati nella tabella seguente:
| Nome | Descrizione | Supportato in Diagnostica di Azure | Supportato in AZMSKafkaUserErrorLogs (tabella specifica della risorsa) |
|---|---|---|---|
TrackingId |
ID di verifica, usato a scopo di analisi. | Sì | Sì |
NamespaceName |
Nome spazio dei nomi | Sì | Sì |
Eventhub |
Nome hub eventi | Sì | Sì |
PartitionId |
ID partizione | Sì | Sì |
GroupId |
ID gruppo | Sì | Sì |
ClientId |
ID client | Sì | Sì |
ResourceId |
ID della risorsa di Azure Resource Manager. | Sì | Sì |
Message |
Messaggio informativo, che offre informazioni dettagliate su un errore | Sì | Sì |
TimeGenerated (UTC) |
Timestamp per l'operazione eseguita | No | Sì |
Provider |
Nome del servizio che emette i log, ad esempio Hub eventi | No | Sì |
Type |
Tipo di log generato | NO | Sì |
Schema dell'evento di connessione rete virtuale di hub eventi
Il codice JSON dell'evento di connessione della rete virtuale (rete virtuale) di Hub eventi include gli elementi elencati nella tabella seguente:
| Nome | Descrizione | Supportato in Diagnostica di Azure | Supportato in AZMSVNet Connessione ionevents (tabella specifica della risorsa) |
|---|---|---|---|
SubscriptionId |
ID sottoscrizione di Azure | Sì | Sì |
NamespaceName |
Nome spazio dei nomi | Sì | Sì |
IPAddress |
Indirizzo IP di un client connesso al servizio Hub eventi | Sì | Sì |
Action |
Azione eseguita dal servizio Hub eventi durante la valutazione delle richieste di connessione. Le azioni supportate sono Accetta connessione e Rifiuta connessione. | Sì | Sì |
Reason |
Fornisce un motivo per cui è stata eseguita l'azione | Sì | No |
Message |
Fornisce un motivo per cui è stata eseguita l'azione | No | Sì |
Count |
Numero di occorrenze dell'azione | Sì | Sì |
ResourceId |
ID della risorsa di Azure Resource Manager. | Sì | Sì |
Time Generated (UTC) |
Timestamp dell'operazione | No | Sì |
Provider |
Nome del servizio che emette i log, ad esempio ServiceBus | No | Sì |
Type |
AZMSVNet Connessione ionevents | No | Sì |
I log di rete virtuale vengono generati solo se lo spazio dei nomi consente l'accesso da reti selezionate o da indirizzi IP specifici (regole di filtro IP). Se non si vuole limitare l'accesso allo spazio dei nomi usando queste funzionalità e si vogliono comunque ottenere i log della rete virtuale per tenere traccia degli indirizzi IP dei client che si connettono allo spazio dei nomi di Hub eventi, è possibile usare la soluzione alternativa seguente. Abilitare il filtro IP e aggiungere l'intervallo IPv4 indirizzabile totale (128.0.0.0/1 - 0.0.0.0/1) e L'intervallo IPv6 ().::/1 - 8000::/1 Il filtro IP di Hub eventi non supporta gli intervalli IPv6. È possibile che nel log vengano visualizzati indirizzi di endpoint privati nel formato IPv6.
Esempio
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"
}
Voce di tabella specifica della risorsa:
{
"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"
}
Schema dei log utente della chiave gestita dal cliente
Le stringhe JSON dei log utente della chiave gestita dal cliente includono gli elementi elencati nella tabella seguente:
| Nome | Descrizione | Supportato in Diagnostica di Azure | Supportato in AZMSCustomerManagedKeyUserLogs (tabella specifica della risorsa) |
|---|---|---|---|
Category |
Tipo di categoria per un messaggio. Si tratta di uno dei valori seguenti: errore e informazioni. Ad esempio, se la chiave dell'insieme di credenziali delle chiavi è disabilitata, si tratta di una categoria di informazioni o se non è possibile annullare il wrapping di una chiave, potrebbe verificarsi un errore. | Sì | Sì |
ResourceId |
ID della risorsa interna, che include l'ID sottoscrizione e il nome dello spazio dei nomi di Azure | Sì | Sì |
KeyVault |
Nome della risorsa Key Vault | Sì | Sì |
Key |
Nome della chiave di Key Vault usata per crittografare lo spazio dei nomi di Hub eventi. | Sì | Sì |
Version |
Versione della chiave di Key Vault. | Sì | Sì |
Operation |
Operazione eseguita sulla chiave nell'insieme di credenziali delle chiavi. Ad esempio, disabilitare/abilitare la chiave, eseguire il wrapping o annullare il wrapping. | Sì | Sì |
Code |
Codice associato all'operazione. Esempio: codice di errore, 404 indica che la chiave non è stata trovata. | Sì | Sì |
Message |
Messaggio che offre informazioni dettagliate su un errore o messaggio informativo | Sì | Sì |
Time Generated (UTC) |
Timestamp dell'operazione | No | Sì |
Provider |
Nome del servizio che emette i log, ad esempio ServiceBus | No | Sì |
Type |
Tipo di log generato | No | Sì |
Ecco un esempio del log per una chiave gestita dal cliente:
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": ""
}
Voce di tabella specifica della risorsa:
{
"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"
}
Di seguito sono riportati i codici di errore comuni da cercare quando la crittografia BYOK è abilitata.
| Azione | Codice errore | Stato risultante dei dati |
|---|---|---|
| Rimuovere l'autorizzazione di wrapping/annullamento del wrapping da un insieme di credenziali delle chiavi | 403 | Inaccessible |
| Rimuovere l'appartenenza al ruolo MICROSOFT Entra ID da un'entità Di accesso Microsoft che ha concesso l'autorizzazione di wrapping/annullamento del wrapping | 403 | Inaccessible |
| Eliminare una chiave di crittografia dall'insieme di credenziali delle chiavi | 404 | Inaccessible |
| Eliminare l'insieme di credenziali delle chiavi | 404 | Inaccessibile (presuppone che l'eliminazione temporanea sia abilitata, ovvero un'impostazione obbligatoria). |
| Modifica del periodo di scadenza sulla chiave di crittografia in modo che sia già scaduto | 403 | Inaccessible |
| Modifica dell'NBF (non prima) in modo che la chiave di crittografia della chiave non sia attiva | 403 | Inaccessible |
| Selezionare l'opzione Consenti servizi MSFT per il firewall dell'insieme di credenziali delle chiavi o bloccare in altro modo l'accesso di rete all'insieme di credenziali delle chiavi con la chiave di crittografia | 403 | Inaccessible |
| Spostamento dell'insieme di credenziali delle chiavi in un tenant diverso | 404 | Inaccessible |
| Problema di rete intermittente o interruzione DNS/AAD/MSI | Accessibile tramite la chiave di crittografia dei dati memorizzata nella cache |
Log di controllo di runtime
I log di controllo di runtime acquisiscono informazioni di diagnostica aggregate per tutte le operazioni di accesso al piano dati (ad esempio eventi di invio o ricezione) in Hub eventi.
Nota
I log di controllo di runtime sono disponibili solo nei livelli Premium e dedicati .
I log di controllo di runtime includono gli elementi elencati nella tabella seguente:
| Nome | Descrizione | Supportato in Diagnostica di Azure | Supportato nella tabella specifica della risorsa |
|---|---|---|---|
ActivityId |
UUID generato in modo casuale che garantisce l'univocità per l'attività di controllo. | Sì | Sì |
ActivityName |
Nome dell'operazione di runtime. | Sì | Sì |
ResourceId |
Risorsa associata all'attività. | Sì | Sì |
Timestamp |
Tempo di aggregazione. | Sì | No |
TimeGenerated [UTC] |
Ora dell'operazione eseguita (in formato UTC) | No | Sì |
Status |
Stato dell'attività (esito positivo o negativo). | Sì | Sì |
Protocol |
Tipo del protocollo associato all'operazione. | Sì | Sì |
AuthType |
Tipo di autenticazione (Criteri di firma di accesso condiviso o Azure Active Directory). | Sì | Sì |
AuthKey |
ID applicazione o nome dei criteri di firma di accesso condiviso di Azure Active Directory usati per l'autenticazione in una risorsa. | Sì | Sì |
NetworkType |
Tipo di accesso alla rete: Public o Private. |
Sì | Sì |
ClientIP |
Indirizzo IP dell'applicazione client. | Sì | Sì |
Count |
Numero totale di operazioni eseguite durante il periodo aggregato di 1 minuto. | Sì | Sì |
Properties |
Metadati specifici dell'operazione del piano dati. | Sì | Sì |
Category |
Categoria di log | Sì | NO |
Provider |
Nome del servizio che genera i log, ad esempio Eventhub | No | Sì |
Type |
Tipo di log generati | No | Sì |
Di seguito è riportato un esempio di voce del log di controllo di runtime:
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"
}
Voce di tabella specifica della risorsa:
{
"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"
}
Log delle metriche dell'applicazione
I log delle metriche dell'applicazione acquisisce le informazioni aggregate su determinate metriche correlate alle operazioni del piano dati. Le informazioni acquisite includono le metriche di runtime seguenti.
Nota
I log delle metriche dell'applicazione sono disponibili solo nei livelli Premium e dedicati .
| Nome | Descrizione |
|---|---|
ConsumerLag |
Indicare il ritardo tra consumer e producer. |
NamespaceActiveConnections |
Dettagli delle connessioni attive stabilite da un client all'hub eventi. |
GetRuntimeInfo |
Ottenere informazioni sul runtime da Hub eventi. |
GetPartitionRuntimeInfo |
Ottenere le informazioni di runtime approssimative per una partizione logica di un hub eventi. |
IncomingMessages |
Dettagli del numero di messaggi pubblicati in Hub eventi. |
IncomingBytes |
Dettagli della velocità effettiva del server di pubblicazione inviata a Hub eventi |
OutgoinMessages |
Dettagli del numero di messaggi utilizzati da Hub eventi. |
OutgoingBytes |
Dettagli della velocità effettiva consumer da Hub eventi. |
OffsetCommit |
Numero di chiamate di commit di offset effettuate all'hub eventi |
OffsetFetch |
Numero di chiamate di recupero offset effettuate all'hub eventi. |
Log degli errori di diagnostica
I log degli errori di diagnostica acquisisce i messaggi di errore per qualsiasi errore lato client, limitazione e quota superata. Forniscono diagnostica dettagliata per l'identificazione degli errori.
I log degli errori di diagnostica includono gli elementi elencati nella tabella seguente:
| Nome | Descrizione | Supportato in Diagnostica di Azure | Supportato in AZMSDiagnosticErrorLogs (tabella specifica della risorsa) |
|---|---|---|---|
ActivityId |
UUID generato in modo casuale che garantisce l'univocità per l'attività di controllo. | Sì | Sì |
ActivityName |
Nome operazione | Sì | Sì |
NamespaceName |
Nome dello spazio dei nomi | Sì | yes |
EntityType |
Tipo di entità | Sì | Sì |
EntityName |
Nome dell'entità | Sì | Sì |
OperationResult |
Tipo di errore nell'operazione (Clienterror o Serverbusy o quota superata) | Sì | Sì |
ErrorCount |
Numero di errori identici durante il periodo di aggregazione di 1 minuto. | Sì | Sì |
ErrorMessage |
Messaggio di errore dettagliato | Sì | Sì |
ResourceProvider |
Nome del servizio che genera i log. Valori possibili: Microsoft.Eventhub e Microsoft.Servicebus | Sì | Sì |
Time Generated (UTC) |
Durata dell'operazione | No | Sì |
EventTimestamp |
Tempo operazione | Sì | No |
Category |
Categoria di log | Sì | No |
Type |
Tipo di log generati | No | Sì |
Di seguito è riportato un esempio di voce del log degli errori di diagnostica:
{
"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"
}
Voce di tabella specifica della risorsa:
{
"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"
}
Tabelle dei log di Monitoraggio di Azure
Hub eventi di Azure usa tabelle Kusto dai log di Monitoraggio di Azure. È possibile eseguire query su queste tabelle con Log Analytics. Per un elenco delle tabelle Kusto usate dal servizio, vedere Informazioni di riferimento sulla tabella log di Monitoraggio di Azure.
È possibile visualizzare le query di esempio per iniziare a usare categorie di log diverse.
Importante
Le dimensioni non vengono esportate in un'area di lavoro Log Analytics.
Passaggi successivi
- Per informazioni dettagliate sul monitoraggio Hub eventi di Azure, vedere Monitoraggio Hub eventi di Azure.
- Per informazioni dettagliate sul monitoraggio delle risorse di Azure, vedere Monitoraggio delle risorse di Azure con Monitoraggio di Azure.