Arquivo de configuração do RMT Server
Este tópico descreve as opções de configuração que você pode usar com o arquivo de configuração. Para fazer isso usando a interface da Web, consulte Configuração do servidor do Resource Monitoring Tool.
Em um esforço para nos alinhar com os valores de Igualdade de nossa empresa, mudamos a terminologia não inclusiva sempre que possível. Como a alteração dos termos em determinados locais pode causar uma alteração significativa, mantemos a terminologia existente, Portanto, você pode continuar a ver os termos em comandos e opções da CLI, pastas de instalação e arquivos de configuração e outras instâncias. Para obter mais informações, consulte Sobre o Tableau help(O link abre em nova janela).
O arquivo de configuração está localizado em %PROGRAMFILES%\Tableau\Tableau Resource Monitoring Tool\master\config\config.json. Esse caminho pode variar dependendo da instalação.
Observação: os valores de configuração são salvos no arquivo de configuração. As alterações podem ser feitas diretamente neste arquivo, mas é aconselhável aproveitar as opções de configuração na interface do usuário e através do utilitário de linha de comando rmtadmin. As alterações no arquivo config exigirão uma reinicialização para ser aplicada.
Será preciso reiniciar o RMT Server após alterar o arquivo de configuração.
Retenção de dados
Por padrão o Resource Monitoring Tool armazena duas semanas de dados detalhados e dez anos de dados agregados de relatórios.
Isso é configurável. Este é um trecho de exemplo que define as configurações de retenção de dados:
Configuração SMTP
Um trecho de exemplo config.json que define as informações SMTP:
{
"smtp": {
"server": "localhost",
"port": 25,
"username": "my-username",
"password": "my-password",
"requireSSL": true
}
}A lista completa dos valores de configuração disponíveis na seção de configuração smtp:
| Chave | Tipo de dados | Obrigatório? | Descrição |
|---|---|---|---|
server | Cadeia de caracteres | Opcional | O servidor SMTP a ser usado. Valor padrão: localhost |
port | Número | Opcional | O número da porta do servidor SMTP. Valor padrão: 25 |
username | Cadeia de caracteres | Opcional | O nome de usuário a ser utilizado se o servidor exigir autenticação. |
password | Cadeia de caracteres | Opcional | A senha a ser utilizada se o servidor exigir autenticação. |
requireSSL | Booleano | Opcional | true, se o servidor SMTP exigir SSL, caso contrário, false. Valor padrão: false |
Configuração de notificação
Um trecho de exemplo config.json que define as informações de notificação:
{
"notifications": {
"email": {
"from": "sender@domain.com",
"to": "recipient1@domain.com,recipient2@domain.com"
}
}
}As informações de notificação global (conforme mostrado acima) podem ser substituídas de acordo com o ambiente na seção environments:
{
"environments": {
"Environment1": {
"notifications": {
"email": {
"from": "sender@domain.com",
"to": "recipient1@domain.com,recipient2@domain.com"
}
}
}
}
}A lista completa dos valores de configuração disponíveis na seção de configuração notifications.email:
| Chave | Tipo de dados | Obrigatório? | Descrição |
|---|---|---|---|
from | Cadeia de caracteres | Obrigatório | O endereço de e-mail do remetente. |
to | Cadeia de caracteres | Obrigatório | Os endereços de e-mail do destinatário. Vários endereços devem ser separados por vírgula ou ponto e vírgula. |
minimumIncidentSeverity | Cadeia de caracteres | Opcional | A gravidade mínima do incidente em que os e-mails serão enviados. Valor padrão: critical. Veja também Resource Monitoring Tool do Tableau - Incidentes. |
Configuração de histograma
Os limites utilizados para gerar histogramas na interface da Web são configuráveis, usando uma matriz de valores que representam cada limite.
A lista completa de histogramas configuráveis na seção monitoring.histograms:
| Chave | Tipo de dados | Obrigatório? | Descrição |
|---|---|---|---|
viewLoadDuration | Matriz de números | Opcional | Os limites do histograma para carregamentos da exibição. Os valores estão em milissegundos. Valor padrão: [1000, 3000, 6000, 10000] |
externalDataRequestDuration | Matriz de números | Opcional | Os limites do histograma para solicitações externas de dados. Os valores estão em milissegundos. Valor padrão: [1000, 3000, 6000, 10000] |
backgroundTaskDuration | Matriz de números | Opcional | Os limites do histograma para tarefas em segundo plano. Os valores estão em milissegundos. Valor padrão: [60000, 300000, 600000, 1800000] |
Como exemplo, para usar os seguintes intervalos de histograma para tudo globalmente:
- ≤ 1 segundo
- > 1 segundo e ≤ 10 segundos
- > 10 segundos e ≤ 30 segundos
- > 30 segundos
A configuração seria da seguinte forma:
{
"monitoring": {
"histograms": {
"viewLoadDuration": [1000, 10000, 30000],
"externalDataRequestDuration": [1000, 10000, 30000],
"backgroundTaskDuration": [1000, 10000, 30000]
}
}
}Os limites do histograma também podem ser definidos por ambiente. Como exemplo, para um ambiente cujo identificador é “staging-environment”, use os seguintes intervalos de histograma da exibição:
- ≤ 2,5 segundos
- > 2,5 segundos e ≤ 5 segundos
- > 5 segundos e ≤ 30 segundos
- > 30 segundos e ≤ 1 minuto
- > 1 minuto e ≤ 10 minutos
- > 10 minutos
A configuração seria da seguinte forma:
{
"environments": {
"staging-environment": {
"monitoring": {
"histograms": {
"viewLoadDuration": [2500, 5000, 30000, 60000, 600000]
}
}
}
}
}O “staging-environment” voltaria para a configuração global do histograma para tarefas em segundo plano.
Versão TLS mínima
Por padrão, o RMT usará uma versão segura do TLS para criptografar o tráfego. A versão mínima padrão é 1.2, mas se você tiver requisitos de segurança específicos que exijam que versões mais antigas do TLS sejam desabilitadas, você pode modificar a seção server.minimumTlsVersion do arquivo de configuração para impor uma versão mínima do TLS, conforme mostrado no trecho de exemplo abaixo, onde a versão mínima é definida como 1.3. A lista de valores válidos para minimumTlsVersion é definida em Protocolos Ssl do .Net Core(O link abre em nova janela).
Configuração de incidente
Consulte Incidentes para obter informações sobre quais opções incidentes estão disponíveis e como configurá-las.
RMT ServerLogging
Consulte Arquivos de registro do Resource Monitoring Tool do Tableau.
Agente
O arquivo de configuração do serviço agente está localizado em %PROGRAMFILES%\Tableau\Tableau Resource Monitoring Tool\agent\config\config.json. Esse caminho pode variar dependendo da instalação.
Será preciso reiniciar o serviço agente após alterar o arquivo de configuração.
Detecção do Tableau Server
Em quase todas as situações, os agentes detectam automaticamente a instalação do Tableau Server e a única configuração necessária é o processo de instalação do agente padrão. Se desejar, você pode configurar manualmente as informações do Tableau Server pelo arquivo config.json.
Um trecho de exemplo config.json que define as informações do Tableau Server necessárias para executar o agente:
{
"agent": {
"tableauServer": {
"override": true,
"productVersion": 2021.4,
"applicationDirectory": "C:\\Tableau\\Tableau Server\\2021.4"
}
}
}As barras invertidas devem ter escape conforme mostrado acima para o formato JSON.
A lista completa dos valores de configuração disponíveis na seção de configuração agent.tableauServer:
| Chave | Tipo de dados | Obrigatório? | Descrição |
|---|---|---|---|
applicationDirectory | Cadeia de caracteres | Obrigatório | O diretório raiz do aplicativo do Tableau Server. |
dataDirectory | Cadeia de caracteres | Opcional | O diretório para obter os arquivos de dados do Tableau Server. |
override | Booleano | Opcional | true para que os valores de configuração tenham precedência sobre quaisquer valores detectados automaticamente. false para que os valores de configuração atuem como um fallback para os valores detectados automaticamente. |
productVersion | Número | Obrigatório | O número da versão do aplicativo do Tableau Server. |
Registro do agente
Consulte Arquivos de registro do Resource Monitoring Tool do Tableau.
Comum
Os valores de configuração comuns estão disponíveis nos aplicativos do RMT Server e Agente. Consulte as seções específicas do aplicativo para obter orientação sobre como localizar o arquivo de configuração.
Será preciso reiniciar o serviço do aplicativo após alterar o arquivo de configuração.
Mensagens criptografadas
Para habilitar mensagens criptografadas, o servidor RabbitMQ deve ser configurado primeiro para permitir o TLS. Consulte a guia do administrador Coleta de dados criptografados para obter mais detalhes.
Ao configurar o RMT Server ou Agente(s) para mensagens criptografadas:
- Os sinalizadores
enabledecertificateHostNamedevem ser configurados para habilitar a criptografia. - A variável
certificateHostNameDEVE corresponder ao nome canônico (CN=) no certificado do servidor ou a conexão falhará. - Provavelmente, a configuração
portna seçãomqprecisará ser alterada com base na porta TLS configurada como RabbitMQ.
A lista completa dos valores de configuração disponíveis na seção de configuração mq.tls:
| Chave | Tipo de dados | Obrigatório? | Descrição |
|---|---|---|---|
enabled | Booleano | Opcional | true permite a criptografia TLS para conexões de mensagens. false usa conexões não criptografadas para mensagens. Valor padrão: false |
certificateHostName | Cadeia de caracteres | Opcional | certificateHostName DEVE corresponder ao nome canônico (CN=) no certificado do servidor ou a conexão falhará. Valor padrão: "" |
Quem pode fazer isso
O administrador do Resource Monitoring Tool ou um usuário do Resource Monitoring Tool com função Gerente de servidor/ambiente.
