Visualize logs e métricas do Pesquisa de IA do Azure com o Power BI

Nota

O Pesquisa de IA do Azure está disponível através do portal Azure, APIs REST e SDKs do Azure. Também sustenta o Foundry IQ, a camada de conhecimento gerida que transforma conteúdos empresariais em bases de conhecimento reutilizáveis e conscientes de permissões para agentes no portal Microsoft Foundry.

O Pesquisa de IA do Azure 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 Power BI está atualmente listado com o nome de produto legado Azure Cognitive Search no AppSource e com os rótulos de relatório dentro da aplicação.

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. Vá para o 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. Marque Arquivar numa conta de armazenamento, forneça as informações da respetiva conta de armazenamento e marque 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 contentor insights-logs-operationlogs para operações e um contentor 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 está listado como 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ã mostrando o modelo de aplicação do Power BI com o nome legado do Azure Cognitive Search.

  5. Selecione Conectar seus dados.

    Captura de ecrã a mostrar como se ligar aos seus dados na aplicação modelo Power BI.

  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ã que mostra como introduzir o nome da conta de armazenamento e o número de dias na página de Ligação aos seus dados.

  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ã que mostra como definir o método de autenticação, a chave da conta e o nível de privacidade na página de ligação.

  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 Azure Cognitive Search Report (nome do relatório legado) para visualizar o relatório.

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

  10. Atualiza a página depois de abrires o relatório para que ele seja aberto com os teus dados.

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

Modificar parâmetros do aplicativo

Se quiser visualizar dados de uma conta de armazenamento diferente ou alterar o número de dias de dados a consultar, siga estes passos para alterar os parâmetros de Dias e Conta de Armazenamento .

  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ã que mostra como selecionar Definições nas opções do conjunto de dados no espaço de trabalho do Power BI.

  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 que a sua conta de armazenamento contém os contentores insights-logs-operationlogs e insights-metrics-pt1m, e que cada contentor tem dados. Os registos e métricas estão aninhados em vários níveis 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 a atualizar, aguarde a conclusão da atualização para abrir e atualizar o relatório.

Próximos passos

  • Última atualização a