Visualizar logs e métricas do Azure AI Search 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 aborda informações sobre consultas, indexação, operações e métricas de serviço.

Observação

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

Configurar o registro em log e instalar o modelo

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

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

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

  3. Encontre o modelo de aplicativo do Power BI no marketplace 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 é chamado Azure Cognitive Search: Analisar logs e métricas.

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

    Captura de tela que mostra o aplicativo Azure Cognitive Search para selecionar na lista de aplicativos.

  5. Selecione Conectar seus dados.

    Captura de tela que mostra como se conectar aos seus dados no aplicativo 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 dias.

    Captura de tela que mostra como inserir o nome da conta de armazenamento e o número de dias a serem consultados na página Conectar ao Azure Cognitive Search.

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

    Captura de tela que mostra como inserir o método de autenticação, a chave de conta e o nível de privacidade na página Conectar ao Azure Cognitive Search.

  8. Aguarde a atualização dos dados. 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 tela que mostra como ler as informações na página de atualização de dados.

  9. Selecione Relatório do Azure Cognitive Search 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 tela 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 Days e StorageAccount.

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

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

    Captura de tela que mostra como selecionar Configurações nas opções do Conjunto de dados do Azure Cognitive Search.

  3. Na guia Conjunto de dados, altere os valores de parâmetro 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 de Conjunto de dados.

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

  5. Abra o relatório para exibir os dados atualizados. Talvez você também precise atualizar o relatório para exibir os dados mais recentes.

Relatório de Solução de Problemas

Se você não conseguir ver seus dados, experimente estas etapas de solução de problemas:

  1. Abra o relatório e atualize a página para certificar-se de que você está exibindo 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 a 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 as métricas estarão dentro de duas 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 sendo atualizado, aguarde até que a atualização seja concluída para abrir e atualizar o relatório.

Próximas etapas