Monitorar e otimizar o desempenho do gateway de dados local

Observação

Recentemente, revisamos os documentos do gateway de dados local. Nós os dividimos em conteúdo específico para Power bi e conteúdo geral que se aplica a todos os serviços aos quais o gateway dá suporte. No momento, você está no conteúdo geral. Para fornecer comentários sobre este artigo ou sobre a experiência geral de documentos do gateway, role até a parte inferior do artigo.

Monitoramento de desempenho do gateway (visualização pública)

Para monitorar o desempenho, os administradores de gateway tradicionalmente dependem de monitorar os contadores de desempenho manualmente por meio da ferramenta Monitor de desempenho do Windows. Agora oferecemos logs de consulta adicionais e um arquivo de modelo PBI de desempenho de gateway para visualizar os resultados. Esse recurso fornece novas informações sobre o uso do gateway. Você pode usá-lo para solucionar problemas de consultas de execução lenta.

Observação

Esse recurso está disponível no momento apenas para o gateway de dados local no modo padrão. Ele não está disponível para o modo pessoal.

Habilitar log de desempenho

Para habilitar esse recurso, faça as seguintes alterações no arquivo Microsoft. PowerBI. datamover. Pipeline. GatewayCore. dll. config na pasta \Program programas\gateway data gateway .

  1. Atualize QueryExecutionReportOn para true para habilitar o registro em log adicional para consultas executadas usando o gateway. Habilitar essa opção cria o relatório de execução de consulta e os arquivos de relatório de agregação de execução de consulta.

    <setting name="QueryExecutionReportOn" serializeAs="String">
      <value>True</value>
    </setting>
    
  2. Atualize SystemCounterReportOn para true para habilitar o registro em log adicional para memória e contadores de sistema de CPU. Habilitar essa opção cria o arquivo de relatório de agregação do contador do sistema.

    <setting name="SystemCounterReportOn" serializeAs="String">
      <value>True</value>
    </setting>
    
  3. Há outros valores no arquivo de configuração que você pode atualizar conforme necessário:

    • ReportFilePath: Determina o caminho onde os três arquivos de log são armazenados. Por padrão, esse caminho é \Users\PBIEgwService\AppData\Local\Microsoft\On-premises data gateway\Report ou Windows\ServiceProfiles\PBIEgwService\AppData\Local\Microsoft\On-premises data gateway\Report. O caminho depende da versão do sistema operacional. Se você usar uma conta de serviço para o gateway diferente de PBIEgwService, substitua essa parte do caminho pelo nome da conta de serviço.
    • ReportFileCount: Determina o número de arquivos de log de cada tipo a ser mantido. O valor padrão é 10.
    • ReportFileSizeInBytes: Determina o tamanho do arquivo a ser mantido. O valor padrão é 104.857.600.
    • QuerExecutionAggregationTimeInMinutes: Determina o número de minutos para o qual as informações de execução de consulta são agregadas. O valor padrão é 5.
    • SystemCounterAggregationTimeInMinutes: Determina o número de minutos para o qual o contador do sistema é agregado. O valor padrão é 5.
  4. Depois de fazer as alterações no arquivo de configuração, reinicie o gateway para que esses valores de configuração entrem em vigor. Agora você vê os arquivos de relatório que estão sendo gerados no local especificado para ReportFilePath.

    Observação

    Pode levar até 10 minutos mais a quantidade de tempo definida para QuerExecutionAggregationTimeInMinutes no arquivo de configuração até que os arquivos comecem a aparecer na pasta.

Entender os logs de desempenho

Quando você ativa esse recurso, três novos arquivos de log são criados:

  • O relatório de execução de consulta
  • O relatório de agregação de execução de consulta
  • O relatório de agregação do contador do sistema

O relatório de execução de consulta contém informações detalhadas de execução de consulta. Os atributos a seguir são capturados.

Atributo Descrição
GatewayObjectId Identificador exclusivo do gateway.
RequestId Identificador exclusivo para uma solicitação de gateway. Pode ser o mesmo para várias consultas.
Fonte Contém o tipo de fonte de dados e a fonte de dados.
QueryTrackingId Identificador exclusivo de uma consulta.
QueryExecutionEndTimeUTC Hora em que a execução da consulta foi concluída.
QueryExecutionDuration Srta Duração de uma execução de consulta.
QueryType Tipo de consulta. Por exemplo, a consulta passada pode ser uma Power BI atualização ou DirectQuery. Ou, pode ser consultas do PowerApps e Microsoft Flow.
DataProcessingEndTimeUTC Tempo em que as atividades de processamento de dados, como spooling, recuperação de dados, compactação e processamento de dados foram concluídas.
DataProcessingDuration Srta Duração de atividades de processamento de dados, como spooling, recuperação de dados, compactação e processamento de dados.
Êxito Indica se a consulta foi bem-sucedida ou falhou.
ErrorMessage Se a consulta falhou, indica a mensagem de erro.

