Alterar as configurações do cliente do Bridge

Existem várias configurações do cliente do Bridge que o administrador do site pode configurar para alterar a forma como um cliente funciona.

Cliente Windows

Para clientes Windows, o local padrão do arquivo de configuração é C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration\TabBridgeClientConfiguration.txt. O cliente deve ser reiniciado para que as alterações feitas no arquivo de configuração sejam aplicadas.

Bridge para Linux para contêineres

O arquivo TabBridgeClientConfiguration.txt é gerado com configurações padrão na primeira vez que você executa o cliente Bridge.

Para fazer alterações nas definições de configuração, edite o arquivo TabBridgeClientConfiguration.txt e crie um novo contêiner Docker com o arquivo atualizado. Para obter mais informações sobre como criar e atualizar um contêiner, consulte Conteinerizar um aplicativo.

Agendas do Bridge herdado

Em alguns casos, um proprietário de origem de dados poderá ser responsável por algumas das tarefas descritas neste tópico se mantiver seu próprio cliente para executar agendas do Bridge herdado.

Configurações do cliente Bridge

serviceConnectionSettings

Configuração: serviceConnectionSettings

Opções:

serviceUrlURL do site do Tableau.

Não configurável.

proxyServerServidor proxy e porta.

Configurável

Exemplo

O cliente deve ser reiniciado para que as alterações feitas no arquivo de configuração sejam aplicadas.

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

conexão

Configuração: connection

Opções:

connectTimeoutO tempo de espera do cliente Bridge ao tentar se conectar ao Tableau Cloud.

Valor padrão: 1 minuto

Configurável

operationTimeoutO tempo de espera do cliente Bridge para cada chamada de API do servidor (como VizPortal) após conectar-se com êxito ao Tableau Cloud.

Valor padrão: 15 minutos

Configurável.

maxAttemptsToRedirectHttpRequestsUma chamada de API para um servidor pode ser redirecionada de POD para POD. Esse número especifica o número máximo de redirecionamentos por chamada de API do servidor. Valor padrão: 20

Configurável.

Exemplo

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

connectionPool

Configuração: connectionPool

Opções:

sizeAplica-se a agendas de atualização do Bridge.

O número de tokens de atualização gerados no momento do login. O cliente Bridge usa tokens de atualização quando é necessária uma conexão ao Tableau Cloud. Os trabalhos de atualização são processados simultaneamente, e cada trabalho precisa de um token.

Valor padrão: 10

Valor mínimo: 1

Valor máximo: 100.

Configurável.

Exemplo

Por padrão, cada cliente em um pool pode carregar o balanço de carga de até 10 trabalhos de atualização ao mesmo tempo. Se o número de trabalhos de atualização em execução em um determinado momento exceder a capacidade do seu pool de clientes ou você tiver os recursos de hardware para apoiá-lo, considere aumentar a capacidade de cada cliente.

No Windows, alterar o valor size requer a desvinculação do cliente. A desvinculação remove a associação entre o site e o cliente. Isso significa que, para as fontes de dados atualizadas usando as agendas do Bridge herdado, desvincular o cliente remove associações a essas fontes de dados, suas agendas e quaisquer informações de conexão do cliente. Como parte da modificação do tamanho do pool do Bridge, recomendamos que você clique no ícone do Bridge na bandeja do Sistema Windows e observe as fontes de dados listadas para ajudar no processo de reagendamento.

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

dataSourceRefreshSettings

Configuração: dataSourceRefreshSettings

Opções:

shutdownTimeoutInSecondsNão configurável.
downloadDataSourcesIntervalO intervalo de tempo para o download temporário dos nomes das origens de dados ativas e extração de origens de dados que são atribuídas ao cliente para agendas do Bridge herdado.

Valor padrão: 30 minutos.

Configurável.

checkRefreshDataSourcesIntervalO intervalo de tempo para o cliente Bridge verificar as fontes de dados atribuídas ao cliente para estabelecer se uma atualização é necessária para agendas do Bridge herdado.

Valor padrão: 5 segundos

Configurável.

extractRefreshTimeoutImpõe um limite de tempo para atualizações realizadas pelo cliente. O tempo limite é o maior tempo permitido para que uma única extração conclua uma atualização antes que ela seja cancelada pelo cliente. Se uma atualização for cancelada por ter alcançado o tempo limite, você verá uma mensagem no cliente e um alerta por e-mail será enviado para o proprietário da fonte de dados.

Valor padrão: 24 horas.

Para conexões virtuais, o limite de tempo de atualização de extração padrão é de 2 horas e é controlado pelo Tableau Cloud. O limite de tempo não pode ser controlado pelo cliente Bridge.

Configurável.

maxRemoteJobConcurrencyAplica-se a agendas de atualização do Bridge. Número máximo de trabalhos de atualização remota permitidos pelo cliente. O valor para esta configuração deve ser igual ou menor que o connectionPool. Ajuste o valor máximo para as capacidades da sua máquina, como CPU e RAM. Requer uma reinicialização do cliente.

Valor padrão: 10

Mínimo: 1

Máximo: o valor paraconnectionPool

Configurável.

