--- schema_version: "1" id: 3dfa0d04d6b4bc632be96e0747aee345b422a8c2b08532f9be93adf60ad4b43f title: Repositório externo para Resource Monitoring Tool do Tableau collection: tableau version: next locale: pt-br portal_url: https://docs.salesforce.com/tableau/next/pt-br/server/rmt-external-repo.md canonical_url: https://help.tableau.com/v0.0/server/pt-br/rmt-external-repo.htm source_site: help.tableau.com content_type: documentation content_hash: 47cc9a8e2d5dd91edc661c288a9ad194c0b604b3d8860d4ca18a5ab8d256c47c description: Configure an external PostgreSQL repository for the Resource Monitoring Tool. --- [Pular para o conteúdo principal](#main-content) # Repositório externo para Resource Monitoring Tool do Tableau O Resource Monitoring Tool do Tableau usa um banco de dados PostgreSQL como seu repositório para coletar e armazenar dados de monitoramento do Tableau Server usados para fornecer informações de desempenho e uso. Este banco de dados é separado do banco de dados do Tableau Server. Antes da versão 2022.3, esse repositório PostgreSQL era instalado automaticamente com o RMT Server, na mesma máquina do RMT Server e essa era a única opção disponível. A partir da versão 2022.3, você pode reconfigurar o RMT Server para usar um banco de dados PostgreSQL hospedado externamente em vez do banco de dados instalado localmente. Quando o RMT Server é configurado para usar um banco de dados PostgreSQL hospedado externamente, nos referimos a ele como repositório externo. A plataforma compatível para hospedar o repositório externo é uma instância da AWS RDS. Hospedar o banco de dados do repositório externamente permite que você gerencie a disponibilidade, os backups e a recuperação de desastres do componente do repositório do RMT Server. Com a adição desta opção para configurar um repositório externo, o RMT Server pode ser configurado das seguintes formas: - **Continue a usar o repositório instalado localmente:** isso significa que o banco de dados PostgreSQL instalado automaticamente com o RMT Server na mesma máquina será usado como repositório para o RMT Server, e nenhuma outra alteração será feita nesta configuração. - **Configure o RMT Server para usar um repositório externo:** isso significa que o banco de dados PostgreSQL que o RMT usa está hospedado fora do RMT Server. Isso requer fazer algumas alterações de configuração após a instalação. Atualmente, apenas instâncias do AWS RDS têm suporte como plataforma de hospedagem para o banco de dados PostgreSQL. Para configurar e gerenciar o repositório externo, você deve ter um bom conhecimento da plataforma AWS RDS e do banco de dados PostgreSQL. Recomendamos que você use a [documentação no site da AWS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html) para obter instruções relacionadas à plataforma. Você também precisará saber como configurar e gerenciar a configuração do repositório externo paraResource Monitoring Tool . Este tópico fornecerá essas informações nas seções abaixo. ## Nova instalação do Resource Monitoring Tool As instruções detalhadas nesta seção se aplicam a uma nova instalação do Resource Monitoring Tool. Se você tiver uma implantação existente do RMT e quiser migrar para uma configuração de repositório externo, consulte a seção de instalação [Instalação existente do Resource Monitoring Tool](#Migratin) deste tópico. Quando você instala o RMT Server, ele instala automaticamente o banco de dados do repositório na mesma máquina que o RMT Server. O processo para configurar o repositório externo é uma configuração pós-instalação onde você reconfigurará o RMT Server para usar um banco de dados PostgreSQL hospedado externamente. Use as etapas a seguir para instalar o Resource Monitoring Tool e reconfigure o RMT Server para usar um repositório externo: 1. **Crie o repositório externo:** crie uma instância do RDS para hospedar o repositório externo com as seguintes recomendações. - **Especificações mínimas recomendadas da instância do PostgreSQL:** - db.m6g.2xlarge (8 vcpu, 32 GiB RAM) - Armazenamento SSD com 500 GB de espaço em disco - **Valores de configuração da instância:** - Máximo de processos de trabalho: Total de processadores lógicos - Máximo de trabalhadores por reunião: Mín.(Total de processadores lógicos / 2, 4) - Máximo de trabalhadores paralelos: Total de processadores lógicos - Máx. de trabalhadores de manutenção paralela: Mín.(Total de processadores lógicos / 2, 4) - Buffers compartilhados: memória total / 4 - Tamanho efetivo do cache: 75% da memória total - Memória de trabalho de manutenção: Memória total / 16 Linux, Máx. 2GB - 1MB no Windows - Wal Buffers: derivados de buffers compartilhados, provavelmente em torno de 16 MB - Memória de trabalho: derivada de buffers compartilhados e máximo de trabalhadores por reunião Para saber como criar e conectar-se a uma instância de banco de dados PostgreSQL na AWS, consulte [esta página no site de documentação da AWS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html) . 2. **Instale o RMT:** siga as instruções [Instalar o RMT Server usando a linha de comando](https://help.tableau.com/v0.0/server/pt-br/rmt-admin-master-install-cli.htm) para instalar o RMT Server, mas **ignore as etapas para criar um ambiente. Você fará isso depois de configurar o RMT Server para usar o repositório externo** . **Observe que isso instalará inicialmente um banco de dados PostgreSQL local.** 3. **Teste a conexão com o repositório externo:** teste a conexão com o novo banco de dados usando o psql, uma ferramenta administrativa do PostgreSQL que é instalada com o RMT Server; - Navegue até a pasta 'bin' do diretório de instalação do PostgreSQL instalado localmente. `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\prerequisites\postgresql\bin` - Execute o seguinte comando para testar a conexão: Substitua seu próprio valor abaixo por **aws\_rds\_servername** e forneça a senha do PostgreSQL que você criou na AWS quando solicitado. .`\psql.exe -h -p 5432 -d postgres -U postgres` Se você receber um erro neste momento e não conseguir se conectar, revise os valores de parâmetro no comando em relação aos valores do console do AWS RDS. - Quando a conexão tiver sido estabelecida com sucesso, você pode fechar a sessão do psql com o seguinte comando: `\q` 4. Execute `rmtadmin master-setup` **para configurar o RMT Server para usar o repositório externo**. Use os exemplos de comando a seguir e edite o comando para refletir seu caminho de instalação do Resource Monitoring Tool, nome da instância do AWS RDS, número da porta e a senha do usuário administrador do RDS PostgreSQL: - Navegue até o diretório de instalação do RMT Server do Resource Monitoring Tool: `cd 'c:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\'` - Execute o comando para configurar o repositório externo: `./rmtadmin master-setup --db-config=external --db-server= --db-database= --db-port=5432 --db-admin-username=postgres --db-admin-password=` 5. Agora **crie um ambiente** e baixe o arquivo bootstrap: - Execute o seguinte comando para criar um ambiente: `rmtadmin create-env --name= --api-username= --api-password=` - Faça download do arquivo de bootstrap para registrar os Agentes: `rmtadmin bootstrap-file --env= --filename=` As etapas são descritas em detalhes aqui: [Instalar o RMT Server usando a linha de comando](https://help.tableau.com/v0.0/server/pt-br/rmt-admin-master-install-cli.htm). 6. Siga as instruções em [Instalar o Agente usando a linha de comando](https://help.tableau.com/v0.0/server/pt-br/rmt-admin-agent-install-cli.htm) para instalar e registrar agentes nos nós do Tableau Server. ## Instalação existente do Resource Monitoring Tool Há dois caminhos para migrar instalações RMT existentes que estão atualmente usando um repositório local para um repositório externo: o caminho escolhido depende do tamanho e da complexidade do seu ambiente. 1. **Migração com recriação de ambiente:** isso é adequado para instalações RMT que possuem um ambiente de pequeno porte com pouca configuração e alertas, pois esse caminho envolve recriar o ambiente e iniciar novamente e perderá os dados coletados até o momento. Também é necessário reconfigurar o RMT Server para usar um repositório externo, recriar os ambientes e refazer todas as configurações personalizadas, como limites de incidentes, e registrar novamente os Agentes. Isso é muito semelhante a fazer uma nova instalação do RMT descrita [na seção acima,](#New) exceto que você não instalará o RMT neste caso. 2. **Migração manual com perda mínima de dados:** é especificamente para clientes que têm ambientes grandes e complexos e não desejam começar do zero novamente. Essa migração é manual e não é um recurso de migração integrado para RMT. As instruções para fazer isso estão descritas abaixo: ### Migrando manualmente o repositório do Resource Monitoring Tool local para uma instância de banco de dados AWS PostgreSQL externo #### **Etapa 1: crie uma instância do RDS para hospedar o repositório externo** Use as seguintes recomendações ao criar a nova instância do RDS: - **Especificações mínimas recomendadas da instância do PostgreSQL:** - db.m6g.2xlarge (8 vcpu, 32 GiB RAM) - Armazenamento SSD com 500 GB de espaço em disco - **Valores de configuração da instância:** - Máximo de processos de trabalho: Total de processadores lógicos - Máximo de trabalhadores por reunião: Mín.(Total de processadores lógicos / 2, 4) - Máximo de trabalhadores paralelos: Total de processadores lógicos - Máx. de trabalhadores de manutenção paralela: Mín.(Total de processadores lógicos / 2, 4) - Buffers compartilhados: memória total / 4 - Tamanho efetivo do cache: 75% da memória total - Memória de trabalho de manutenção: Memória total / 16 Linux, Máx. 2GB - 1MB no Windows - Wal Buffers: derivados de buffers compartilhados, provavelmente em torno de 16 MB - Memória de trabalho: derivada de buffers compartilhados e máximo de trabalhadores por reunião Para saber como criar e conectar-se a uma instância de banco de dados PostgreSQL na AWS, consulte [esta página no site de documentação da AWS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html) . #### Etapa 2: teste para garantir que você possa se conectar ao novo banco de Teste a conexão com o novo banco de dados usando psql, uma ferramenta administrativa do PostgreSQL que acompanha o RMT Server. Substitua seu próprio valor abaixo por **aws\_rds\_servername** e forneça a senha do PostgreSQL que você criou na AWS quando solicitado. - Navegue até a pasta 'bin' do diretório de instalação do PostgreSQL instalado localmente. `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\prerequisites\postgresql\bin` - Execute o seguinte comando para testar a conexão: Substitua seu próprio valor abaixo por **aws\_rds\_servername** e forneça a senha do PostgreSQL que você criou na AWS quando solicitado. .`\psql.exe -h -p 5432 -d postgres -U postgres` Se você receber um erro neste momento e não conseguir se conectar, revise os valores de parâmetro no comando em relação aos valores do console do AWS RDS. - Quando a conexão tiver sido estabelecida com sucesso, você pode fechar a sessão do psql com o seguinte comando: `\q` #### Etapa 3: obtenha a senha de administrador do banco de dados PostgreSQL local atualmente usado pelo RMT Execute os comandos a seguir para obter a senha de administrador do repositório local. Isso é necessário para fazer um backup dos dados em seu repositório local antes de fazer a migração. - Navegue até a pasta de instalação do RMT Server: `cd 'c:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\'` - Obtenha a senha do administrador: `rmtadmin get db.adminPassword` #### Etapa 4: faça um backup do banco de dados PostgreSQL existente - Primeiro, pare o RMT em preparação para fazer o backup do banco de dados: `rmtadmin stop` - Agora reinicie apenas o serviço de banco de dados para que você possa fazer o backup: `rmtadmin start -db` - Use os scripts de exemplo a seguir e substitua seus próprios valores pelo caminho do arquivo. Se você personalizou a porta, atualize-a também. Forneça a senha da etapa anterior quando solicitado: - Navegue até a pasta bin do repositório local: `cd 'C:\Program Files\Tableau\Tableau Resource Monitoring Tool\prerequisites\postgresql\bin'` - Faça um backup: `pg_dump -f your_file_name.dump -F d -j 10 -Z 5 -d tabrmt -h localhost -p 5555 -U postgres` - `-F d`: gera um arquivo em formato de diretório adequado para entrada no pg\_restore - `-j 10`: executa o backup em paralelo fazendo backup de 10 tabelas simultaneamente - `-Z 5`: especifica o nível de compactação a ser usado **Observação:** os dados recolhidos pelo Resource Monitoring Tool no momento entre esta etapa e a última não serão retidos após a conclusão da migração. #### Etapa 5: configure o RMT Server para apontar para o repositório externo - Reinicie todos os serviços RMT: `rmtadmin restart --all` - Use o seguinte comando como exemplo. Edite o comando para refletir o nome do RDS Server, o nome do banco de dados, a porta e a senha do usuário postgres do RDS. Navegue até a pasta de instalação do RMT Server: `cd 'c:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\'` Configure o repositório externo: `rmtadmin master-setup --db-config=external --db-server= --db-database= --db-port=5432 --db-admin-username=postgres --db-admin-password=` #### Etapa 6: restaure o backup para o repositório externo - Primeiro, pare o RMT Server: `rmtadmin stop` - Restaure o backup que você criou na etapa 4 para a nova instância da AWS RDS PostgreSQL. Edite o script de exemplo fornecido abaixo para refletir o nome e a porta do servidor AWS RDS e verifique se o caminho e o nome do arquivo de despejo estão corretos. Quando solicitado, forneça a senha para o usuário "postgres" no RDS. `pg_restore -j 5 -c -h -p 5432 -U postgres -d tabrmt .dump` - `-j 5`: executa a restauração em paralelo restaurando 5 tabelas simultaneamente - `-c`: limpa (elimina) objetos de banco de dados antes de recriá-los #### Etapa 7: inicie o RMT Server. `rmtadmin start` #### Etapa 8: registre novamente os agentes Depois que as alterações de serviço forem executadas com sucesso, reinicie cada Agente e registre-o novamente usando a interface da Web, seguindo as etapas abaixo. 1. Baixe um novo arquivo de bootstrap do RMT Server. 2. Acesse a interface da Web do Agente navegando até http://localhost:9002/setup/register, importe o bootstrap. 3. Clique em Testar fila de mensagens. Revise as entradas anteriores se você receber um erro. 4. Clique em Conectar-se à fila de mensagens. 5. Na seção Servidor, clique no menu suspenso com “Novo servidor de ambiente” pré-selecionado e, em vez de aceitar o padrão, escolha o servidor que você está tentando registrar na lista. Role a página até a parte inferior e clique no botão "Registrar agente". Para obter mais detalhes ou registrar agentes, consulte [Instalar o Agente usando a linha de comando](https://help.tableau.com/v0.0/server/pt-br/rmt-admin-agent-install-cli.htm). #### Etapa 9: verifique se o RMT Server está em execução e se você está vendo os dados históricos Faça login no RMT Server e verifique se os dados de períodos mais antigos estão presentes e se os novos dados estão sendo processados. Revise também quaisquer valores de configuração personalizados para garantir que tudo seja migrado corretamente. ## Práticas recomendadas de atualização Aqui estão as etapas gerais que você precisa seguir se quiser atualizar a Resource Monitoring Tool do Tableau e migrar para um repositório externo ao mesmo tempo: **Migração com recriação do ambiente:** 1. [Atualize o RMT Server e todos os agentes](https://help.tableau.com/v0.0/server/pt-br/rmt-admin-upgrade.htm) para 2022.3 ou posterior. 2. As etapas de 2 a 4 são muito semelhantes às etapas que você faria para fazer uma nova instalação - consulte [Nova instalação do Resource Monitoring Tool](#New) acima. Isso envolve principalmente: - Criar uma instância de banco de dados AWS PostgreSQL. - Configurar o RMT Server para usar um repositório externo. - Recriar ambientes e registre novamente todos os Agentes. 3. Reconfigurar quaisquer configurações personalizadas. **Observação:** você perderá dados históricos e também precisará reconfigurar qualquer configuração personalizada. Migração manual com perda mínima de dados: 1. [Atualize o RMT Server e todos os agentes](https://help.tableau.com/v0.0/server/pt-br/rmt-admin-upgrade.htm) para a versão 2022.3 ou posterior. 2. Siga as etapas detalhadas na [seção de migração](#Manually). Isso envolve principalmente: - Criar uma instância de banco de dados AWS PostgreSQL. - Fazer um backup do banco de dados PostgreSQL. - Configurar o RMT Server para usar o repositório externo (instância de banco de dados PostgreSQL). - Restaurar o backup para o repositório externo. - Registrar novamente os agentes. ### Atualizando quando a nova versão do RMT requer uma atualização do PostgreSQL da versão principal Quando há uma mudança no requisito de versão principal do PostgreSQL para Resource Monitoring Tool, é uma prática recomendada atualizar a versão do PostgreSQL do repositório externo antes de atualizar o Resource Monitoring Tool. Mais detalhes são fornecidos abaixo. Para ver se você deve atualizar a versão do PostgreSQL do seu repositório externo, consulte a [tabela de compatibilidade do produto](#product-compat). Use as etapas a seguir para atualizar o RMT e a instância RDS quando uma atualização de versão principal do PostgreSQL for necessária 1. Faça um backup da sua instância do RDS. Você precisará disso caso precise reverter a atualização. Para obter mais informações, consulte o tópico [Backup e restauração de uma instância de banco de dados do Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_CommonTasks.BackupRestore.htm) no site da AWS. 2. Faça uma cópia do arquivo de configuração no diretório do Resource Monitoring Tool. O arquivo de configuração está localizado em: `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config.json` 3. Atualize a instância do RDS para a nova versão do PostgreSQL Para obter mais informações, consulte o tópico [Atualizando o mecanismo de banco de dados PostgreSQL para Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.PostgreSQL.html) no site da AWS. 4. Atualização do RMT Server. Se a atualização, incluindo a migração do banco de dados, for concluída com êxito, vá para a próxima etapa. Se a atualização falhar, consulte as instruções nesta seção sobre como recuperar e reverter a atualização. 5. Atualize todos os agentes nos nós do Tableau Server para a nova versão RMT. Para obter mais informações, consulte [Atualização do Resource Monitoring Tool](https://help.tableau.com/v0.0/server/pt-br/rmt-admin-upgrade.htm). #### Recuperando-se de uma atualização com falha 1. Desinstale o RMT Server atualizado. 2. Restaure a instância do AWS RDS para a versão anterior à atualização. Para obter mais informações, consulte o tópico [Backup e restauração de uma instância de banco de dados do Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_CommonTasks.BackupRestore.htm) no site da AWS. 3. Substitua o arquivo de configuração do qual você fez backup antes da atualização no local a seguir. Talvez seja necessário criar esta pasta, pois ela pode ter sido excluída durante a desinstalação: `C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config.json` 4. Instale o RMT Server que instala um repositório local. 5. Configure o RMT Server para usar um repositório externo: `rmtadmin master-setup --db-config=external --db-server= --db-database= --db-port=5432 --db-admin-username=postgres --db-admin-password=` ### Compatibilidade de versão RMT e PostgreSQL Esta tabela lista apenas a versão RMT 2022.3 e posterior, pois o repositório externo só está disponível a partir da versão 2022.3 e posterior.
Versão do RMTVersão do PostgreSQL enviada com RMTVersão do PostgreSQL com suporte para repositório externo
2022.3 - 2024.213.713.7
2025.0 - 2025.3.215,615.6
2025.3.3 - 2026.x15,1415,14
## Quem pode fazer isso Para instalar o Resource Monitoring Tool, você deve ter o seguinte: - Permissões de administrador na máquina que você está instalando o Resource Monitoring Tool. - Função de site Administrador no Tableau Server. - Resource Monitoring Tool Conta de administrador.