Cambiar la configuración del cliente de Bridge
Hay varias opciones de cliente de Bridge que el administrador del sitio puede configurar para cambiar la forma en que se ejecuta un cliente.
Cliente de Windows
La ubicación predeterminada del archivo de configuración de los clientes de Windows es C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration\TabBridgeClientConfiguration.txt
. Debe reiniciarse el cliente para que se apliquen los cambios realizados en el archivo de configuración.
Bridge para Linux para contenedores
El archivo TabBridgeClientConfiguration.txt
se genera con configuraciones predeterminadas la primera vez que ejecuta el cliente de Bridge.
Para realizar cambios en la configuración, edite el archivo TabBridgeClientConfiguration.txt
y cree un nuevo contenedor de Docker con el archivo actualizado. Para obtener más información sobre cómo crear y actualizar un contenedor, consulte Cómo incluir una aplicación en un contenedor (en inglés).
Programas de Bridge heredados
En algunos casos, un propietario de una fuente de datos podría ser responsable de algunas de las tareas descritas en este tema si mantiene su propio cliente para ejecutar programas de Bridge heredados.
Configuración del cliente de Bridge
serviceConnectionSettings
Configuración: serviceConnectionSettings
Opciones:
serviceUrl | URL del sitio de Tableau No configurable |
proxyServer | Servidor proxy y puerto Configurable |
Ejemplo
Debe reiniciarse el cliente para que se apliquen los cambios realizados en el archivo de configuración.
"serviceConnectionSettings" : {
"serviceUrl" : "https://online.tableau.com",
"proxyServer" : {
"serverName" : "http://localhost",
"serverPort" : 8888
}
connection
Configuración: connection
Opciones:
connectTimeout | El cliente de Bridge espera un tiempo cuando intenta conectarse a Tableau Cloud. Valor predeterminado: 1 minuto Configurable |
operationTimeout | El tiempo de espera del cliente de Bridge para cada llamada a la API del servidor (como VizPortal) después de conectarse correctamente a Tableau Cloud. Valor predeterminado: 15 minutos Configurable |
maxAttemptsToRedirectHttpRequests | Una llamada de API a un servidor se puede redirigir de POD a POD. Este número especifica el número máximo de redireccionamientos por llamada a la API del servidor. Valor predeterminado: 20 Configurable |
Ejemplo
"connection" : {
"connectTimeout" : "00:01:00",
"operationTimeout" : "00:15:00",
"maxAttemptsToRedirectHttpRequests" : 20
}
connectionPool
Configuración: connectionPool
Opciones:
size | Se aplica a programas de actualización de Bridge. El número de tokens de actualización generados en el momento del inicio de sesión. El cliente de Bridge usa tokens de actualización cuando se necesita una conexión a Tableau Cloud. Los trabajos de actualización se procesan simultáneamente y cada trabajo necesita un token. Valor predeterminado: 10 Valor mínimo: 1 Valor máximo: 100. Configurable |
Ejemplo
De forma predeterminada, cada cliente de una agrupación puede llevar a cabo hasta 10 trabajos de actualización a la vez. Si el número de trabajos de actualización que se ejecutan en un momento dado supera la capacidad del grupo de clientes o tiene los recursos de hardware para admitirlo, considere la posibilidad de aumentar la capacidad de cada cliente.
En Windows, cambiar el valor de size
requiere desvincular el cliente. La desvinculación elimina la asociación entre el sitio y el cliente. Esto significa que para las fuentes de datos que se actualizan mediante programas de Bridge heredados, desvincular el cliente elimina las asociaciones a esas fuentes de datos, sus programas y cualquier información de conexión del cliente. Como parte de los cambios de tamaño de la agrupación de Bridge, se recomienda hacer clic en el icono de Bridge en la bandeja del sistema de Windows y anotar las fuentes de datos enumeradas para facilitar el proceso de reprogramación.
"connection" : {
"connectTimeout" : "00:01:00",
"operationTimeout" : "00:15:00",
"maxAttemptsToRedirectHttpRequests" : 20
},
"connectionPool" : {
"size" : 10
}
dataSourceRefreshSettings
Configuración: dataSourceRefreshSettings
Opciones:
shutdownTimeoutInSeconds | No configurable |
downloadDataSourcesInterval | El intervalo de tiempo para la descarga temporal de los nombres de las fuentes de datos en tiempo real y de extracción que se asignan al cliente para los programas heredados. Valor predeterminado: 30 minutos. Configurable |
checkRefreshDataSourcesInterval | El intervalo de tiempo para que el cliente de Bridge verifique las fuentes de datos asignadas al cliente para establecer si se necesita una actualización para los programas heredados. Valor predeterminado: 5 segundos Configurable |
extractRefreshTimeout | Aplica un límite de tiempo en las actualizaciones realizadas por el cliente. El límite de tiempo de espera es el tiempo de más largo permisible para que una sola extracción complete su actualización antes de que el cliente la cancele. Si se cancela una actualización de extracción porque se alcanzó el límite de tiempo de espera, recibirá una notificación en el cliente y se enviará una alerta por correo electrónico al propietario de la fuente de datos. Valor predeterminado: 24 horas. Para conexiones virtuales, el límite de tiempo de espera de actualización de extracción predeterminado es de 2 horas y lo controla Tableau Cloud. El límite de tiempo no lo puede controlar el cliente de Bridge. Configurable |
maxRemoteJobConcurrency | Se aplica a programas de actualización de Bridge. Número máximo de trabajos de actualización remota permitidos por el cliente. El valor de esta configuración debe ser igual o menor que el de connectionPool. Ajuste el valor máximo a las capacidades de su equipo, como la CPU y la memoria RAM. Requiere un reinicio del cliente. Valor predeterminado: 10 Mínimo: 1 Máximo: el valor de Configurable |
JSONLogForExtractRefresh | Cuando se establece en true, el cliente genera un archivo de registro adicional en formato JSON. El registro captura las métricas de las actualizaciones de extracciones, tanto para actualizaciones de Bridge heredadas como remotas, con una línea por extracción. Tableau Desktop puede leer el formato del archivo de registro JSON, y se puede utilizar como fuente de datos para crear visualizaciones en tiempo real. Para obtener más información, consulte Archivo JSON. Este es un ejemplo del archivo de registro: Las opciones de configuración de Valor predeterminado: false Configurable |
dataSources | Se aplica a los trabajos de actualización de programas de Bridge heredados. Los usuarios no pueden editar esto. Proporciona una lista de ubicaciones de archivos locales asignadas para fuentes de datos basadas en archivos. No configurable |
Ejemplo
Para controlar el uso indebido de extracciones o actualizaciones, puede aplicar un límite de tiempo (también conocido como límite de tiempo de espera) en las actualizaciones realizadas por un cliente con extractRefreshTimeout
. El límite de tiempo de espera es el tiempo de más largo permisible para que una sola extracción complete su actualización antes de que el cliente la cancele.
Nota: Para extracciones de conexiones virtuales, el valor de extractRefreshTimeout
es de 2 horas, y no puede ser controlado por el cliente de Bridge. Como alternativa, puede modificar la conexión virtual para que se actualice dentro de la ventana predeterminada de 2 horas o cambiar a una fuente de datos publicada.
De forma predeterminada, el límite de tiempo de espera para un cliente es de 24 horas. Puede cambiar el límite de tiempo de espera de un cliente mediante el archivo de configuración de Bridge. Si se cancela una actualización de extracción porque se alcanzó el límite de tiempo de espera, recibirá una notificación en el cliente y se enviará una alerta por correo electrónico al propietario de la fuente de datos.
Debe reiniciarse el cliente para que se apliquen los cambios realizados en el archivo de configuración.
"dataSourceRefreshSettings" : {
"shutdownTimeoutInSeconds" : "00:00:30",
"downloadDataSourcesInterval" : "00:30:00",
"checkRefreshDataSourcesInterval" : "00:00:05",
"extractRefreshTimeout" : "24:00:00",
"maxRemoteJobConcurrency" : 10,
"JSONLogForExtractRefresh" : false,
"dataSources" : [
]
}
loggerSettings
Configuración: loggerSettings
Opciones:
maxLogFileSizeInMB | Tamaño máximo de los archivos de registro en MB. Cuando un archivo de registro supera ese límite de tamaño, se crea un nuevo archivo de registro. Valor predeterminado: 25 MB. Configurable |
maxBackupLogFileCount | Número máximo de archivos de registro de Bridge permitidos. Cuando el número de archivos de registro supera el límite, se elimina el archivo de registro más antiguo. El valor predeterminado es 40. Configurable |
remoteRequestLogFileLifeSpan | Se crea un nuevo conjunto de archivos de registro por cada trabajo de actualización de Bridge que se envía al cliente:
De forma predeterminada, la cantidad máxima de tiempo que los archivos de registro permanecen en la carpeta Registros antes de eliminarse es de 8 horas si la cantidad de archivos de registro excede
Valor predeterminado: 8 horas Configurable |
Ejemplo
El cliente crea registros de actividades como parte de su funcionamiento normal. Puede usar estos registros para supervisar las actualizaciones, solucionar problemas con Bridge, o bien si el servicio de asistencia de Tableau le solicita los registros para ayudarle a solucionar un problema.
Puede administrar el tamaño de los archivos de registro de Bridge o aumentar el tiempo que permanecen los archivos de registro antes de eliminarse en el archivo TabBridgeClientConfiguration.txt.
Nota: Los archivos de registro denominados tabprotosrv* varían de otros archivos de registro de Bridge. El tamaño máximo es de 1 MB y el número máximo de archivos de registro permitidos es 8192. Estos valores tampoco se pueden configurar.
"loggerSettings" : {
"maxLogFileSizeInMB" : 25,
"maxBackupLogFileCount" : 40,
"remoteRequestLogFileLifeSpan" : "00:00:00"
}
dataSyncRestartInterval
Configuración: dataSyncRestartInterval
Establece el intervalo de reinicio de la sincronización de datos. Configurable |
internetConnectionMonitorInterval
Configuración: internetConnectionMonitorInterval
Intervalo para que Bridge haga ping a Internet para determinar si hay una conexión válida. Valor predeterminado: 30 segundos Configurable |
secureStorageMonitorInterval
Configuración: secureStorageMonitorInterval
El intervalo para que Bridge determine el almacenamiento seguro. No configurable |
cleanUpTempDirOnStartUp
Configuración: cleanUpTempDirOnStartUp
Determina si se eliminan los archivos temporales cuando se inicia el cliente de Bridge. Valor predeterminado: true Configurable |
JSONLogForLiveQuery
Configuración: JSONLogForLiveQuery
Cuando se establece en true, el cliente genera un archivo de registro adicional en formato JSON. El registro recoge las métricas de la solicitud de consulta en tiempo real, con una línea por extracción. Tableau Desktop puede leer el formato del archivo de registro JSON, y se puede utilizar como fuente de datos para crear visualizaciones en tiempo real. Para obtener más información, consulte Archivo JSON. Cambiar el valor de esta opción de configuración requiere reiniciar el cliente de Bridge. Valor predeterminado: true Configurable |
Ejemplo
"dataSyncRestartInterval" : "24:00:00",
"internetConnectionMonitorInterval" : "00:00:30",
"secureStorageMonitorInterval" : "00:00:30",
"cleanUpTempDirOnStartUp" : true,,
"JSONLogForLiveQuery" : true
}
Archivo de configuración predeterminado
Para copiar el archivo de configuración predeterminado, haga clic en el icono Copiar al portapapeles que aparece en la esquina superior derecha.
{
"serviceConnectionSettings" : {
"serviceUrl" : "https://online.tableau.com/",
"connection" : {
"connectTimeout" : "00:01:00",
"operationTimeout" : "00:15:00",
"maxAttemptsToRedirectHttpRequests" : 20
},
"connectionPool" : {
"size" : 10
}
},
"dataSourceRefreshSettings" : {
"shutdownTimeoutInSeconds" : "00:00:30",
"downloadDataSourcesInterval" : "00:30:00",
"checkRefreshDataSourcesInterval" : "00:00:05",
"extractRefreshTimeout" : "24:00:00",
"maxRemoteJobConcurrency" : 10,
"JSONLogForExtractRefresh" : false,
"dataSources" : [
]
},
"loggerSettings" : {
"maxLogFileSizeInMB" : 25,
"maxBackupLogFileCount" : 40,
"remoteRequestLogFileLifeSpan" : "08:00:00"
},
"dataSyncRestartInterval" : "24:00:00",
"internetConnectionMonitorInterval" : "00:00:30",
"secureStorageMonitorInterval" : "00:00:30",
"cleanUpTempDirOnStartUp" : true,
"JSONLogForLiveQuery" : true
}