Tableau Resource Monitoring Tool 的外部存放庫

套用到： Tableau Advanced Management

Tableau Resource Monitoring Tool 使用 PostgreSQL 資料庫作為其存放庫來收集和儲存用於提供效能和使用情況資訊的 Tableau Server 監視資料。此資料庫獨立於 Tableau Server 資料庫。

在 2022.3 版本之前，此 PostgreSQL 存放庫會隨 RMT 伺服器自動安裝在與 RMT 伺服器相同的機器上，這是唯一可用的選項。從版本 2022.3 開始，可以重新設定 RMT 伺服器，以使用外部託管的 PostgreSQL 資料庫，而不是本機安裝的資料庫。RMT 伺服器設定為使用外部託管的 PostgreSQL 資料庫時，我們將其稱為外部存放庫。

託管外部存放庫的受支援平台是 AWS RDS 執行個體。在外部託管存放庫資料庫可讓您對 RMT 伺服器存放庫元件的可用性、備份和災難復原進行管理。

新增可設定外部存放庫的選項後，RMT 伺服器可以透過以下方式進行設定：

  • 繼續使用本機安裝的存放庫：這意味著隨 RMT 伺服器自動安裝在同一台機器上的 PostgreSQL 資料庫將用作 RMT 伺服器的存放庫，並且不會對此設定進行進一步的變更。

  • 將 RMT 伺服器設定為使用外部存放庫：這意味著 RMT 使用的 PostgreSQL 資料庫託管在 RMT 伺服器外部。這需要在安裝後對設定進行一些變更。目前僅支援 AWS RDS 執行個體作為 PostgreSQL 資料庫的託管平台。

為設定和管理外部存放庫，您應對 AWS RDS 平台和 PostgreSQL 資料庫有充分的瞭解。我們建議您使用 AWS 站台上的文件，以瞭解平台相關說明。

您還需要知道如何設定和管理 Resource Monitoring Tool 的外部存放庫。本主題將在以下各節中為您提供該資訊。

新安裝的 Resource Monitoring Tool

本節中詳述的說明適用於新安裝的 Resource Monitoring Tool。若已有 RMT 的現有部署，並且想要移動到外部存放庫設定，請參閱本主題的現有 Resource Monitoring Tool 安裝部分。

安裝 RMT 伺服器時，它會自動將存放庫資料庫安裝在與 RMT 伺服器相同的機器上。設定外部存放庫的流程為安裝後設定，您將在其中重新設定 RMT 伺服器，以使用外部託管的 PostgreSQL 資料庫。

使用以下步驟安裝 Resource Monitoring Tool 和重新設定 RMT 伺服器，以使用外部存放庫：

  1. 建立外部存放庫：按照以下建議建立 RDS 執行個體來託管外部存放庫。

    • 建議的最低 PostgreSQL 執行個體規格：

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

      • 具有 500 GB 磁碟空間的 SSD 儲存空間

    • 執行個體設定值：

      • 背景工作處理序上限：總邏輯處理器

      • 每個 Gather 節點的背景工作上限：下限(總邏輯處理器 / 2, 4)

      • 平行背景工作上限：總邏輯處理器

      • 平行維護背景工作上限：下限(總邏輯處理器 / 2, 4)

      • 共用緩衝區：總記憶體 / 4

      • 有效快取大小：總記憶體的 75%

      • 維護背景工作記憶體：總記憶體 / 16 Linux，Windows 中最大 2GB - 1MB

      • Wal 緩衝區：衍生自共用緩衝區，可能大約 16 MB

      • 背景工作記憶體：衍生自共用緩衝區和每個 Gather 節點的背景工作上限

    要瞭解如何在 AWS 上建立和連線到 PostgreSQL 資料庫執行個體，請參閱 AWS 文件站台上的此頁面。

  2. 安裝 RMT：按照使用命令列安裝 RMT 伺服器的說明安裝 RMT 伺服器，但跳過建立環境的步驟。在將 RMT 伺服器設定為使用外部存放庫之後，將執行此動作。請注意，最初將安裝本機 PostgreSQL 資料庫。

  3. 測試與外部存放庫的連線：使用 psql 測試與新資料庫的連線，psql 是隨 RMT 伺服器安裝的 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

  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-database=<aws_rds_database_name> --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 資料庫執行個體

    步驟 1：建立 RDS 執行個體來託管外部存放庫

    在建立新 RDS 執行個體時使用以下建議：

    • 建議的最低 PostgreSQL 執行個體規格：

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

      • 具有 500 GB 磁碟空間的 SSD 儲存空間

    • 執行個體設定值：

      • 背景工作處理序上限：總邏輯處理器

      • 每個 Gather 節點的背景工作上限：下限(總邏輯處理器 / 2, 4)

      • 平行背景工作上限：總邏輯處理器

      • 平行維護背景工作上限：下限(總邏輯處理器 / 2, 4)

      • 共用緩衝區：總記憶體 / 4

      • 有效快取大小：總記憶體的 75%

      • 維護背景工作記憶體：總記憶體 / 16 Linux，Windows 中最大 2GB - 1MB

      • Wal 緩衝區：衍生自共用緩衝區，可能大約 16 MB

      • 背景工作記憶體：衍生自共用緩衝區和每個 Gather 節點的背景工作上限

    要瞭解如何在 AWS 上建立和連線到 PostgreSQL 資料庫執行個體，請參閱 AWS 文件站台上的此頁面。

    步驟 2：測試以確保能夠連線到新資料庫

    使用 psql 測試與新資料庫的連線，這是 RMT 伺服器隨附的 PostgreSQL 管理工具。在下方用自己的值替換 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

    • 現在，僅需重新啟動資料庫服務即可備份：

      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-database=<aws_rds_database_name> --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：重新註冊代理程式

    成功執行服務變更後，重新啟動每個代理程式，然後按照以下步驟使用 Web 介面重新註冊。

    1. 從 RMT 伺服器下載新的啟動程序檔案。

    2. 巡覽到 http://localhost:9002/setup/register，以存取代理程式 Web 介面，匯入啟動程序。

    3. 按一下測試訊息佇列。若收到錯誤，請查看之前的輸入。

    4. 按一下連線到訊息佇列。

    5. 在「伺服器」區段下，按一下已預先選取「新環境伺服器」的下拉式功能表，然後從清單中選擇您嘗試註冊的伺服器，而不是接受預設值。捲動到底部，然後按一下「註冊代理程式」按鈕。

    有關註冊代理程式的更多詳細資訊，請參閱使用命令列安裝代理程式。

    步驟 9：驗證 RMT 伺服器是否正在執行，以及您是否可查看歷史資料

    登入 RMT 伺服器，並驗證舊時間段的資料是否存在以及是否正在處理新資料。還應查看任何自訂設定值，以確保一切都正確移轉。

