Tableau Resource Monitoring Tool용 외부 리포지토리

Tableau Resource Monitoring Tool는 PostgreSQL 데이터베이스를 리포지토리로 사용하여, 성능 및 사용 정보를 제공하는 데 사용되는 Tableau Server 모니터링 데이터를 수집하고 저장합니다.

2022.3 릴리스 이전에는 이 PostgreSQL 리포지토리가 RMT 서버와 동일한 컴퓨터에 RMT 서버와 함께 자동으로 설치되었으며, 이것이 유일한 옵션이었습니다. 버전 2022.3부터는 로컬로 설치된 데이터베이스 대신 외부에서 호스팅되는 PostgreSQL 데이터베이스를 사용하도록 RMT 서버를 다시 구성할 수 있습니다. 외부에서 호스팅되는 PostgreSQL 데이터베이스를 사용하도록 RMT 서버를 구성한 경우 이를 외부 리포지토리라고 합니다.

외부 리포지토리를 호스팅하는 데 지원되는 플랫폼은 AWS RDS 인스턴스입니다. 리포지토리 데이터베이스를 외부에서 호스팅하면 RMT 서버의 리포지토리 구성 요소에 대해 가용성을 보장하고 백업 및 재해 복구를 관리할 수 있습니다.

이 옵션과 함께 외부 리포지토리를 구성하면 다음과 같은 방법으로 RMT 서버를 구성할 수 있습니다.

  • 로컬에 설치된 리포지토리를 계속 사용: 동일한 컴퓨터에 RMT 서버와 함께 자동으로 설치된 PostgreSQL 데이터베이스가 RMT 서버의 리포지토리로 사용되며 이 구성은 더는 변경되지 않습니다.
  • 외부 리포지토리를 사용하도록 RMT 서버를 구성: 즉, RMT에서 사용하는 PostgreSQL 데이터베이스가 RMT 서버 외부에서 호스팅됩니다. 이렇게 하려면 설치 후 일부 구성을 변경해야 합니다. 현재 PostgreSQL 데이터베이스의 호스팅 플랫폼은 AWS RDS 인스턴스만 지원됩니다.

외부 리포지토리를 설정하고 관리하려면 AWS RDS 플랫폼 및 PostgreSQL 데이터베이스에 대해 잘 알고 있어야 합니다. 플랫폼 관련 지침은 AWS 사이트의 설명서를 사용하는 것이 좋습니다.

또한 Resource Monitoring Tool에 대한 외부 리포지토리 구성을 설정하고 관리하는 방법도 알고 있어야 합니다. 해당 정보는 이 항목의 아래 섹션에서 제공됩니다.

Resource Monitoring Tool의 새 설치

이 섹션에 설명된 지침은 Resource Monitoring Tool를 새로 설치하는 경우에 적용됩니다. RMT를 이미 배포한 상태에서 외부 리포지토리 구성으로 전환하려면 이 항목의 기존 Resource Monitoring Tool 설치 섹션을 참조하십시오.

RMT 서버를 설치하면 RMT 서버와 동일한 컴퓨터에 리포지토리 데이터베이스가 자동으로 설치됩니다. 외부 리포지토리를 구성하는 프로세스는 외부에서 호스팅되는 PostgreSQL 데이터베이스를 사용하도록 RMT 서버를 다시 구성하는 설치 후 구성입니다.

