Monitorare l'inserimento, i comandi e le query di Azure Esplora dati usando i log di diagnosticaMonitor Azure Data Explorer ingestion, commands, and queries using diagnostic logs

Esplora dati di Azure è un servizio di analisi dei dati veloce e completamente gestito per l'analisi in tempo reale di volumi elevati di dati in streaming provenienti da applicazioni, siti Web, dispositivi IoT e altro ancora.Azure Data Explorer is a fast, fully managed data analytics service for real-time analysis on large volumes of data streaming from applications, websites, IoT devices, and more. I log di diagnostica di monitoraggio di Azure forniscono i dati sul funzionamento delle risorse di Azure.Azure Monitor diagnostic logs provide data about the operation of Azure resources. Azure Esplora dati usa i log di diagnostica per ottenere informazioni dettagliate sui successi di inserimento, gli errori di inserimento, i comandi e le operazioni di query.Azure Data Explorer uses diagnostic logs for insights on ingestion successes, ingestion failures, commands, and query operations. È possibile esportare i log delle operazioni in archiviazione di Azure, Hub eventi o Log Analytics per monitorare l'inserimento, i comandi e lo stato delle query.You can export operation logs to Azure Storage, Event Hub, or Log Analytics to monitor ingestion, commands, and query status. I log da archiviazione di Azure e hub eventi di Azure possono essere indirizzati a una tabella nel cluster di Azure Esplora dati per un'ulteriore analisi.Logs from Azure Storage and Azure Event Hub can be routed to a table in your Azure Data Explorer cluster for further analysis.

Importante

I dati del log di diagnostica possono contenere dati riservati.Diagnostic log data may contain sensitive data. Limitare le autorizzazioni della destinazione dei log in base alle esigenze di monitoraggio.Restrict permissions of the logs destination according to your monitoring needs.

PrerequisitiPrerequisites

Configurare i log di diagnostica per un cluster di Esplora dati di AzureSet up diagnostic logs for an Azure Data Explorer cluster

I log di diagnostica possono essere usati per configurare la raccolta dei dati di log seguenti:Diagnostic logs can be used to configure the collection of the following log data:

  • Operazioni di inserimento riuscite: questi log contengono informazioni sulle operazioni di inserimento completate correttamente.Successful ingestion operations: These logs have information about successfully completed ingestion operations.
  • Operazioni di inserimento non riuscite: questi log contengono informazioni dettagliate sulle operazioni di inserimento non riuscite, inclusi i dettagli dell'errore.Failed ingestion operations: These logs have detailed information about failed ingestion operations including error details.

I dati vengono quindi archiviati in un account di archiviazione, trasmessi a un hub eventi o inviati a Log Analytics, in base alle specifiche.The data is then archived into a Storage account, streamed to an Event Hub, or sent to Log Analytics, as per your specifications.

Abilitare i log di diagnosticaEnable diagnostic logs

I log di diagnostica sono disabilitati per impostazione predefinita.Diagnostic logs are disabled by default. Per abilitare i log di diagnostica, seguire questa procedura:To enable diagnostic logs, do the following steps:

  1. Nella portale di Azureselezionare la risorsa cluster di Azure Esplora dati che si desidera monitorare.In the Azure portal, select the Azure Data Explorer cluster resource that you want to monitor.

  2. Selezionare Impostazioni di diagnostica in Monitoraggio.Under Monitoring, select Diagnostic settings.

    Aggiungere i log di diagnostica

  3. Selezionare Aggiungi impostazioni di diagnostica.Select Add diagnostic setting.

  4. Nella finestra impostazioni di diagnostica :In the Diagnostics settings window:

    Configurare le impostazioni di diagnostica

    1. Selezionare nome per l'impostazione di diagnostica.Select Name for your diagnostic setting.
    2. Selezionare una o più destinazioni: un account di archiviazione, un hub eventi o un Log Analytics.Select one or more targets: a Storage account, Event Hub, or Log Analytics.
    3. Selezionare i log da raccogliere: SucceededIngestion , FailedIngestion , Command o Query .Select logs to be collected: SucceededIngestion, FailedIngestion, Command, or Query.
    4. Selezionare le metriche da raccogliere (facoltativo).Select metrics to be collected (optional).
    5. Selezionare Save (Salva ) per salvare le impostazioni e le metriche dei nuovi log di diagnostica.Select Save to save the new diagnostic logs settings and metrics.

Le nuove impostazioni verranno impostate in pochi minuti.New settings will be set in a few minutes. I log vengono quindi visualizzati nella destinazione di archiviazione configurata (account di archiviazione, Hub eventi o Log Analytics).Logs then appear in the configured archival target (Storage account, Event Hub, or Log Analytics).

Nota

Se si inviano i log a log Analytics, i SucceededIngestion log,, FailedIngestion Command e Query verranno archiviati nelle tabelle log Analytics denominate: SucceededIngestion ,, FailedIngestion ADXCommand , ADXQuery , rispettivamente.If you send logs to Log Analytics, the SucceededIngestion, FailedIngestion, Command, and Query logs will be stored in Log Analytics tables named: SucceededIngestion, FailedIngestion, ADXCommand, ADXQuery, respectively.

Schema dei log di diagnosticaDiagnostic logs schema

