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.

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 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 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 .

  2. Instale o RMT: siga as instruções Instalar o RMT Server usando a linha de comando 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<version number>\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 <aws_rds_servername> -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=aws_rds_servername --db-port=5432 --db-admin-username=postgres --db-admin- password='postgres_user_password'

  5. Agora crie um ambiente e baixe o arquivo bootstrap:

    • Execute o seguinte comando para criar um ambiente:

      rmtadmin create-env --name=<myenvironment> --api-username=<TableauServer API user name> --api-password=<password for the Tableau Server API user account>

    • Faça download do arquivo de bootstrap para registrar os Agentes:

      rmtadmin bootstrap-file --env=<myenvironment> --filename<The absolute or relative path including the file name>

      As etapas são descritas em detalhes aqui: Instalar o RMT Server usando a linha de comando.

  6. Siga as instruções em Instalar o Agente usando a linha de comando 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, 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 .

    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<version number>\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 <aws_rds_servername> -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<version number>\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, 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=<aws_rds_servername> --db-port=5432 --db-admin-username=postgres --db-admin-password=<postgres_user_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 <aws_rds_servername> -p 5432 -U postgres -d tabrmt <your_file_name>.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.

    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 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 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 para a versão 2022.3 ou posterior
  2. Siga as etapas detalhadas na seção de migração. 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.

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 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 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.

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 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 o repositório externo: rmtadmin master-setup --db-config=external --db-server=<aws_rds_servername> --db-port=5432 --db-admin-username=postgres --db-admin-password=<postgres_user_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.313.713.7

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