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, erros 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 as 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 continuar, faça uma cópia desse arquivo caso precise restaurá-lo mais tarde.
3. Localize 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 depende da versão do gateway.

Retenção baseada em idade

A partir de fevereiro de 2023, foi introduzido um novo conceito de retenção com base em idade em um gateway. Esse conceito é o tipo de retenção padrão para novas instalações de gateway.

Para esse tipo de retenção, há dois aspectos principais a serem considerados (em ordem de precedência):

• Espaço máximo em disco a ser consumido pelos logs de 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 em que o nome do arquivo corresponde às datas de entrada de log. Além disso, a partição de arquivo dentro do dia será 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 você quiser alterar os valores padrão dos parâmetros 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. Sempre que o limite é atingido, um novo arquivo é criado com um número sequencial acrescentado.

Retenção baseada em contagem de arquivos

Esse estilo era a lógica de retenção de log padrão em um gateway para versões de dezembro de 2022 e anteriores. Essa 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ê atingir o número máximo de arquivos, ele também normalmente está em ou perto do espaço máximo em disco.

O trecho a seguir 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 retidos, 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, a soma total de todos os arquivos em cada categoria com no máximo 50 MB de tamanho, são mantidos: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

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

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

Conteúdo relacionado

Para obter informações sobre como exportar logs de gateway para solução de problemas, acesse Ferramentas de Solução de Problemas.