Resource Monitoring Tool를 설치하고 외부 리포지토리를 사용하도록 RMT 서버를 다시 구성하려면 다음 단계를 따르십시오.

  1. 외부 리포지토리 생성: RDS 인스턴스를 생성해 다음 권장 사항에 따라 외부 리포지토리를 호스팅합니다.

    • 최소 권장 PostgreSQL 인스턴스 사양:

      • db.m6g.2xlarge(8 vcpu, 32GiB RAM)

      • 500GB 디스크 공간이 있는 SSD 스토리지

    • 인스턴스 구성 값:
      • Max Worker Processes(최대 작업자 프로세스 수): 총 논리적 프로세서 수

      • Max Workers Per Gather(수집당 최대 작업자 수): Min(총 논리 프로세서 수 / 2, 4)

      • Max Parallel Workers(최대 병렬 작업자 수): 총 논리적 프로세서 수

      • Max Parallel Maintenance Workers(최대 병렬 유지 관리 작업자 수): Min(총 논리 프로세서 수 / 2, 4)

      • Shared Buffers(공유 버퍼): 총 메모리 / 4

      • Effective Cache Size(유효 캐시 크기): 총 메모리의 75%

      • Maintenance Work Memory(유지 관리 작업 메모리): 총 메모리 / 16(Linux), 최대 2GB ~ 1MB(Windows)

      • Wal Buffers(WAL 버퍼): 공유 버퍼에서 도출되며 약 16MB

      • Work Memory(작업 메모리): 공유 버퍼 및 수집당 최대 작업자 수에서 도출

    AWS에서 PostgreSQL DB 인스턴스를 생성하고 연결하는 방법을 알아보려면 AWS 설명서 사이트의 이 페이지를 참조하십시오.

  2. RMT 설치: 명령줄을 사용하여 RMT 서버 설치 지침에 따라 RMT 서버를 설치하되 환경을 생성하는 단계는 건너뜁니다. 환경 생성 작업은 외부 리포지토리를 사용하도록 RMT 서버를 구성한 후 나중에 수행합니다. 이 작업을 수행하면 로컬 PostgreSQL 데이터베이스가 처음에 설치됩니다.

  3. 외부 리포지토리와의 연결 테스트: RMT 서버와 함께 설치되는 PostgreSQL 관리 도구인 psql을 사용하여 새 데이터베이스에 대한 연결을 테스트합니다.

    로컬로 설치된 PostgreSQL 설치 디렉터리의 'bin' 폴더로 이동합니다.

    C:\Program Files\Tableau\Tableau Resource Monitoring Tool\prerequisites\postgresql<version number>\bin

    다음 명령을 실행하여 연결을 테스트합니다. 아래에서 aws_rds_servername을 사용자 본인의 값으로 대체하고 메시지가 표시되면 AWS에서 생성한 PostgreSQL 비밀번호를 입력합니다.

    .\psql.exe -h <aws_rds_servername> -p 5432 -d postgres -U postgres

    이 시점에서 오류가 발생하여 성공적으로 연결할 수 없는 경우, 명령의 매개 변수 값을 AWS RDS 콘솔의 값과 비교하여 검토하십시오.

    연결이 성공적으로 설정되면 다음 명령을 사용하여 psql 세션을 닫을 수 있습니다.

    \q

  4. rmtadmin master-setup을 실행하여.외부 리포지토리를 사용하도록 RMT 서버를 구성합니다. 다음 명령 예를 사용하여 Resource Monitoring Tool 설치 경로, AWS RDS 인스턴스 이름, 포트 번호 및 RDS PostgreSQL 관리자 비밀번호를 반영하도록 명령을 편집합니다.

    Resource Monitoring Tool RMT 서버 설치 디렉터리로 이동합니다. cd 'c:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\'

    다음 명령을 실행하여 외부 리포지토리를 구성합니다. ./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. 이제 환경을 생성하고 부트스트랩 파일을 다운로드합니다.

    • 다음 명령을 실행하여 환경을 생성합니다.

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

    • 부트스트랩 파일을 다운로드하여 에이전트를 등록합니다.

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

      이 단계는 명령줄을 사용하여 RMT 서버 설치에 자세히 설명되어 있습니다.

  6. 명령줄을 사용하여 에이전트 설치 지침에 따라 Tableau Server 노드에 에이전트를 설치하고 등록합니다.

기존 Resource Monitoring Tool 설치

