Modifier les paramètres du client Bridge

L’administrateur de site peut modifier plusieurs paramètres du client Bridge afin de changer le mode d’exécution du client.

Exigences du client Windows

Pour les clients Windows, l’emplacement par défaut du fichier de configuration est C:\Users\jdupont\Documents\My Tableau Bridge Repository\Configuration\TabBridgeClientConfiguration.txt. Vous devez redémarrer le client pour que les modifications apportées au fichier de configuration prennent effet.

Bridge pour conteneurs Linux

Le fichier TabBridgeClientConfiguration.txt est généré avec des configurations par défaut la première fois que vous exécutez le client Bridge.

Pour apporter des modifications au fichier de configuration, modifiez le fichier TabBridgeClientConfiguration.txt et créez un nouveau conteneur Docker avec la nouvelle version du fichier. Pour en savoir plus sur la création et la mise à jour d’un conteneur, consultez Containerize an application.

Anciennes programmations Bridge

Dans certains cas, un propriétaire de source de données peut être chargé de certaines des tâches décrites dans cette rubrique s’il gère son propre client pour exécuter les anciennes programmations Bridge.

Paramètres du client Bridge

serviceConnectionSettings

Configuration : serviceConnectionSettings

Options :

serviceUrlURL du site Tableau.

Non configurable.

proxyServerServeur proxy et port.

Configurable

Exemple

Vous devez redémarrer le client pour que les modifications apportées au fichier de configuration prennent effet.

