Configuración de archivos de registro para la puerta de enlace de datos local

Hay tres categorías de registros de servicio para una puerta de enlace de datos local: información, error y red. Esta categorización proporciona una experiencia de solución de problemas que le permite centrarse en el área específica de un error o problema.

Para comprobar las configuraciones de registro, siga estos pasos:

1. Abra el archivo de configuración de puerta de enlace Microsoft.PowerBI.EnterpriseGateway.exe.config, que de forma predeterminada debe encontrarse en \Archivos de programa\Puerta de enlace de datos local.
2. Antes de continuar, realice una copia de este archivo solo en caso de que necesite restaurarlo más adelante.
3. Busque el agente ApplicationFileTraceListenerde escucha , que está en system.diagnostics.

En las secciones siguientes se proporcionan los detalles de configuración por tipo de retención, que depende de la versión de la puerta de enlace.

Retención basada en edades

A partir de febrero de 2023, se introdujo el nuevo concepto de retención basado en la antigüedad dentro de una puerta de enlace. Este concepto es el tipo predeterminado de retención para las nuevas instalaciones de puerta de enlace.

Para este tipo de retención, hay dos aspectos principales que se deben tener en cuenta (en orden de prioridad):

• Espacio máximo en disco que consumirán los registros de puerta de enlace (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log), con un valor predeterminado de 5 GB.
• Período de retención en días, con un valor predeterminado de 30 días.

En esta nueva lógica, se garantiza que para cada nuevo día se aprovisione un nuevo archivo de registro. Este aprovisionamiento garantiza que la información de un día determinado esté presente en los archivos de registro donde el nombre de archivo coincide con las fechas de entrada del registro. Además, la partición de archivo dentro del día se realiza si se alcanza el tamaño máximo de archivo individual (valor predeterminado de 100 MB).

  <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>

Si desea cambiar los valores de parámetros predeterminados de retención, debe ajustarlos en el initializeData valor. En la lista siguiente se describe cada parámetro:

• Período de retención en días (un valor entre 1 y 365 días).
• Tamaño total máximo en MB que pueden consumir los tres tipos de archivo de registro.
• Tamaño máximo en MB que cada archivo de registro puede tener individualmente. Cada vez que se alcanza el límite, se crea un nuevo archivo con un número secuencial anexado.

Retención basada en el número de archivos

Este estilo era la lógica de retención de registros predeterminada dentro de una puerta de enlace para las versiones de diciembre de 2022 y anteriores. Esta lógica tiene dos conceptos principales:

• Número de archivos que se van a conservar por tipo de registro (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
• Espacio máximo en disco que se va a consumir por tipo de registro (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

Los archivos se particionan en consecuencia con los criterios enumerados anteriormente. Por lo tanto, siempre que alcance el número máximo de archivos, también suele encontrarse en el espacio en disco máximo o está cerca de ese límite.

El siguiente fragmento del archivo de configuración de puerta de enlace Microsoft.PowerBI.EnterpriseGateway.exe.config contiene las tres categorías: GatewayInfo.log, GatewayErrors.logy 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>

De forma predeterminada, el archivo de configuración de puerta de enlace se encuentra en el directorio \Archivos de programa\Puerta de enlace de datos local. Para establecer el número de archivos de registro que se van a conservar, cambie el primer número del valor del initializeData archivo. Para configurar el tamaño de cada archivo de registro, cambie el segundo número.

En el ejemplo siguiente se especifica que se conservan 20 archivos de registro, la suma total de todos los archivos de cada categoría no tiene más de 50 MB de tamaño: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

¿La nueva lógica de retención basada en antigüedad se aplica de forma predeterminada a mi instalación de puerta de enlace de datos local existente?

No. Esta lógica de retención por ahora se aplica a instalaciones de puerta de enlace completamente nuevas. Las gateways existentes al actualizar a las versiones de febrero de 2023 o posteriores deben mantener su lógica de retención de registros actual (retención basada en el número de archivos).

Contenido relacionado

Para obtener información sobre cómo exportar registros de puerta de enlace para solucionar problemas, vaya a Herramientas de solución de problemas.