현재 로컬 리포지토리를 사용 중인 기존 RMT 설치를 외부 리포지토리로 마이그레이션하는 방법은 두 가지가 있습니다. 선택하는 방법은 환경의 크기와 복잡성에 따라 다릅니다.

  1. 환경을 다시 생성하는 마이그레이션: 이 방법은 환경을 다시 생성하고 다시 시작해야 하며 지금까지 수집된 데이터가 손실되기 때문에 구성 및 알림이 많지 않은 소규모 환경의 RMT 설치에 적합합니다.

    여기에는 외부 리포지토리를 사용하도록 RMT 서버를 다시 구성하고, 환경을 다시 생성하고, 인시던트 임계값과 같은 모든 사용자 지정 구성을 다시 수행하고, 에이전트를 다시 등록하는 작업이 포함됩니다. 이 경우 RMT를 설치하지 않는다는 점만 제외하고 위 섹션에서 설명한 RMT를 새로 설치하는 것과 매우 유사합니다.

  2. 데이터 손실을 최소화하면서 수동 마이그레이션: 이 방법은 특히 환경의 규모가 크고 복잡하며 처음부터 새로 시작하기를 원하지 않는 고객을 위한 것입니다. 이 마이그레이션은 수동으로 진행되며 RMT에 기본 제공되는 마이그레이션 기능이 아닙니다. 이 작업을 수행하는 지침은 아래에 설명되어 있습니다.

    로컬 Resource Monitoring Tool 리포지토리를 외부 AWS PostgreSQL DB 인스턴스로 수동 마이그레이션

    1단계: 외부 리포지토리를 호스팅하는 RDS 인스턴스 만들기

    새 RDS 인스턴스를 만들 때 다음 권장 사항을 따르십시오.

    • 최소 권장 PostgreSQL 인스턴스 사양:

      • db.m6g.2xlarge(8 vcpu, 32GiB RAM)

      • 500GB 디스크 공간이 있는 SSD 스토리지

    • 인스턴스 구성 값:
      • Max Worker Processes(최대 작업자 프로세스 수): 총 논리적 프로세서 수

      • Max Workers Per Gather(수집당 최대 작업자 수): Min(총 논리 프로세서 수 / 2, 4)

      • Max Parallel Workers(최대 병렬 작업자 수): 총 논리적 프로세서 수

      • Max Parallel Maintenance Workers(최대 병렬 유지 관리 작업자 수): Min(총 논리 프로세서 수 / 2, 4)

      • Shared Buffers(공유 버퍼): 총 메모리 / 4

      • Effective Cache Size(유효 캐시 크기): 총 메모리의 75%

      • Maintenance Work Memory(유지 관리 작업 메모리): 총 메모리 / 16(Linux), 최대 2GB ~ 1MB(Windows)

      • Wal Buffers(WAL 버퍼): 공유 버퍼에서 도출되며 약 16MB

      • Work Memory(작업 메모리): 공유 버퍼 및 수집당 최대 작업자 수에서 도출

    AWS에서 PostgreSQL DB 인스턴스를 생성하고 연결하는 방법을 알아보려면 AWS 설명서 사이트의 이 페이지를 참조하십시오.

    2단계: 새 데이터베이스에 연결할 수 있는지 테스트

    • RMT 서버와 함께 제공되는 PostgreSQL 관리 도구인 psql을 사용하여 새 데이터베이스에 대한 연결을 테스트합니다. 아래에서 aws_rds_servername을 사용자 본인의 값으로 대체하고 메시지가 표시되면 AWS에서 생성한 PostgreSQL 비밀번호를 입력합니다.
    • 로컬로 설치된 PostgreSQL 설치 디렉터리의 'bin' 폴더로 이동합니다.

    C:\Program Files\Tableau\Tableau Resource Monitoring Tool\prerequisites\postgresql<version number>\bin

    다음 명령을 실행하여 연결을 테스트합니다. 아래에서 aws_rds_servername을 사용자 본인의 값으로 대체하고 메시지가 표시되면 AWS에서 생성한 PostgreSQL 비밀번호를 입력합니다.

    .\psql.exe -h <aws_rds_servername> -p 5432 -d postgres -U postgres

    이 시점에서 오류가 발생하여 성공적으로 연결할 수 없는 경우, 명령의 매개 변수 값을 AWS RDS 콘솔의 값과 비교하여 검토하십시오.

    연결이 성공적으로 설정되면 다음 명령을 사용하여 psql 세션을 닫을 수 있습니다.

    \q

    3단계: 현재 RMT에서 사용하는 로컬 PostgreSQL 데이터베이스에 대한 관리자 비밀번호 가져오기

    다음 명령을 실행하여 로컬 리포지토리에서 관리자 암호를 가져옵니다. 이 작업은 마이그레이션을 수행하기 전에 로컬 리포지토리에서 데이터를 백업하는 데 필요합니다.

    RMT 서버 설치 폴더로 이동합니다. cd 'c:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\'

    관리자 비밀번호를 가져옵니다. rmtadmin get db.adminPassword


    4단계: 기존 PostgreSQL 데이터베이스의 백업 수행

    • 먼저, 데이터베이스 백업 준비를 위해 RMT를 중지합니다.

      rmtadmin stop

    • 이제 DB 서비스를 다시 시작하여 백업을 생성할 수 있습니다. rmtadmin start -db
    • 다음 예제 스크립트를 사용하고 파일 경로를 사용자 본인의 값으로 대체합니다. 포트를 사용자 지정한 경우 포트도 업데이트합니다. 메시지가 표시되면 이전 단계의 비밀번호를 입력합니다.
      • 로컬 리포지토리의 bin 폴더로 이동합니다. cd 'C:\Program Files\Tableau\Tableau Resource Monitoring Tool\prerequisites\postgresql<version number>\bin'
    • 백업을 수행합니다. pg_dump -f your_file_name.dump -F d -j 10 -Z 5 -d tabrmt -h localhost -p 5555 -U postgres

      • -F d: pg_restore에 입력하기에 적합한 디렉터리 형식 아카이브를 출력합니다.
      • -j 10: 10개의 테이블을 동시에 백업하여 백업을 동시에 실행합니다.
      • -Z 5: 사용할 압축 수준을 지정합니다.

    참고: 이 단계 사이에 Resource Monitoring Tool에서 수집한 데이터와 마지막 데이터는 마이그레이션이 완료된 후에는 유지되지 않습니다.

    5단계: 외부 리포지토리를 가리키도록 RMT 서버 구성

    • 모든 RMT 서비스를 다시 시작합니다. rmtadmin restart --all
    • 다음 명령을 예로 참조하십시오. RDS 서버 이름, 포트 및 RDS postgres 사용자 비밀번호를 반영하도록 명령을 편집합니다.

      RMT 서버 설치 폴더로 이동합니다. cd 'c:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\'

      외부 리포지토리를 구성합니다. rmtadmin master-setup --db-config=external --db-server=<aws_rds_servername> --db-port=5432 --db-admin-username=postgres --db-admin-password=<postgres_user_password>

    6단계: 외부 리포지토리로 백업 복원

    • 먼저 RMT 서버를 중지합니다.

      rmtadmin stop

    • 4단계에서 생성한 백업을 새 AWS RDS PostgreSQL 인스턴스로 복원합니다. AWS RDS 서버 이름과 포트를 반영하도록 아래에 제공된 예제 스크립트를 편집하고 덤프 파일 경로와 이름이 정확한지 확인합니다. 메시지가 표시되면 RDS의 "postgres" 사용자에 대한 비밀번호를 입력합니다.

      pg_restore -j 5 -c -h <aws_rds_servername> -p 5432 -U postgres -d tabrmt <your_file_name>.dump

      • -j 5: 5개의 테이블을 동시에 복원하여 복원을 병렬로 실행합니다.
      • -c: 데이터베이스 개체를 다시 만들기 전에 정리(삭제)합니다.

    7단계: RMT 서버 시작

    rmtadmin start

    8단계: 에이전트 다시 등록

    서비스 변경이 성공적으로 수행되면 각 에이전트를 다시 시작한 후 다음 단계에 따라 웹 인터페이스를 사용하여 다시 등록합니다.

    1. RMT 서버에서 새 부트스트랩 파일을 다운로드합니다.
    2. http://localhost:9002/setup/register로 이동하여 에이전트 웹 인터페이스에 액세스하고 부트스트랩을 가져옵니다.
    3. Test Message Queue(메시지 큐 테스트)를 클릭합니다. 오류가 발생하면 이전 입력을 검토합니다.
    4. Connect to Message Queue(메시지 큐에 연결)을 클릭합니다.
    5. Server(서버) 섹션에서 "New Environment Server(새 환경 서버)"가 미리 선택되어 있는 드롭다운을 클릭하고, 기본값을 적용하지 않고 목록에서 등록하려는 서버를 선택합니다. 맨 아래로 스크롤하여 "Register Agent(에이전트 등록)" 단추를 클릭합니다.

    에이전트 등록에 대한 자세한 내용은 명령줄을 사용하여 에이전트 설치를 참조하십시오.

    9단계: RMT 서버가 실행 중이고 기간별 데이터가 표시되는지 확인

    RMT 서버에 로그인하여 이전 기간의 데이터가 있고 새 데이터가 처리 중인지 확인합니다. 또한 모든 사용자 지정 구성 값을 검토하여 모든 항목이 올바르게 마이그레이션되었는지 확인합니다.