Tutti i log di diagnostica di monitoraggio di Azure condividono uno schema di primo livello comune.All Azure Monitor diagnostic logs share a common top-level schema. Azure Esplora dati dispone di proprietà univoche per i relativi eventi.Azure Data Explorer has unique properties for their own events. Tutti i log vengono archiviati in formato JSON.All logs are stored in a JSON format.

Schema dei log di inserimentoIngestion logs schema

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

NomeName DescrizioneDescription
timetime Ora del reportTime of the report
resourceIdresourceId ID della risorsa Azure Resource ManagerAzure Resource Manager resource ID
operationNameoperationName Nome dell'operazione:' MICROSOFT. KUSTO/CLUSTER/INSERIMENTO/AZIONEName of the operation: 'MICROSOFT.KUSTO/CLUSTERS/INGEST/ACTION'
operationVersionoperationVersion Versione schema:' 1,0'Schema version: '1.0'
categorycategory Categoria dell'operazione.Category of the operation. SucceededIngestion o FailedIngestion.SucceededIngestion or FailedIngestion. Le proprietà sono diverse per l' operazione riuscita o operazione non riuscita.Properties differ for successful operation or failed operation.
propertiesproperties Informazioni dettagliate sull'operazione.Detailed information of the operation.

Log delle operazioni di inserimento riuscitoSuccessful ingestion operation log

Esempio:Example:

{
    "time": "",
    "resourceId": "",
    "operationName": "MICROSOFT.KUSTO/CLUSTERS/INGEST/ACTION",
    "operationVersion": "1.0",
    "category": "SucceededIngestion",
    "properties":
    {
        "succeededOn": "2019-05-27 07:55:05.3693628",
        "operationId": "b446c48f-6e2f-4884-b723-92eb6dc99cc9",
        "database": "Samples",
        "table": "StormEvents",
        "ingestionSourceId": "66a2959e-80de-4952-975d-b65072fc571d",
        "ingestionSourcePath": "https://kustoingestionlogs.blob.core.windows.net/sampledata/events8347293.json",
        "rootActivityId": "d0bd5dd3-c564-4647-953e-05670e22a81d"
    }
}

Proprietà di un log di diagnostica operazione completataProperties of a successful operation diagnostic log

NomeName DescrizioneDescription
succeededOnsucceededOn Tempo di completamento dell'inserimentoTime of ingestion completion
operationIdoperationId ID operazione di inserimento Esplora dati AzureAzure Data Explorer ingestion operation ID
databasedatabase Nome del database di destinazioneName of the target database
tabellatable Nome della tabella di destinazioneName of the target table
ingestionSourceIdingestionSourceId ID dell'origine dati di inserimentoID of the ingestion data source
ingestionSourcePathingestionSourcePath Percorso dell'origine dati di inserimento o dell'URI del BLOBPath of the ingestion data source or blob URI
rootActivityIdrootActivityId ID attivitàActivity ID

Log delle operazioni di inserimento non riuscitoFailed ingestion operation log

Esempio:Example:

{
    "time": "",
    "resourceId": "",
    "operationName": "MICROSOFT.KUSTO/CLUSTERS/INGEST/ACTION",
    "operationVersion": "1.0",
    "category": "FailedIngestion",
    "properties":
    {
        "failedOn": "2019-05-27 08:57:05.4273524",
        "operationId": "5956515d-9a48-4544-a514-cf4656fe7f95",
        "database": "Samples",
        "table": "StormEvents",
        "ingestionSourceId": "eee56f8c-2211-4ea4-93a6-be556e853e5f",
        "ingestionSourcePath": "https://kustoingestionlogs.blob.core.windows.net/sampledata/events5725592.json",
        "rootActivityId": "52134905-947a-4231-afaf-13d9b7b184d5",
        "details": "Permanent failure downloading blob. URI: ..., permanentReason: Download_SourceNotFound, DownloadFailedException: 'Could not find file ...'",
        "errorCode": "Download_SourceNotFound",
        "failureStatus": "Permanent",
        "originatesFromUpdatePolicy": false,
        "shouldRetry": false
    }
}

Proprietà di un log di diagnostica di un'operazione non riuscitaProperties of a failed operation diagnostic log

NomeName DescrizioneDescription
failedOnfailedOn Tempo di completamento dell'inserimentoTime of ingestion completion
operationIdoperationId ID operazione di inserimento Esplora dati AzureAzure Data Explorer ingestion operation ID
databasedatabase Nome del database di destinazioneName of the target database
tabellatable Nome della tabella di destinazioneName of the target table
ingestionSourceIdingestionSourceId ID dell'origine dati di inserimentoID of the ingestion data source
ingestionSourcePathingestionSourcePath Percorso dell'origine dati di inserimento o dell'URI del BLOBPath of the ingestion data source or blob URI
rootActivityIdrootActivityId ID attivitàActivity ID
dettaglidetails Descrizione dettagliata dell'errore e del messaggio di erroreDetailed description of the failure and error message
errorCodeerrorCode Codice di erroreError code
failureStatusfailureStatus Permanent o Transient.Permanent or Transient. Il tentativo di un errore temporaneo potrebbe avere esito positivo.Retry of a transient failure may succeed.
originatesFromUpdatePolicyoriginatesFromUpdatePolicy True se l'errore proviene da un criterio di aggiornamentoTrue if failure originates from an update policy
shouldRetryshouldRetry True se il tentativo potrebbe avere esito positivoTrue if retry may succeed

Passaggi successiviNext steps