Condividi tramite

Visualizzare i log e le metriche di Ricerca di intelligenza artificiale di Azure con Power BI

  • Articolo

Azure AI Search può inviare log delle operazioni e metriche dei servizi a un account di Archiviazione di Azure, che possono quindi essere visualizzati in Power BI. In questo articolo vengono illustrate le procedure e le modalità di utilizzo di un'app modello di Power BI per visualizzare i dati. Il modello contiene informazioni su query, indicizzazione, operazioni e metriche del servizio.

Nota

Il modello di Power BI usa attualmente il nome del prodotto precedente, ossia Ricerca cognitiva di Azure. Il cambio di nome verrà applicato in occasione del prossimo aggiornamento del modello.

Configurazione della registrazione e installazione del modello

  1. Abilitare la registrazione di metriche e risorse per il servizio di ricerca:

    1. Creare o identificare un account di Archiviazione di Azure esistente in cui archiviare i log.
    2. Passare al servizio di ricerca nel portale di Azure.
    3. Selezionare Impostazioni di diagnostica in Monitoraggio.
    4. Selezionare Aggiungi impostazione di diagnostica.
    5. Selezionare Archivia in un account di archiviazione, specificare le informazioni sull'account di archiviazione e quindi selezionare OperationLogs e AllMetrics.
    6. Seleziona Salva.

  2. Una volta abilitata la registrazione, i log e le metriche vengono generati quando si usa il servizio di ricerca. Per visualizzare gli eventi registrati in Archiviazione di Azure può essere necessaria fino a un'ora. Cercare un contenitore insights-logs-operationlogs per le operazioni e un contenitore insights-metrics-pt1m per le metriche. Controllare l'account di archiviazione per individuare questi contenitori, in modo da assicurarsi di avere a disposizione i dati da visualizzare.

  3. Trovare il modello di app di Power BI nel marketplace delle app di Power BI e installarlo in una nuova area di lavoro o in un'area di lavoro esistente. Il modello viene denominato Ricerca cognitiva di Azure: analizzare registri metriche.

  4. Dopo aver installato il modello, selezionarlo dall’elenco di app in Power BI.

    Screenshot che mostra l'app di Ricerca cognitiva di Azure da selezionare dall’elenco di app.

  5. Seleziona Connetti i dati.

    Screenshot che mostra come connettersi ai dati nell'app di Ricerca cognitiva di Azure.

  6. Fornire il nome dell’account di archiviazione che contiene log e metriche. Per impostazione predefinita, l'app analizza gli ultimi 10 giorni di dati, ma questo valore può essere modificato tramite il parametro Giorni.

    Schermata che mostra come inserire il nome dell'account di archiviazione e il numero di giorni di cui eseguire una query nella pagina Connettersi a Ricerca cognitiva di Azure.

  7. Selezionare Chiave come metodo di autenticazione e fornire la chiave dell'account di archiviazione. Selezionare Nessuno o Privato come livello di privacy. Selezionare Accedi per iniziare il processo di caricamento.

    Screenshot che mostra come inserire il metodo di autenticazione, la chiave dell’account e il livello di privacy nella pagina Connettersi a Ricerca cognitiva di Azure.

  8. Attendere per l'aggiornamento dei dati. Questa operazione potrebbe richiedere un po' di tempo, a seconda della quantità di dati disponibili. È possibile verificare se i dati sono ancora in fase di aggiornamento in base all'indicatore sottostante.

    Screenshot che mostra come leggere le informazioni nella pagina di aggiornamento dei dati.

  9. Per visualizzare il report, selezionare Report di Ricerca cognitiva di Azure.

    Screenshot che mostra come selezionare il report nella pagina di aggiornamento dei dati.

  10. Aggiornare la pagina dopo aver aperto il report, in modo che lo stesso contenga tutti i dati.

    Screenshot del report di Power BI.

Modificare i parametri dell’app

Se si desidera visualizzare i dati da un account di archiviazione diverso o cambiare il numero di giorni dei dati di cui eseguire una query, attenersi alla procedura seguente per modificare i parametri Giorni e StorageAccount.

  1. Spostarsi nelle app di Power BI, trovare l'app di ricerca e selezionare l'azione Modifica per continuare nell'area di lavoro.

  2. Selezionare Impostazioni dalle opzioni del set di dati.

    Screenshot che mostra come selezionare Impostazioni dalle opzioni del set di dati di Ricerca cognitiva di Azure.

  3. Nella scheda Set di dati, modificare i valori dei parametri e selezionare Applica. Se si verifica un problema di connessione, aggiornare le credenziali dell'origine dati nella stessa pagina.

  4. Tornare indietro nell'area di lavoro e selezionare Aggiorna subito dalle opzioni del set di dati.

    Screenshot che mostra come selezionare l'opzione Aggiorna subito.

  5. Aprire il report per visualizzare i dati aggiornati. Potrebbe anche essere necessario aggiornare il report per visualizzare i dati più recenti.

Risoluzione dei problemi del report

Se non è possibile visualizzare i dati, provare a seguire la procedura di risoluzione dei problemi riportata di seguito:

  1. Aprire il report e aggiornare la pagina per assicurarsi di visualizzare i dati più recenti. Nel report è disponibile un'opzione per aggiornare i dati. Selezionarla per ottenere i dati più recenti.

  2. Assicurarsi di aver fornito il nome dell'account di archiviazione e la chiave di accesso corretti. Il nome dell'account di archiviazione deve corrispondere all'account configurato con i log del servizio di ricerca.

  3. Confermare che l'account di archiviazione includa i contenitori insights-logs-operationlogs e insights-metrics-pt1m e che ogni contenitore disponga di dati. I log e le metriche si troveranno all'interno di un paio di livelli di cartelle.

  4. Verificare se il set di dati è ancora in fase di aggiornamento. L'indicatore dello stato di aggiornamento viene visualizzato nel passaggio 8 di cui sopra. Se l'aggiornamento è ancora in corso, attendere che si completi per aprire e aggiornare il report.

Passaggi successivi