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

La puerta de enlace de datos local tiene tres categorías de registros de servicio: información, error y red. Esta categorización proporciona una experiencia de solución de problemas que puede 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 la puerta de enlace Microsoft.PowerBI.EnterpriseGateway.exe.config. De forma predeterminada, puede encontrar este archivo en \Program Files\On-premises data gateway.
2. Realice una copia de este archivo en caso de que necesite restaurarlo más adelante.
3. Busque el listener ApplicationFileTraceListener, 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, la puerta de enlace incorpora un nuevo concepto de retención en función de la antigüedad. Este concepto es el tipo predeterminado de retención para las nuevas instalaciones de puerta de enlace.

Para este tipo de retención, tenga en cuenta dos aspectos principales (en orden de prioridad):

• Espacio máximo en disco para 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, la puerta de enlace garantiza que, para cada nuevo día, cree 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 puerta de enlace realiza la creación de particiones de archivos en el día 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>

Para cambiar los valores predeterminados del parámetro de retención, ajuste el valor initializeData. 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, la puerta de enlace 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 conservarán por tipo de registro (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
• Espacio máximo en disco que se consumirá por tipo de registro (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

Los archivos se particionan según estos criterios. Por lo tanto, siempre que alcance el número máximo de archivos, normalmente se alcanza el espacio máximo en disco.

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.log y 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 y 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 se aplica actualmente solo a las nuevas instalaciones de puerta de enlace. Las puertas de enlace existentes que se actualizan a la versión de febrero de 2023 o a versiones posteriores conservan su lógica actual de retención de registros (retención basada en el número de archivos).

Consentimiento del administrador para diagnósticos de puerta de enlace (versión preliminar)

El consentimiento del administrador para los diagnósticos de puerta de enlace es una característica que los administradores usan para controlar explícitamente si los datos de diagnóstico de las puertas de enlace de datos locales se recopilan y envían a la nube.

La característica de diagnóstico de puerta de enlace presenta un modelo controlado por consentimiento para asegurarse de que los datos potencialmente confidenciales, como los registros de Mashup, solo se transmiten después de la aprobación administrativa. También permite funcionalidades futuras de supervisión y diagnóstico. Por ahora, esta característica solo se aplica al artefacto dataflows Gen2. Para obtener más información, consulte Descarga de registros de actualización detallados.

Cómo funciona

Los administradores de puerta de enlace pueden habilitar diagnósticos de puerta de enlace en la configuración de la puerta de enlace. Al habilitar esta configuración, la puerta de enlace comienza a recopilar y enviar datos de diagnóstico a la nube.

Los administradores de inquilinos proporcionan una capa adicional de gobernanza mediante el control del consentimiento de toda la organización para los diagnósticos. De forma predeterminada, los administradores de la puerta de enlace pueden habilitar los diagnósticos sin necesidad de aprobación a nivel de inquilino. Sin embargo, los administradores de inquilinos pueden revocar el consentimiento en cualquier momento para detener la recopilación de datos de diagnóstico en todas las puertas de enlace de la organización.

Si se revoca el consentimiento del nivel de inquilino, todas las puertas de enlace dejarán de enviar datos de diagnóstico inmediatamente y se finalizará cualquier transferencia de datos en curso.

Para una aplicación inmediata, al reiniciar la puerta de enlace de datos local, se terminan las últimas cargas de diagnóstico.

El servicio almacena los datos de diagnóstico de la puerta de enlace durante 24 horas en una Azure Data Lake Storage administrada por el servicio. Después de 24 horas, los datos ya no están disponibles para su descarga.

Comportamiento de carga

Cuando habilita el diagnóstico de la puerta de enlace, la puerta de enlace carga los archivos de diagnóstico en lotes periódicos. Las subidas no son transmisiones continuas ni se realizan en tiempo real. La puerta de enlace comprueba si hay archivos de diagnóstico que se pueden cargar aproximadamente cada 60 segundos, por lo que suele haber un retraso de entre 1 y 2 minutos entre la generación de trazas y su disponibilidad en el almacenamiento administrado por Microsoft.

Cada carga consiste en una solicitud HTTPS saliente de corta duración realizada desde el equipo de puerta de enlace. Una vez cargado correctamente un archivo de diagnóstico, la puerta de enlace elimina inmediatamente la copia de almacenamiento provisional local.

Requisitos de red

Agregue la siguiente fila a la tabla de requisitos de red:

La cuenta de almacenamiento que se usa para la carga de diagnósticos se administra Microsoft y puede variar según la región. Dado que el nombre de la cuenta depende de la región, permita el tráfico HTTPS saliente a *.dfs.core.windows.net o use la etiqueta de servicio Azure Storage.

Si su entorno usa un proxy que inspecciona TLS, asegúrese de que el proxy conserve la URL completa de la solicitud, incluida la cadena de consulta SAS. El token de SAS es necesario para que la puerta de enlace cargue archivos de diagnóstico.

Habilitar el diagnóstico de puerta de enlace

Solo puede habilitar los diagnósticos de puerta de enlace en la nube desde Administrar conexiones y puertas de enlace en el servicio Power BI o Microsoft Fabric. La aplicación de puerta de enlace de datos local no tiene una configuración para habilitar esta característica.

Antes de habilitar el diagnóstico de puerta de enlace, compruebe los siguientes requisitos previos:

• La puerta de enlace se ejecuta en modo estándar. No se admiten puertas de enlace de modo personal.
• El seguimiento de ETW está habilitado en la puerta de enlace.
• En el caso de los clústeres de puerta de enlace, cada miembro del clúster carga diagnósticos de forma independiente. Asegúrese de que las reglas de proxy y firewall de salida están configuradas para cada nodo de puerta de enlace del clúster.

Espacio en disco y superficie de almacenamiento

Los datos temporales de diagnóstico de la puerta de enlace se escriben en la ruta LOCALAPPDATA de la cuenta de servicio de la puerta de enlace, no en el directorio de instalación de la puerta de enlace. La subcarpeta MSessions contiene los archivos temporales locales que se usan para cargar los archivos de diagnóstico.

En estado estable, la retención local suele ser aproximadamente de uno a dos minutos porque los archivos se eliminan inmediatamente después de la carga correcta. En escenarios de error o reintento, los datos de almacenamiento provisional local pueden permanecer hasta una hora aproximadamente.

Este espacio de almacenamiento es independiente y adicional al límite local de retención de registros de 5 GB documentado para los registros de la puerta de enlace. Como punto de partida, planee aproximadamente entre 5 y 10 GB de espacio de disco libre adicional en cada máquina de puerta de enlace y, a continuación, supervise el uso real en su entorno y ajuste según sea necesario.

Estado de seguridad de la carga de datos de diagnóstico

La carga de diagnósticos de puerta de enlace se realiza mediante un token SAS de corta duración con ámbito de directorio a través de HTTPS. El token de SAS es válido durante un tiempo limitado, actualmente hasta nueve horas, y concede solo permisos orientados a escritura, como Agregar, Escribir y Crear.

La puerta de enlace puede cargar archivos de diagnóstico, pero no puede consultar, listar ni enumerar los datos de diagnóstico cargados.

Preguntas más frecuentes sobre diagnósticos de puerta de enlace para puertas de enlace de datos locales en Fabric

La configuración de diagnóstico de las puertas de enlace de datos locales ayuda a recopilar registros de diagnóstico detallados para solucionar problemas en las operaciones de actualización de Fabric Dataflow Gen2. En esta sección se responden preguntas comunes sobre dónde se almacenan los registros cargados, qué información se recopila, quién puede acceder a los registros y si el almacenamiento tiene un costo adicional.

¿Se requiere un registro adicional para el diagnóstico de puerta de enlace?

Los diagnósticos de puerta de enlace y el registro adicional son características independientes. No se requiere ningún registro de eventos adicional para la carga de datos de diagnóstico.

Las dos funciones escriben en destinos diferentes: el registro adicional genera registros locales más detallados, mientras que el diagnóstico de la puerta de enlace prepara localmente los datos de diagnóstico y los carga en almacenamiento administrado por Microsoft después del consentimiento del inquilino y de la habilitación en el nivel de la puerta de enlace.

¿Cuál es la relación entre la configuración de diagnóstico de las puertas de enlace de datos locales y los flujos de datos?

La configuración de diagnóstico de puertas de enlace de datos locales solo se aplica actualmente a Fabric Dataflow Gen2. Cuando se ejecuta una actualización de Dataflow Gen2:

• La puerta de enlace recopila información de diagnóstico necesaria para solucionar problemas.
• El sistema carga los registros de mashup pertinentes en el almacenamiento administrado por Microsoft.
• Los registros se asocian a la ejecución de la actualización.
• Los usuarios pueden descargar los diagnósticos detallados desde el historial de actualización de Dataflow Gen2.

Esta funcionalidad también puede admitir escenarios de diagnóstico futuros.

¿Qué registros se recopilan y cargan?

Actualmente, la configuración de diagnóstico de las puertas de enlace de datos locales carga principalmente los registros del motor Mashup asociados a las operaciones de actualización de Dataflow Gen2 en Fabric.

Entre los ejemplos de información recopilada se incluyen:

• Detalles de ejecución de la actualización de Dataflow Gen2.

• Diagnósticos del motor de Mashup.

• Procesamiento de consultas y trazas de ejecución.

¿Dónde se almacenan los registros cargados?

La región de registro de Power BI o Fabric del inquilino determina la ubicación de almacenamiento. El almacenamiento administrado por Microsoft en la región del inquilino correspondiente almacena los registros cargados.

¿Qué regiones de Azure admiten esta característica?

Todas las regiones compatibles con Fabric que ofrecen soporte de infraestructura de almacenamiento administrado admiten la configuración de diagnóstico de las puertas de enlace de datos locales. Esta característica no está disponible en la región de Qatar.

¿Los datos cargados contienen información confidencial?

Yes. Los diagnósticos cargados pueden contener información que los clientes consideran confidenciales. De forma predeterminada, la característica está deshabilitada. Revise las directivas de soporte técnico y control de datos de su organización antes de optar por la configuración de diagnóstico de puertas de enlace de datos locales.

¿Cuánto tiempo se almacenan los registros?

El sistema conserva los datos de diagnóstico durante 24 horas. Puede descargar datos de las ejecuciones de Dataflow Gen2 en Fabric durante este periodo de 24 horas.

¿Quién puede acceder a los registros cargados?

El acceso está estrechamente controlado. El personal de Microsoft no accede habitualmente a los registros cargados. El acceso está restringido de forma predeterminada y solo se concede cuando sea necesario en los procedimientos operativos aprobados.

¿Hay algún costo adicional para almacenar estos registros?

No. A partir de hoy, la configuración de diagnóstico de puertas de enlace de datos locales se proporciona sin costo adicional.

Troubleshooting

Los diagnósticos están habilitados, pero no aparecen registros.

Si los diagnósticos están habilitados, pero los registros de diagnóstico no aparecen, compruebe los siguientes elementos:

1. Confirme el acceso HTTPS saliente en el puerto 443 a *.dfs.core.windows.net.

2. Confirme que la puerta de enlace está en ejecución en modo estándar. No se admiten puertas de enlace de modo personal.

3. Confirme que no se ha revocado el consentimiento del inquilino para los diagnósticos de puerta de enlace.

4. Compruebe GatewayInfo*.log para las líneas de seguimiento DiagnosticsUploader y DiagnosticsStorageClient. Entre los mensajes de traza útiles se incluyen: Se encontraron N archivos que se pueden cargar, AuthenticationFailed, Se alcanzó el número máximo de fallos permitido

5. Si se producen tres errores de carga consecutivos, la recopilación de diagnósticos se detiene hasta que se renueva el acceso. Este comportamiento puede hacer que los diagnósticos parezcan haberse desactivado inesperadamente, aunque la causa raíz sean fallos repetidos de carga.

Contenido relacionado

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