"serviceConnectionSettings" : {
	"serviceUrl" : "https://online.tableau.com",
	"proxyServer" : {
	"serverName" : "http://localhost",
	"serverPort" : 8888
	}

connexion

Configuration : connection

Options :

connectTimeoutLe temps d’attente du client Bridge lors de la tentative de connexion à Tableau Cloud.

Valeur par défaut : 1 minute

Configurable.

operationTimeoutLe temps d’attente du client Bridge pour chaque appel d’API de serveur (tel que VizPortal) lorsqu’une connexion a été établie à Tableau Cloud.

Valeur par défaut : 15 minutes

Configurable.

maxAttemptsToRedirectHttpRequestsUn appel d’API vers un serveur peut être redirigé de POD vers POD. Ce nombre spécifie le nombre maximum de redirections par appel d’API du serveur. Valeur par défaut : 20

Configurable.

Exemple

"connection" : {
	"connectTimeout" : "00:01:00",
	"operationTimeout" : "00:15:00",
	"maxAttemptsToRedirectHttpRequests" : 20
	}

connectionPool

Configuration : connectionPool

Options :

sizeS'applique aux programmations d’actualisations Bridge.

Le nombre de jetons d’actualisation générés au moment de la connexion. Le client Bridge utilise des jetons d’actualisation lorsqu’une connexion à Tableau Cloud est nécessaire. Les tâches d’actualisation sont traitées simultanément et chaque tâche nécessite un jeton.

Valeur par défaut : 10

Valeur minimale : 1

Valeur maximale : 100.

Configurable.

Exemple

Par défaut, chaque client d’un pool peut équilibrer la charge de 10 tâches d’actualisation simultanés au maximum. Si le nombre de tâches d’actualisation en cours d’exécution à un moment donné dépasse la capacité de votre pool de clients ou si vous disposez des ressources matérielles nécessaires pour le prendre en charge, envisagez d’augmenter la capacité de chaque client.

Sur Windows, la modification de la valeur size requiert la dissociation du client. La dissociation supprime l’association entre le site et le client. Cela signifie que pour les sources de données qui sont actualisées à l’aide des anciennes programmations Bridge, la dissociation du client supprime les associations à ces sources de données, ses programmations et toute information de connexion du client. Lors de la modification de la taille du pool Bridge, nous vous recommandons de cliquer sur l’icône Bridge dans la barre d’état système Windows et de noter les sources de données répertoriées pour faciliter le processus de reprogrammation.

"connection" : {
	"connectTimeout" : "00:01:00",
	"operationTimeout" : "00:15:00",
	"maxAttemptsToRedirectHttpRequests" : 20
	},
"connectionPool" : {
	"size" : 10
}

dataSourceRefreshSettings

Configuration : dataSourceRefreshSettings

Options :

shutdownTimeoutInSecondsNon configurable.
downloadDataSourcesIntervalIntervalle de temps pour le téléchargement temporaire des noms des sources de données en direct et des sources de données de l’extrait qui sont attribuées au client pour les anciennes programmations Bridge.

Valeur par défaut : 30 minutes.

Configurable.

checkRefreshDataSourcesIntervalIntervalle de temps nécessaire au client Bridge pour vérifier les sources de données qui lui sont attribuées afin de déterminer si une actualisation est nécessaire pour les anciennes programmations Bridge.

Valeur par défaut : 5 secondes

Configurable.

extractRefreshTimeoutÉtablit un délai pour les actualisations effectuées par le client. Cette limite est la durée maximum autorisée pour l’exécution de l’actualisation d’un seul extrait avant qu’elle soit annulée par le client. Si une actualisation d’extrait est annulée suite à une expiration de délai, vous verrez s’afficher un message dans le client et une alerte courriel sera envoyée au propriétaire de la source de données.

Valeur par défaut : 24 heures.

Pour les connexions virtuelles, le délai d’expiration par défaut de l’actualisation d’extrait est de 2 heures et est contrôlé par Tableau Cloud. Le délai d’expiration ne peut pas être contrôlé par le client Bridge.

Configurable.

maxRemoteJobConcurrencyS'applique aux programmations d’actualisations Bridge. Nombre maximal de tâches d’actualisation à distance autorisées par le client. La valeur de cette configuration doit être égale ou inférieure à celel de connectionPool. Ajustez la valeur maximale aux capacités de votre machine telles que l’unité centrale de traitement et la mémoire vive. Nécessite un redémarrage du client.

Valeur par défaut : 10

Minimum : 1

Maximum : la valeur pour connectionPool

Configurable.

JSONLogForExtractRefreshLorsqu’il est défini sur true, le client génère un fichier journal supplémentaire au format JSON. Le fichier journal capture les métriques des actualisations d’extraits, tant pour les anciennes programmations Bridge que distantes, avec une ligne par extrait.

Le format du fichier journal JSON est lisible par Tableau Desktop et peut être utilisé comme source de données pour créer des visualisations en direct. Pour plus d’informations, consultez la section Fichier JSON.

Voici un exemple de fichier journal : ExtractRefreshMetrics_<timestamp>.json
La modification de la valeur de cette option de configuration nécessite un redémarrage du client Bridge.

Les options de configuration loggerSettings s’appliquent au fichier journal JSON.

Valeur par défaut : false

Configurable.

dataSourcesS’applique aux tâches d’actualisation des anciennes programmations Bridge. Non modifiable par l’utilisateur.
Fournit une liste des emplacements de fichiers locaux mappés pour les sources de données basées sur des fichiers.

Non configurable

Exemple

Pour contrôler l’utilisation abusive des extraits ou des actualisations, vous pouvez appliquer une limite de temps à l’aide de extractRefreshTimeout, également appelée limite de délai d’expiration, pour les actualisations effectuées par un client. Cette limite est la durée maximum autorisée pour l’exécution de l’actualisation d’un seul extrait avant qu’elle soit annulée par le client.

Remarque : Pour les extraits de connexions virtuelles, la valeur par défaut du délai d’expiration extractRefreshTimeout est de 2 heures et ne peut pas être contrôlé par le client Bridge. Comme alternative, vous pouvez modifier la connexion virtuelle pour qu’elle s’actualise dans la fenêtre par défaut de 2 heures ou basculer vers une source de données publiée.

Par défaut, la limite de délai d’expiration pour un client est définie sur 24 heures. Vous pouvez modifier la limite de délai d’expiration pour un client via le fichier de configuration de Bridge. Si une actualisation d’extrait est annulée suite à une expiration de délai, vous verrez s’afficher un message dans le client et une alerte courriel sera envoyée au propriétaire de la source de données.

Vous devez redémarrer le client pour que les modifications apportées au fichier de configuration prennent effet.

"dataSourceRefreshSettings" : {
	"shutdownTimeoutInSeconds" : "00:00:30",
	"downloadDataSourcesInterval" : "00:30:00",
	"checkRefreshDataSourcesInterval" : "00:00:05",
	"extractRefreshTimeout" : "24:00:00",
	"maxRemoteJobConcurrency" : 10,
	"JSONLogForExtractRefresh" : false,
	"dataSources" : [
	]
}

loggerSettings

Configuration : loggerSettings

Options :

maxLogFileSizeInMBTaille maximale des fichiers journaux en Mo. Lorsqu’un fichier journal dépasse cette limite de taille, un nouveau fichier journal est créé.

Valeur par défaut : 25 Mo.

Configurable.

maxBackupLogFileCountNombre maximal de fichiers journaux Bridge autorisés. Lorsque le nombre de fichiers journaux dépasse la limite, le fichier journal le plus ancien est supprimé.

La valeur par défaut est 40.

Configurable.

remoteRequestLogFileLifeSpanPour chaque tâche d’actualisation Bridge envoyée au client, un nouvel ensemble de fichiers journaux est créé :

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

Par défaut, la durée maximale pendant laquelle les fichiers journaux restent dans le dossier Fichiers journaux avant d’être supprimés est de 8 heures si le nombre de fichiers journaux dépasse maxBackupLogFileCount. Sinon, ces fichiers journaux restent tant que le nombre de fichiers journaux est inférieur ou égal à maxBackupLogFileCount.

<process_id>représente l’identifiant de processus Windows.

Valeur par défaut : 8 heures

Configurable.

Exemple

Le client crée des fichiers journaux d’activités dans le cadre de son fonctionnement normal. Vous pouvez utiliser ces fichiers journaux pour surveiller les actualisations, résoudre des problèmes de Bridge ou si l’équipe d’assistance Tableau vous demande des fichiers journaux afin de vous aider à résoudre un problème.

Vous pouvez utiliser le fichier TabBridgeClientConfiguration.txt pour gérer la taille des fichiers journaux Bridge ou augmenter la durée de conservation des fichiers journaux avant leur suppression.

Remarque : Les fichiers journaux nommés tabprotosrv* diffèrent des autres fichiers journaux Bridge. La taille maximale est de 1 Mo et le nombre maximum de fichiers journaux autorisés est de 8 192. Ces valeurs ne sont pas non plus configurables.

"loggerSettings" : {
	"maxLogFileSizeInMB" : 25,
	"maxBackupLogFileCount" : 40,
	"remoteRequestLogFileLifeSpan" : "00:00:00"
}

dataSyncRestartInterval

Configuration : dataSyncRestartInterval

Définit l’intervalle de redémarrage de la synchronisation des données.

Configurable.

internetConnectionMonitorInterval

Configuration : internetConnectionMonitorInterval

Intervalle pendant lequel Bridge teste les connexions Internet à l’aide de commandes Ping pour déterminer si une connexion valide a été établie.

Valeur par défaut : 30 secondes

Configurable.

secureStorageMonitorInterval

Configuration : secureStorageMonitorInterval

Intervalle pendant lequel Bridge détermine le stockage sécurisé.

Non configurable.

cleanUpTempDirOnStartUp

Configuration : cleanUpTempDirOnStartUp

Détermine s’il faut supprimer les fichiers temporaires au démarrage du client Bridge.

Valeur par défaut : true

Configurable.

JSONLogForLiveQuery

Configuration : JSONLogForLiveQuery

Lorsqu’il est défini sur true, le client génère un fichier journal supplémentaire au format JSON. Le fichier journal capture les métriques de la demande de requête en direct, avec une ligne par extrait

Le format du fichier journal JSON est lisible par Tableau Desktop et peut être utilisé comme source de données pour créer des visualisations en direct. Pour plus d’informations, consultez la section Fichier JSON.

La modification de la valeur de cette option de configuration nécessite un redémarrage du client Bridge.

Valeur par défaut : true

Configurable.

Exemple

"dataSyncRestartInterval" : "24:00:00",
"internetConnectionMonitorInterval" : "00:00:30",
"secureStorageMonitorInterval" : "00:00:30",
"cleanUpTempDirOnStartUp" : true,,
"JSONLogForLiveQuery" : true
}

Fichier de configuration par défaut

Pour copier le fichier de configuration par défaut, cliquez sur l’icône Copier dans le presse-papier située dans le coin supérieur droit.

{
	"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
}
Merci de vos commentaires!Votre commentaire s été envoyé avec succès. Merci!