JSONLogForExtractRefreshQuando definido como true, o cliente gera um arquivo de registro adicional no formato JSON. O registro captura as métricas de atualizações de extração, para atualizações do Bridge legadas e remotas, com uma linha por extração.

O formato do arquivo de log JSON pode ser lido pelo Tableau Desktop e pode ser usado como fonte de dados para criar visualizações ao vivo. Para obter mais informações, consulte Arquivo JSON.

Um exemplo do arquivo de registro é: ExtractRefreshMetrics_<timestamp>.json
Alterar o valor desta opção de configuração requer uma reinicialização do cliente Bridge.

As opções de configuração de loggerSettings se aplicam ao arquivo de registro JSON.

Valor padrão: false

Configurável.

dataSourcesAplica-se a trabalhos de atualização de agendamento do Bridge herdados. Não editável pelo usuário.
Fornece uma lista de locais de arquivos locais mapeados para fontes de dados baseadas em arquivo.

Não configurável

Exemplo

Para reger o uso indevido de extratos ou atualizações, você pode impor um prazo usando extractRefreshTimeout, também conhecido como limite de tempo limite, para atualizações realizadas por um cliente. O tempo limite é o maior tempo permitido para que uma única extração conclua uma atualização antes que ela seja cancelada pelo cliente.

Observação: para extrações de conexões virtuais, o padrão de extractRefreshTimeout é de 2 horas e não pode ser controlado pelo cliente Bridge. Como alternativa, você pode modificar a conexão virtual para atualizar dentro da janela padrão de 2 horas ou alternar para uma fonte de dados publicada.

Por padrão, o tempo limite para um cliente é de 24 horas. É possível alterar o tempo limite de um cliente por meio do arquivo de configuração do Bridge. Se uma atualização for cancelada por ter alcançado o tempo limite, você verá uma mensagem no cliente e um alerta por e-mail será enviado para o proprietário da fonte de dados.

O cliente deve ser reiniciado para que as alterações feitas no arquivo de configuração sejam aplicadas.

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

loggerSettings

Configuração: loggerSettings

Opções:

maxLogFileSizeInMBTamanho máximo dos arquivos de registro em MB. Quando um arquivo de registro excede o limite, um novo é criado.

Valor padrão: 25 MB.

Configurável.

maxBackupLogFileCountNúmero máximo de arquivos de registro do Bridge permitidos. Quando o número de arquivos de registro excede o limite, o arquivo de registro mais antigo é excluído.

O padrão é 40.

Configurável.

remoteRequestLogFileLifeSpanPara cada tarefa de atualização do Bridge enviada ao cliente, um novo conjunto de arquivos de registro é criado:

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

Por padrão, o tempo máximo que os arquivos de registro permanecem na pasta Registros antes de serem excluídos é de 8 horas se o número de arquivos de registro exceder maxBackupLogFileCount. Caso contrário, esses arquivos de registro permanecem indefinidamente enquanto o número de arquivos de registro é menor ou igual a maxBackupLogFileCount.

<process_id>representa a ID do processo do Windows.

Valor padrão: 8 horas

Configurável.

Exemplo

O cliente cria logs de atividades como parte de sua operação usual. Você pode usar esses registros para monitorar atualizações, solucionar problemas com o Bridge ou se o Suporte do Tableau solicitar registros para ajudar a resolver um problema.

Você pode gerenciar o tamanho dos arquivos de registro do Bridge ou aumentar o tempo que os arquivos de registro permanecem antes de serem excluídos do arquivo TabBridgeClientConfiguration.txt.

Observação: os arquivos de registro chamados tabprotosrv* são diferentes de outros arquivos de registro do Bridge. O tamanho máximo é de 1 MB, e o número máximo de arquivos de registro permitidos é de 8.192. Esses valores também não são configuráveis.

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

dataSyncRestartInterval

Configuração: dataSyncRestartInterval

Define o intervalo de reinicialização do Data Sync.

Configurável.

internetConnectionMonitorInterval

Configuração: internetConnectionMonitorInterval

Intervalo para o Bridge fazer ping na Internet para determinar se há uma conexão válida.

Valor padrão: 30 segundos

Configurável.

secureStorageMonitorInterval

Configuração: secureStorageMonitorInterval

Intervalo para o Bridge determinar o armazenamento seguro.

Não configurável.

cleanUpTempDirOnStartUp

Configuração: cleanUpTempDirOnStartUp

Determina se os arquivos temporários devem ser removidos quando o cliente Bridge for iniciado.

Valor padrão: true

Configurável.

JSONLogForLiveQuery

Configuração: JSONLogForLiveQuery

Quando definido como true, o cliente gera um arquivo de registro adicional no formato JSON. O registro captura as métricas da solicitação de consulta ao vivo, com uma linha por extração

O formato do arquivo de log JSON pode ser lido pelo Tableau Desktop e pode ser usado como fonte de dados para criar visualizações ao vivo. Para obter mais informações, consulte Arquivo JSON.

Alterar o valor desta opção de configuração requer uma reinicialização do cliente Bridge.

Valor padrão: true

Configurável.

Exemplo

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

Arquivo de configuração padrão

Para copiar o arquivo de configuração padrão, clique no ícone Copiar para área de transferência no canto superior direito.

{
	"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
}
Agradecemos seu feedback!Seu feedback foi enviado. Obrigado!