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:
serviceUrl | URL do site do Tableau. Não configurável. |
proxyServer | Servidor 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:
connectTimeout | O tempo de espera do cliente Bridge ao tentar se conectar ao Tableau Cloud. Valor padrão: 1 minuto Configurável |
operationTimeout | O 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. |
maxAttemptsToRedirectHttpRequests | Uma 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:
size | Aplica-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:
shutdownTimeoutInSeconds | Não configurável. |
downloadDataSourcesInterval | O 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. |
checkRefreshDataSourcesInterval | O 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. |
extractRefreshTimeout | Impõ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. |
maxRemoteJobConcurrency | Aplica-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 para Configurável. |
JSONLogForExtractRefresh | Quando 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 é: As opções de configuração de Valor padrão: false Configurável. |
dataSources | Aplica-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:
maxLogFileSizeInMB | Tamanho 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. |
maxBackupLogFileCount | Nú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. |
remoteRequestLogFileLifeSpan | Para cada tarefa de atualização do Bridge enviada ao cliente, um novo conjunto de arquivos de registro é criado:
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
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
}