升級最佳做法

若要升級 Tableau Resource Monitoring Tool (RMT)並同時移轉到外部存放庫，則需要遵循以下一般步驟：

重新建立環境移轉：

  1. 將 RMT 伺服器和所有代理程式升級到 2022.3 或更高版本。

  2. 步驟 2-4 與執行新安裝的步驟非常相似 - 請參閱上面的新安裝的 Resource Monitoring Tool。這主要涉及：

    • 建立 AWS PostgreSQL 資料庫執行個體。

    • 將 RMT 伺服器設定為使用外部存放庫。

    • 重新建立環境，並重新註冊所有代理程式。

  3. 重新設定任何自訂設定。

附註：您將丟失歷史資料，還需要重新設定任何自訂設定。

手動移轉，資料丟失最少：

  1. 升級 RMT 伺服器與所有代理程式至版本 2022.3 或更高版本。

  2. 遵循移轉部分中詳述的步驟。這主要涉及：

    • 建立 AWS PostgreSQL 資料庫執行個體。

    • 備份 PostgreSQL 資料庫。

    • 將 RMT 伺服器設定為使用外部存放庫（PostgreSQL 資料庫執行個體）。

    • 將備份還原到外部儲存庫。正在重新註冊該代理程式。

    • 重新註冊代理程式。

RMT 新版本需要 PostgreSQL 主要版本升級時升級

Resource Monitoring Tool 的 PostgreSQL 主要版本要求發生變更時，最佳做法是在升級 Resource Monitoring Tool 之前先升級外部存放庫 PostgreSQL 版本。更多詳細資訊如下。要瞭解是否應升級外部存放庫 PostgreSQL 版本，請參閱產品相容性表。

需要升級 PostgreSQL 主要版本時，使用以下步驟升級 RMT 和 RDS 執行個體

  1. 備份 RDS 執行個體。若需要復原升級，則需要此動作。有關更多資訊，請參閱 AWS 站台上的備份和還原 Amazon RDS 資料庫執行個體主題。

  2. 複製 Resource Monitoring Tool 目錄中的設定檔案。設定檔案位於：

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

  3. 將 RDS 執行個體升級到 PostgreSQL 新版本 有關更多資訊，請參閱 AWS 站台上的為 Amazon RDS 升級 PostgreSQL 資料庫引擎主題。

  4. 升級 RMT 伺服器。若包括資料庫移轉在內的升級成功完成，請繼續執行下一步。若升級失敗，請參閱本節中有關如何復原和復原升級的說明。

  5. 將 Tableau Server 節點上的所有代理程式升級到新的 RMT 版本。有關詳情，請參閱升級 Resource Monitoring Tool。

從失敗的升級中復原

  1. 解除安裝升級的 RMT 伺服器。

  2. 將 AWS RDS 執行個體還原到升級之前的版本。有關更多資訊，請參閱 AWS 站台上的備份和還原 Amazon RDS 資料庫執行個體主題。

  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-database=<aws_rds_database_name> --db-port=5432 --db-admin-username=postgres --db-admin-password=<postgres_user_password>

 

RMT 和 PostgreSQL 版本相容性

此表僅列出 RMT 版本 2022.3 及更高版本，因為外部存放庫僅適用於版本 2022.3 及更高版本。

RMT 版本RMT 附帶的 PostgreSQL 版本外部存放庫支援的 PostgreSQL 版本
2022.3 - 2024.213.713.7

誰可以執行此動作

如要安裝 Resource Monitoring Tool，您必須具備以下所有條件：

  • 在您安裝 Resource Monitoring Tool 的電腦上有管理員權限。
  • Tableau Server 管理員站台角色。
  • Resource Monitoring Tool 管理員帳戶。
返回頂端
感謝您的意見反應！已成功提交您的意見回饋。謝謝！