업그레이드 모범 사례

다음은 Tableau Resource Monitoring Tool을 업그레이드하고 동시에 외부 리포지토리로 마이그레이션하려는 경우 따라야 하는 일반적인 단계입니다.

환경을 다시 생성하는 마이그레이션:

  1. RMT 서버 및 모든 에이전트를 2022.3 이상으로 업그레이드합니다.
  2. 2~4단계는 새 설치를 수행하는 단계와 매우 유사합니다. 위에서 Resource Monitoring Tool의 새 설치를 참조하십시오. 여기에는 주로 다음 작업이 포함됩니다.
    • AWS PostgreSQL DB 인스턴스를 생성합니다.
    • 외부 리포지토리를 사용하도록 RMT 서버를 구성합니다.
    • 환경을 다시 생성하고 모든 에이전트를 다시 등록합니다.
  3. 모든 사용자 지정 구성을 재구성합니다.

참고: 기간별 데이터가 손실되며 사용자 지정 구성도 다시 구성해야 합니다.

데이터 손실을 최소화하면서 수동 마이그레이션:

  1. RMT 서버 및 모든 에이전트를 버전 2022.3 이상으로 업그레이드합니다.
  2. 마이그레이션 섹션에 설명된 단계를 따릅니다. 여기에는 주로 다음 작업이 포함됩니다.
    • AWS PostgreSQL DB 인스턴스 만들기
    • PostgreSQL 데이터베이스의 백업 수행
    • 외부 리포지토리(PostgreSQL DB 인스턴스)를 사용하도록 RMT 서버 구성
    • 외부 리포지토리로 백업 복원
    • 에이전트 다시 등록

