--- schema_version: "1" id: a02b28aafb85b5282f2c691a24a1f305017da6a43cab6a11546542f5f6e3ed4c title: Arquivo de configuração mestre collection: tableau version: current locale: pt-br portal_url: https://docs.salesforce.com/tableau/current/pt-br/server/rmt-config-configFile.md canonical_url: https://help.tableau.com/current/server/pt-br/rmt-config-configFile.htm source_site: help.tableau.com content_type: documentation content_hash: 2537fe45ebb4ad362aa745a608df58f04aafc59b27db95b761126c0b84b7c310 description: Configure RMT Server options using the configuration file. --- [Pular para o conteúdo principal](#main-content) # 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](https://help.tableau.com/current/server/pt-br/rmt-config-configGui.htm). 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](https://help.tableau.com/current/tableau/pt-br/about-tableau-help.htm). 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: ``` { "db": { "cleanup": { "afterDays": 14, "aggregate": { "afterDays": 3650 } } } } ``` ### 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](https://help.tableau.com/current/server/pt-br/rmt-incidents-index-incidents.htm). | ## 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](https://learn.microsoft.com/pt-br/dotnet/api/system.security.authentication.sslprotocols?view=net-8.0 "SslProtocols Enum"). ``` "server": { "url": "https://rmtserver:443", "https": { "enforce": true, "certificate": { "mode": Default, "local": { "name": null, "password": null }, "store": { "certificateThumbprint": ""} }, "minimumTlsVersion": "Tls13" }, ``` ### Configuração de incidente Consulte [Incidentes](https://help.tableau.com/current/server/pt-br/rmt-incidents-index-incidents.htm) 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](https://help.tableau.com/current/server/pt-br/rmt-admin-logs.htm). ## 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](https://help.tableau.com/current/server/pt-br/rmt-admin-installation.htm#agent-setup) 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](https://help.tableau.com/current/server/pt-br/rmt-admin-logs.htm). ## 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](https://help.tableau.com/current/server/pt-br/rmt-admin-encrypted-data-collection.htm) para obter mais detalhes. Ao configurar o RMT Server ou Agente(s) para mensagens criptografadas: - Os sinalizadores `enabled` e `certificateHostName` devem ser configurados para habilitar a criptografia. - A variável `certificateHostName` DEVE corresponder ao nome canônico (CN=) no certificado do servidor ou a conexão falhará. - Provavelmente, a configuração `port` na seção `mq` precisará ser alterada com base na porta TLS configurada como RabbitMQ. ``` { "mq": { "port": 5671, "tls": { "enabled": true, "certificateHostName": "foo" } } } ``` 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**.