Log di diagnostica di Hub eventiEvent Hubs diagnostic logs

È possibile visualizzare due tipi di log per Hub eventi di Azure:You can view two types of logs for Azure Event Hubs:

  • Log attività.Activity logs. Questi log contengono informazioni sulle operazioni eseguite in un processo.These logs have information about operations performed on a job. I log sono sempre attivati.The logs are always enabled.
  • Log di diagnostica.Diagnostic logs. È possibile configurare i log di diagnostica per una visualizzazione più completa di tutto ciò che accade in un processo.You can configure diagnostic logs for a richer view of everything that happens with a job. I log di diagnostica coprono le attività che si verificano dal momento della creazione del processo fino alla sua eliminazione, inclusi gli aggiornamenti e le attività che si verificano durante l'esecuzione del processo.Diagnostic logs cover activities from the time the job is created until the job is deleted, including updates and activities that occur while the job is running.

Attivare i log di diagnosticaTurn on diagnostic logs

I log di diagnostica sono disabilitati per impostazione predefinita.Diagnostics logs are disabled by default. Per abilitare i log di diagnostica:To enable diagnostic logs:

  1. Nel portale di Azure in Monitoraggio + Gestione fare clic su Log di diagnostica.In the Azure portal, under Monitoring + Management, click Diagnostics logs.

    Navigazione tra i pannelli per trovare i log di diagnostica

  2. Fare clic sulla risorsa da monitorare.Click the resource you want to monitor.

  3. Fare clic su Attiva diagnostica.Click Turn on diagnostics.

    Attivare i log di diagnostica

  4. Per Stato fare clic su Attivato.For Status, click On.

    Modifica dello lo stato dei log di diagnostica

  5. Impostare la destinazione di archiviazione desiderata, ad esempio un account di archiviazione, un hub eventi o Azure Log Analytics.Set the archive target that you want; for example, a storage account, an event hub, or Azure Log Analytics.

  6. Salvare le nuove impostazioni di diagnostica.Save the new diagnostics settings.

Le nuove impostazioni diventano effettive in circa 10 minuti.New settings take effect in about 10 minutes. Trascorso questo tempo, i log vengono visualizzati nella destinazione di archiviazione configurata, all'interno del pannello Log di diagnostica.After that, logs appear in the configured archival target, on the Diagnostics logs blade.

Per altre informazioni sulla configurazione della diagnostica, vedere la panoramica dei log di diagnostica di Azure.For more information about configuring diagnostics, see the overview of Azure diagnostic logs.

Categorie dei log di diagnosticaDiagnostic logs categories

Hub eventi consente di acquisire i log di diagnostica per due categorie:Event Hubs captures diagnostic logs for two categories:

  • ArchiveLogs: log correlati agli archivi dell'hub eventi, in particolare quelli relativi agli errori di archiviazione.ArchiveLogs: logs related to Event Hubs archives, specifically, logs related to archive errors.
  • OperationalLogs: acquisisce informazioni su ciò che avviene durante il funzionamento dell'hub eventi, in particolare il tipo di operazione, come creazione dell'hub eventi, risorse usate e stato dell'operazione.OperationalLogs: information about what is happening during Event Hubs operations, specifically, the operation type, including event hub creation, resources used, and the status of the operation.

Schema dei log di diagnosticaDiagnostic logs schema

Tutti i log vengono archiviati in formato JavaScript Object Notation (JSON).All logs are stored in JavaScript Object Notation (JSON) format. Ogni voce presenta campi stringa che usano il formato descritto nelle sezioni seguenti.Each entry has string fields that use the format described in the following sections.

Schema dei log di archiviazioneArchive logs schema

Le stringhe JSON dei log di archiviazione includono gli elementi elencati nella tabella seguente:Archive log JSON strings include elements listed in the following table:

NomeName DescrizioneDescription
TaskNameTaskName Descrizione dell'attività non riuscita.Description of the task that failed.
ActivityIdActivityId ID interno, usato a scopo di rilevamento.Internal ID, used for tracking.
trackingIdtrackingId ID interno, usato a scopo di rilevamento.Internal ID, used for tracking.
resourceIdresourceId ID della risorsa di Azure Resource Manager.Azure Resource Manager resource ID.
eventHubeventHub Nome completo dell'hub eventi, include il nome dello spazio dei nomi.Event hub full name (includes namespace name).
partitionIdpartitionId Partizione dell'hub eventi per l'operazione di scrittura.Event Hub partition being written to.
archiveSteparchiveStep ArchiveFlushWriterArchiveFlushWriter
startTimestartTime Ora di inizio di un errore.Failure start time.
errorifailures Numero di volte in cui si è verificato un errore.Number of times failure occurred.
durationInSecondsdurationInSeconds Durata dell'errore.Duration of failure.
Messagemessage Messaggio di errore.Error message.
categorycategory ArchiveLogsArchiveLogs

Il codice seguente è un esempio di stringa JSON di log di archiviazione:The following code is an example of an archive log JSON string:

{
     "TaskName": "EventHubArchiveUserError",
     "ActivityId": "21b89a0b-8095-471a-9db8-d151d74ecf26",
     "trackingId": "21b89a0b-8095-471a-9db8-d151d74ecf26_B7",
     "resourceId": "/SUBSCRIPTIONS/854D368F-1828-428F-8F3C-F2AFFA9B2F7D/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
     "eventHub": "fbettati-opera-eventhub:eventhub:eh123~32766",
     "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"
}

Schema di log operativiOperational logs schema

Le stringhe JSON dei log operativi includono gli elementi elencati nella seguente tabella:Operational log JSON strings include elements listed in the following table:

NomeName DescrizioneDescription
ActivityIdActivityId ID interno, usato a scopo di rilevamento.Internal ID, used to track purpose.
EventNameEventName Nome operazione.Operation name.
resourceIdresourceId ID della risorsa di Azure Resource Manager.Azure Resource Manager resource ID.
SubscriptionIdSubscriptionId l'ID sottoscrizione.Subscription ID.
EventTimeStringEventTimeString Durata dell'operazione.Operation time.
EventPropertiesEventProperties Proprietà dell'operazione.Operation properties.
StatusStatus Stato dell'operazione.Operation status.
ChiamanteCaller Chiamante dell'operazione (Portale di Azure o client di gestione).Caller of operation (Azure portal or management client).
categorycategory OperationalLogsOperationalLogs

Il codice seguente è un esempio di stringa JSON di log operativo:The following code is an example of an operational log JSON string:

Example:
{
     "ActivityId": "6aa994ac-b56e-4292-8448-0767a5657cc7",
     "EventName": "Create EventHub",
     "resourceId": "/SUBSCRIPTIONS/1A2109E3-9DA0-455B-B937-E35E36C1163C/RESOURCEGROUPS/DEFAULT-SERVICEBUS-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/SHOEBOXEHNS-CY4001",
     "SubscriptionId": "1a2109e3-9da0-455b-b937-e35e36c1163c",
     "EventTimeString": "9/28/2016 8:40:06 PM +00:00",
     "EventProperties": "{\"SubscriptionId\":\"1a2109e3-9da0-455b-b937-e35e36c1163c\",\"Namespace\":\"shoeboxehns-cy4001\",\"Via\":\"https://shoeboxehns-cy4001.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
     "Status": "Succeeded",
     "Caller": "ServiceBus Client",
     "category": "OperationalLogs"
}

Passaggi successiviNext steps