Abilitare la registrazione diagnostica per Servizi di Azure AI

Questa guida fornisce istruzioni dettagliate per abilitare la registrazione diagnostica per un Servizio di Azure AI. Questi log forniscono dati completi e frequenti sul funzionamento di una risorsa usata per l'identificazione e il debug dei problemi. Prima di continuare, è necessario avere un account Azure con una sottoscrizione ad almeno un Servizio di Azure AI, ad esempio Servizi Voce.

Prerequisiti

Per abilitare la registrazione diagnostica, è necessario archiviare i dati di log. In questa esercitazione si usa Archiviazione di Azure e Log Analytics.

  • Archiviazione di Azure: conserva i log di diagnostica per il controllo dei criteri, l'analisi statica o il backup. L'account di archiviazione non deve trovarsi nella stessa sottoscrizione della risorsa che emette log, purché l'utente che configura l'impostazione abbia un accesso Azure RBAC appropriato a entrambe le sottoscrizioni.
  • Log Analytics: uno strumento flessibile di ricerca e analisi dei log che consente l'analisi dei log non elaborati generati da una risorsa di Azure.

Nota

Abilitare la raccolta dei log di diagnostica

Per iniziare, abilitare la registrazione diagnostica usando il portale di Azure.

Nota

Per abilitare questa funzionalità usando PowerShell o l'interfaccia della riga di comando di Azure, usare le istruzioni fornite in Raccogliere e usare i dati di log dalle risorse di Azure.

  1. Passare al portale di Azure. Successivamente, individuare e selezionare una risorsa Servizi di Azure AI. Ad esempio, la sottoscrizione a Servizi Voce.
  2. Successivamente, nel menu di spostamento a sinistra individuare Monitoraggio e selezionare Impostazioni di diagnostica. Questa schermata contiene tutte le impostazioni di diagnostica create in precedenza per questa risorsa.
  3. Se è presente una risorsa creata in precedenza che si desidera usare, è possibile selezionarla ora. Altrimenti selezionare + Aggiungi impostazione di diagnostica.
  4. Immettere un nome per l'impostazione. Successivamente, selezionare Archivia in un account di archiviazione e Invia a analisi dei log.
  5. Quando viene richiesto di eseguire la configurazione, selezionare l'account di archiviazione e l'area di lavoro OMS da usare per archiviare i log di diagnostica. Nota: se non si ha un account di archiviazione o un'area di lavoro OMS, seguire le istruzioni per crearne una.
  6. Selezionare Controlla, RequestResponsee AllMetrics. Specificare quindi il periodo di conservazione per i dati del log di diagnostica. Se un criterio di conservazione è impostato su zero, gli eventi per tale categoria di log vengono archiviati per un periodo illimitato.
  7. Seleziona Salva.

Possono essere necessarie fino a due ore prima che i dati di registrazione siano disponibili per l'esecuzione di query e l'analisi. Di conseguenza, non preoccuparsi se non è visualizzato niente subito.

Visualizzare ed esportare i dati di diagnostica da Archiviazione di Azure

Archiviazione di Azure è una soluzione di archiviazione di oggetti efficace ottimizzata per l'archiviazione di grandi quantità di dati non strutturati. In questa sezione si apprenderà come eseguire query sull'account di archiviazione per le transazioni totali in un periodo di tempo di 30 giorni ed esportare i dati in Excel.

  1. Nel portale di Azure individuare la risorsa di Archiviazione di Azure creata nell'ultima sezione.
  2. Nel menu di spostamento a sinistra individuare Monitoraggio e selezionare Metriche.
  3. Usare gli elenchi a discesa disponibili per configurare la query. In questo esempio, impostare l'intervallo di tempo su Ultimi 30 giorni e la metrica su Transazione.
  4. Al termine della query, saranno visualizzate le transazione degli ultimi 30 giorni. Per esportare questi dati, utilizzare il pulsante Esporta in Excel nella parte superiore della pagina.

Altre informazioni sulle operazioni che è possibile eseguire con i dati di diagnostica in Archiviazione di Azure.

Visualizzare i log in Log Analytics

Seguire queste istruzioni per esplorare i dati di Log Analytics per la risorsa.

  1. Nel portale di Azure individuare e selezionare Log Analytics nel menu di spostamento a sinistra.
  2. Individuare e selezionare la risorsa creata durante l'abilitazione della diagnostica.
  3. In Generaleindividuare e selezionare Log. In questa pagina è possibile eseguire query sui log.

Query di esempio

Ecco alcune query Kusto di base che è possibile usare per esplorare i dati di log.

Eseguire questa query per tutti i log di diagnostica di Servizi di Azure AI per un periodo di tempo specificato:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES"

Eseguire questa query per visualizzare i 10 log più recenti:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES"
| take 10

Eseguire questa query per raggruppare le operazioni in base alla risorsa:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES" |
summarize count() by Resource

Eseguire questa query per conoscere il tempo medio necessario per eseguire un'operazione:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES"
| summarize avg(DurationMs)
by OperationName

Eseguire questa query per visualizzare il volume di operazioni nel tempo suddivise per OperationName con conteggi eseguiti in bin per ogni 10s.

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES"
| summarize count()
by bin(TimeGenerated, 10s), OperationName
| render areachart kind=unstacked

Passaggi successivi