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:

serviceUrlURL del sitio de Tableau

No configurable

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

connectTimeoutEl cliente de Bridge espera un tiempo cuando intenta conectarse a Tableau Cloud.

Valor predeterminado: 1 minuto

Configurable

operationTimeoutEl 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

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

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

shutdownTimeoutInSecondsNo configurable
downloadDataSourcesIntervalEl 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

checkRefreshDataSourcesIntervalEl 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

extractRefreshTimeoutAplica 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

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

Configurable

JSONLogForExtractRefreshCuando 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: ExtractRefreshMetrics_<timestamp>.json
Cambiar el valor de esta opción de configuración requiere reiniciar el cliente de Bridge.

Las opciones de configuración de loggerSettings se aplican al archivo de registro JSON.

Valor predeterminado: false

Configurable

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

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

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

remoteRequestLogFileLifeSpanSe crea un nuevo conjunto de archivos de registro por cada trabajo de actualización de Bridge que se envía al cliente:

tabbridgeclijob_<process_id, and if the data source is JDBC-based: fjprotocolserver_<process_id>, and stdout_jprotocolserver_<process_id>.

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 maxBackupLogFileCount. De lo contrario, estos archivos de registro se conservan indefinidamente mientras el número de archivos de registro sea menor o igual a maxBackupLogFileCount.

<process_id> representa el ID del proceso de Windows.

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
}
¡Gracias por sus comentarios!Sus comentarios se han enviado correctamente. ¡Gracias!