Visualize logs e métricas de pesquisa do Azure AI com o Power BI

  • Artigo

O Azure AI Search pode enviar logs de operação e métricas de serviço para uma conta de Armazenamento do Azure, que pode ser visualizada no Power BI. Este artigo explica as etapas e como usar um aplicativo de modelo do Power BI para visualizar os dados. O modelo abrange informações sobre consultas, indexação, operações e métricas de serviço.

Nota

O modelo do Power BI está atualmente a utilizar o nome do produto anterior, Azure Cognitive Search. A alteração de nome será atualizada na próxima atualização do modelo.

Configurar o registo e instalar o modelo

  1. Habilite o registro de métricas e recursos para seu serviço de pesquisa:

    1. Crie ou identifique uma conta de Armazenamento do Azure existente onde você pode arquivar os logs.
    2. Navegue até seu serviço de pesquisa no portal do Azure.
    3. Em Monitoramento, selecione Configurações de diagnóstico.
    4. Selecione Adicionar definição de diagnóstico.
    5. Verifique Arquivar em uma conta de armazenamento, forneça as informações da sua conta de armazenamento e verifique OperationLogs e AllMetrics.
    6. Selecione Guardar.

  2. Depois que o registro em log é habilitado, os logs e métricas são gerados à medida que você usa o serviço de pesquisa. Pode levar até uma hora até que os eventos registrados apareçam no Armazenamento do Azure. Procure um contêiner insights-logs-operationlogs para operações e um contêiner insights-metrics-pt1m para métricas. Verifique a sua conta de armazenamento para esses contêineres para se certificar de que você tem dados para visualizar.

  3. Encontre o modelo de aplicativo do Power BI no mercado de Aplicativos do Power BI e instale-o em um novo espaço de trabalho ou em um espaço de trabalho existente. O modelo chama-se Azure Cognitive Search: Analyze Logs and Metrics.

  4. Depois de instalar o modelo, selecione-o na sua lista de aplicativos no Power BI.

    Captura de ecrã a mostrar a aplicação Pesquisa Cognitiva do Azure a selecionar a partir da lista de aplicações.

  5. Selecione Conectar seus dados.

    Captura de ecrã a mostrar como ligar aos seus dados na aplicação Azure Cognitive Search.

  6. Forneça o nome da conta de armazenamento que contém seus logs e métricas. Por padrão, o aplicativo examina os últimos 10 dias de dados, mas esse valor pode ser alterado com o parâmetro Days .

    Captura de ecrã a mostrar como introduzir o nome da conta de armazenamento e o número de dias para consultar na página Ligar à Pesquisa Cognitiva do Azure.

  7. Selecione Chave como método de autenticação e forneça a chave da conta de armazenamento. Selecione Nenhum ou Privado como o nível de privacidade. Selecione Entrar para iniciar o processo de carregamento.

    Captura de ecrã a mostrar como introduzir o método de autenticação, a chave da conta e o nível de privacidade na página Ligar à Pesquisa Cognitiva do Azure.

  8. Aguarde até que os dados sejam atualizados. Isso pode levar algum tempo, dependendo da quantidade de dados que você tem. Você pode ver se os dados ainda estão sendo atualizados com base no indicador abaixo.

    Captura de ecrã a mostrar como ler as informações na página de atualização de dados.

  9. Selecione Relatório de Pesquisa Cognitiva do Azure para exibir o relatório.

    Captura de tela mostrando como selecionar o relatório na página de atualização de dados.

  10. Atualize a página depois de abrir o relatório para que ele seja aberto com seus dados.

    Captura de ecrã do relatório do Power BI.

Modificar parâmetros do aplicativo

Se você quiser visualizar dados de uma conta de armazenamento diferente ou alterar o número de dias de dados a serem consultados, siga as etapas abaixo para alterar os parâmetros Dias e StorageAccount .

  1. Navegue até seus aplicativos do Power BI, localize seu aplicativo de pesquisa e selecione a ação Editar para continuar no espaço de trabalho.

  2. Selecione Configurações nas opções do Conjunto de dados.

    Captura de ecrã a mostrar como selecionar Definições a partir das opções do Conjunto de Dados da Pesquisa Cognitiva do Azure.

  3. Na guia Conjuntos de dados, altere os valores dos parâmetros e selecione Aplicar. Se houver um problema com a conexão, atualize as credenciais da fonte de dados na mesma página.

  4. Navegue de volta para o espaço de trabalho e selecione Atualizar agora nas opções do Conjunto de dados.

    Captura de tela mostrando como selecionar a opção Atualizar agora.

  5. Abra o relatório para exibir os dados atualizados. Também pode ser necessário atualizar o relatório para exibir os dados mais recentes.

Solução de problemas de relatório

Se não conseguir ver os seus dados, experimente estes passos de resolução de problemas:

  1. Abra o relatório e atualize a página para se certificar de que está a visualizar os dados mais recentes. Há uma opção no relatório para atualizar os dados. Selecione esta opção para obter os dados mais recentes.

  2. Verifique se o nome da conta de armazenamento e a chave de acesso fornecidos estão corretos. O nome da conta de armazenamento deve corresponder à conta configurada com os logs do serviço de pesquisa.

  3. Confirme se sua conta de armazenamento contém os contêineres insights-logs-operationlogs e insights-metrics-pt1m e se cada contêiner tem dados. Os logs e métricas estarão dentro de algumas camadas de pastas.

  4. Verifique se o conjunto de dados ainda está sendo atualizado. O indicador de status de atualização é mostrado na etapa 8 acima. Se ainda estiver refrescando, aguarde até que a atualização seja concluída para abrir e atualizar o relatório.

Próximos passos