O relatório de agregação de execução de consulta contém informações de consulta agregadas a um intervalo de tempo por GatewayObjectId, DataSource, Successe QueryType. O valor padrão é 5 minutos, mas você pode ajustá-lo. Os atributos a seguir são capturados.

Atributo Descrição
GatewayObjectId Identificador exclusivo do gateway.
AggregationStartTimeUTC Início da janela de tempo para a qual os atributos de consulta foram agregados.
AggregationEndTimeUTC Fim da janela de tempo para a qual os atributos de consulta foram agregados.
Fonte Contém o tipo de fonte de dados e a fonte de dados.
Êxito Indica se a consulta foi bem-sucedida ou falhou.
AverageQueryExecutionDuration Srta Tempo médio de execução da consulta para a janela de tempo de agregação.
MaxQueryExecutionDuration Srta Tempo máximo de execução de consulta para a janela de tempo de agregação.
MinQueryExecutionDuration Srta Tempo mínimo de execução da consulta para a janela de tempo de agregação.
QueryType Tipo de consulta. Por exemplo, a consulta passada pode ser uma Power BI atualização ou DirectQuery. Ou, pode ser consultas do PowerApps e Microsoft Flow.
AverageDataProcessingDuration Srta Tempo médio para atividades de processamento de dados, como spooling, recuperação de dados, compactação e processamento de dados para a janela de tempo de agregação.
MaxDataProcessingDuration Srta Tempo máximo para atividades de processamento de dados, como spooling, recuperação de dados, compactação e processamento de dados para a janela de tempo de agregação.
MinDataProcessingDuration Srta Tempo mínimo para atividades de processamento de dados, como spooling, recuperação de dados, compactação e processamento de dados para a janela de tempo de agregação.
Contar Número de consultas.

O relatório de agregação do contador do sistema contém valores de contador do sistema agregados a um intervalo de tempo. O valor padrão é 5 minutos, mas você pode ajustá-lo. Os atributos a seguir são capturados.

Atributo Descrição
GatewayObjectId Identificador exclusivo do gateway.
AggregationStartTimeUTC Início da janela de tempo para os contadores de sistema que foram agregados.
AggregationEndTimeUTC Fim da janela de tempo para os contadores de sistema que foram agregados.
CounterName Os contadores de sistema, que incluem a memória e o uso de CPU pelo gateway, pelo mecanismo de mashup e como geral pela máquina que hospeda o gateway.
Maximizar Valor máximo para o contador do sistema para a janela de tempo de agregação.
Min Valor mínimo do contador do sistema para a janela de tempo de agregação.
Cerca Valor médio do contador do sistema para a janela de tempo de agregação.

Visualizar o desempenho do gateway

Agora, você pode visualizar os dados que estão nos arquivos de log.

  1. Baixe o modelo de PBI de desempenho do gatewaye abra-o usando Power bi desktop.

  2. Na caixa de diálogo que é aberta, verifique se o caminho da pasta corresponde ao valor em ReportFilePath.

    Pop-up para o caminho da pasta

  3. Selecione carregare o arquivo de modelo começará a carregar os dados dos arquivos de log. Todos os visuais são populados usando os dados nos relatórios.

  4. Opcionalmente, salve esse arquivo como um PBIX e publique-o em seu serviço para atualizações automáticas.

Você também pode personalizar esse arquivo de modelo para atender às suas necessidades. Para obter mais informações sobre modelos de Power BI, consulte esta postagem de blog do Microsoft Power bi.

Consultas de execução lenta

Consultas de execução longa podem exigir modificação adicional na fonte de dados ou otimização adicional da própria consulta. Isso pode ser para atualizações de Power BI ou para consultas de banco de dados direta, como Power BI DirectQuery, PowerApps ou aplicativos lógicos do Azure.

Por padrão, o gateway executa o log básico. Se estiver investigando consultas de execução lenta, além de usar o recurso de monitoramento de desempenho, você poderá habilitar temporariamente o registro em log adicional para coletar informações adicionais de log. Para fazer isso, no aplicativo de gateway de dados local , selecione diagnóstico > adicional log.

Ativar log adicional

Habilitar essa configuração provavelmente aumentará o tamanho do log de maneira significativa, com base no uso do gateway. É recomendável que, depois de concluir a revisão dos logs, você desabilite o log adicional. Não recomendamos deixar essa configuração habilitada durante o uso normal do gateway.

Próximas etapas