새 버전의 RMT에 주 버전 PostgreSQL 업그레이드가 필요한 경우의 업그레이드

Resource Monitoring Tool에 대한 PostgreSQL 주 버전 요구 사항이 변경된 경우 Resource Monitoring Tool를 업그레이드하기 전에 먼저 외부 리포지토리 PostgreSQL 버전을 업그레이드하는 것이 좋습니다. 자세한 내용은 아래에 나와 있습니다. 외부 리포지토리 PostgreSQL 버전을 업그레이드해야 하는지 확인하려면 제품 호환성 표를 참조하십시오.

PostgreSQL 주 버전 업그레이드가 필요한 경우 다음 단계를 사용하여 RMT 및 RDS 인스턴스를 업그레이드하십시오.

  1. RDS 인스턴스의 백업을 만듭니다. 업그레이드를 롤백해야 하는 경우 이 백업이 필요합니다. 자세한 내용은 AWS 사이트에서 Amazon RDS DB 인스턴스 백업 및 복원을 참조하십시오.
  2. Resource Monitoring Tool 디렉터리에 구성 파일의 복사본을 만듭니다. 구성 파일의 위치는 다음과 같습니다.
    C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config.json
  3. RDS 인스턴스를 PostgreSQL의 새 버전으로 업그레이드합니다. 자세한 내용은 AWS 사이트에서 Amazon RDS용 PostgreSQL DB 엔진 업그레이드 항목을 참조하십시오.
  4. RMT 서버를 업그레이드합니다. 데이터베이스 마이그레이션을 포함한 업그레이드가 성공적으로 완료되면 다음 단계를 진행합니다. 업그레이드에 실패하면 이 섹션의 업그레이드 복구 및 롤백 방법에 대한 지침을 참조하십시오.
  5. Tableau Server 노드의 모든 에이전트를 새 RMT 버전으로 업그레이드합니다. 자세한 내용은 Resource Monitoring Tool 업그레이드를 참조하십시오.

실패한 업그레이드 복구

  1. 업그레이드된 RMT 서버를 제거합니다.
  2. AWS RDS 인스턴스를 업그레이드 이전 버전으로 복원합니다. 자세한 내용은 AWS 사이트에서 Amazon RDS DB 인스턴스 백업 및 복원 항목을 참조하십시오.
  3. 업그레이드 전에 백업한 구성 파일을 다음 위치에서 바꿉니다. 이 폴더는 설치 제거 중에 삭제되었을 수 있으므로 생성해야 할 수 있습니다.


    C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config.json

  4. 로컬 리포지토리를 설치하는 RMT 서버를 설치합니다.
  5. 외부 리포지토리를 사용하도록 RMT 서버를 구성합니다. rmtadmin master-setup --db-config=external --db-server=<aws_rds_servername> --db-port=5432 --db-admin-username=postgres --db-admin-password=<postgres_user_password>

 

RMT 및 PostgreSQL 버전 호환성

외부 리포지토리는 버전 2022.3 이상에서만 사용할 수 있으므로 이 표에는 RMT 버전 2022.3 이상만 나열되어 있습니다.

RMT 버전RMT와 함께 제공되는 PostgreSQL 버전외부 리포지토리용으로 지원되는 PostgreSQL 버전
2022.313.713.7

이 작업을 수행할 수 있는 사용자

Resource Monitoring Tool를 설치하려면 다음이 모두 필요합니다.

  • Resource Monitoring Tool를 설치하는 컴퓨터에 대한 관리자 사용 권한
  • Tableau Server 관리자 사이트 역할
  • Resource Monitoring Tool 관리자 계정
피드백을 제공해 주셔서 감사합니다!귀하의 피드백이 제출되었습니다. 감사합니다!