Partilhar via

Configurar arquivos de log para o gateway de dados local

Há três categorias de logs de serviço para um gateway de dados local: informações, erro e rede. Essa categorização fornece uma experiência de solução de problemas que permite que você se concentre na área específica para um erro ou problema.

Para verificar suas configurações de log, execute as seguintes etapas:

  1. Abra o arquivo de configuração do gateway Microsoft.PowerBI.EnterpriseGateway.exe.config, que, por padrão, deve estar localizado em \Arquivos de Programas\Gateway de dados local.
  2. Antes de prosseguir, faça uma cópia deste arquivo para o caso de precisar restaurá-lo mais tarde.
  3. Encontre o ouvinte ApplicationFileTraceListener, que está em system.diagnostics.

As seções a seguir fornecem os detalhes de configuração por tipo de retenção, que dependem da versão do gateway.

Retenção com base na idade

A partir de fevereiro de 2023, foi introduzido o novo conceito de retenção baseado na idade dentro de uma porta de entrada. Este conceito é o tipo de retenção padrão para novas instalações de gateway.

Para este tipo de retenção, há dois aspetos principais a considerar (por ordem de precedência):

  • Espaço máximo em disco a ser consumido pelos logs do gateway (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log), com um valor padrão de 5 GB.
  • Período de retenção em dias, com um valor padrão de 30 dias.

Nessa nova lógica, garantimos que, a cada novo dia, um novo arquivo de log seja provisionado. Esse provisionamento garante que as informações de um determinado dia estejam presentes em arquivos de log onde o nome do arquivo corresponde às datas de entrada do log. Além disso, a partição de arquivo dentro do dia é executada se o tamanho máximo do arquivo individual (padrão de 100 MB) for atingido.

  <system.diagnostics>
    <trace autoflush="true" indentsize="4">
      <listeners>
        <remove name="Default" />
        <add name="ApplicationFileTraceListener" type="Microsoft.PowerBI.DataMovement.Pipeline.Common.Diagnostics.AgeBasedRetentionRotatableFilesManagerTraceListener, Microsoft.PowerBI.DataMovement.Pipeline.Common" initializeData="%LOCALAPPDATA%\Microsoft\On-premises data gateway\,30,5120,100" />
      </listeners>
    </trace>
  </system.diagnostics>

Se quiser alterar os valores dos parâmetros padrão de retenção, deve ajustá-los no valor initializeData. A lista a seguir descreve cada parâmetro:

  • Período de retenção em dias (um valor entre 1 e 365 dias).
  • Tamanho total máximo em MB que pode ser consumido pelos três tipos de arquivo de log.
  • Tamanho máximo em MB que cada arquivo de log pode ter individualmente. Cada vez que o limite é atingido, um novo arquivo é criado com um número sequencial anexado.

Observação

Os logs do gateway usam carimbos de data/hora baseados em UTC, e a rotação diária do arquivo de log ocorre às 00:00 UTC.

Retenção baseada na contagem de arquivos

Esse estilo era a lógica de retenção de log padrão dentro de um gateway para versões de dezembro de 2022 e anteriores. Esta lógica tem dois conceitos principais:

  • Número de arquivos a serem retidos por tipo de log (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
  • Espaço máximo em disco a ser consumido por tipo de log (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

Os arquivos são particionados de acordo com os critérios listados anteriormente. Portanto, sempre que você atinge o número máximo de arquivos, normalmente também está no espaço máximo em disco ou perto dele.

O seguinte trecho do arquivo de configuração do gateway Microsoft.PowerBI.EnterpriseGateway.exe.config contém as três categorias: GatewayInfo.log, GatewayErrors.loge GatewayNetwork.log.

  <system.diagnostics>
    <trace autoflush="true" indentsize="4">
      <listeners>
        <remove name="Default" />
        <add name="ApplicationFileTraceListener"
             type="Microsoft.PowerBI.DataMovement.Pipeline.Common.Diagnostics.RotatableFilesManagerTraceListener, Microsoft.PowerBI.DataMovement.Pipeline.Common"
             initializeData="%LOCALAPPDATA%\Microsoft\On-premises data gateway\,GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50" />
      </listeners>
    </trace>
  </system.diagnostics>

Por padrão, o arquivo de configuração do gateway está localizado no diretório \Arquivos de Programas\Gateway de dados local. Para definir o número de arquivos de log a serem mantidos, altere o primeiro número no valor do initializeData arquivo. Para configurar o tamanho de cada arquivo de log, altere o segundo número.

O exemplo a seguir especifica que 20 arquivos de log, sendo a soma total de todos os arquivos em cada categoria de tamanho não superior a 50 MB, são mantidos: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

A nova lógica de retenção baseada na idade se aplica por padrão à minha instalação de gateway de dados local existente?

Não. Essa lógica de retenção, por enquanto, é aplicada a instalações de gateway completamente novas. Os gateways existentes ao atualizar para versões de fevereiro de 2023 ou posteriores devem manter a sua lógica de retenção de log atual (retenção baseada na contagem de arquivos).

Conteúdo relacionado

Para obter informações sobre como exportar registos do gateway para solução de problemas, vá para Ferramentas de solução de problemas.