--- schema_version: "1" id: 70b09510a6d3366caaae0b588d10c493b53167d69ba9aebfa02324a2dedc6228 title: 主組態檔 collection: tableau version: current locale: zh-tw portal_url: https://docs.salesforce.com/tableau/current/zh-tw/server-linux/rmt-config-configFile.md canonical_url: https://help.tableau.com/current/server-linux/zh-tw/rmt-config-configFile.htm source_site: help.tableau.com content_type: documentation content_hash: 23f7544ac484da16fa27c4a6678001d6bec831133cf1833e2a97cddedab24aea description: Configure RMT Server options using the configuration file. --- [跳至主要內容](#main-content) # RMT 伺服器組態檔 本主題說明您可用此組態檔使用的組態選項。若要使用 Web 介面執行此作業，請參閱 [Resource Monitoring Tool 伺服器設定](https://help.tableau.com/current/server-linux/zh-tw/rmt-config-configGui.htm)。 為致力於符合本公司平等的價值觀，我們已盡可能變更非包容性術語。由於在某些地方變更術語可能會導致重大變更，我們會保留某些現有術語。因此，您可能會繼續在 CLI 命令和選項、安裝資料夾、設定檔案和其他執行個體中看到這些術語。有關詳情，請參閱[關於 Tableau 說明](https://help.tableau.com/current/tableau/zh-tw/about-tableau-help.htm)。 此組態檔位於 `/var/opt/tableau/tabrmt/master/config.json`。 **附註**：組態值儲存在組態檔中。可以直接對此檔案進行變更，但是建議利用 UI 中的組態選項和透過`rmtadmin`命令列公用程式進行變更。 需要重新啟動才能套用變更的組態檔。 變更組態檔之後，將需要重新啟動 RMT 伺服器。 ## 資料保留 預設情況下，Resource Monitoring Tool 會儲存兩週的詳細資料，以及 10 年的彙總報告資料。 這一時長可進行設定。這裡是定義資料保留設定的範例程式碼片段： ``` { "db": { "cleanup": { "afterDays": 14, "aggregate": { "afterDays": 3650 } } } } ``` ### SMTP 設定 定義 SMTP 資訊的範例 `config.json` 程式碼片段： ``` { "smtp": { "server": "localhost", "port": 25, "username": "my-username", "password": "my-password", "requireSSL": true } } ``` `smtp` 設定區段中可用的設定值完整清單： | 機碼 | 資料類型 | 是否為必要項目？ | 描述 | | --- | --- | --- | --- | | `server` | 字串 | 選用 | 要使用的 SMTP 伺服器。預設值：`localhost` | | `port` | 數字 | 選用 | SMTP 伺服器的埠號。預設值：`25` | | `username` | 字串 | 選用 | 伺服器需要驗證時使用的使用者名稱。 | | `password` | 字串 | 選用 | 伺服器需要驗證時使用的密碼。 | | `requireSSL` | 布林值 | 選用 | 如果 SMTP 伺服器需要 SSL，則為 `true`，否則為 `false`。預設值：`false` | ## 通知設定 定義通知資訊的範例 `config.json` 程式碼片段： ``` { "notifications": { "email": { "from": "sender@domain.com", "to": "recipient1@domain.com,recipient2@domain.com" } } } ``` `environments` 區段中可以按每個環境覆蓋全域通知資訊（如上所示）： ``` { "environments": { "Environment1": { "notifications": { "email": { "from": "sender@domain.com", "to": "recipient1@domain.com,recipient2@domain.com" } } } } } ``` `notifications.email` 設定區段中可用的設定值完整清單： | 機碼 | 資料類型 | 是否為必要項目？ | 描述 | | --- | --- | --- | --- | | `from` | 字串 | 必要 | 寄件者的電子郵件地址。 | | `to` | 字串 | 必要 | 收件者電子郵件地址。多個地址必須以逗號或分號分隔。 | | `minimumIncidentSeverity` | 字串 | 選用 | 傳送電子郵件的最小事件嚴重性。預設值：`critical`另請參閱 [Tableau Resource Monitoring Tool - 事件](https://help.tableau.com/current/server-linux/zh-tw/rmt-incidents-index-incidents.htm)。 | ## 長條圖設定 用來在 Web 介面中產生長條圖的界限可以使用代表每個邊界的值的陣列設定。 `monitoring.histograms` 區段中可設定長條圖的完整清單： | 機碼 | 資料類型 | 是否為必要項目？ | 描述 | | --- | --- | --- | --- | | `viewLoadDuration` | 數字陣列 | 選用 | 檢視載入的長條圖邊界。值以毫秒為單位。預設值：`[1000, 3000, 6000, 10000]` | | `externalDataRequestDuration` | 數字陣列 | 選用 | 外部資料請求的長條圖邊界。值以毫秒為單位。預設值：`[1000, 3000, 6000, 10000]` | | `backgroundTaskDuration` | 數字陣列 | 選用 | 背景工作的長條圖邊界。值以毫秒為單位。預設值：`[60000, 300000, 600000, 1800000]` | 舉例來說，若要在全域層級使用下列長條圖的存儲桶， - ≤1 秒 - \> 1 秒且 ≤ 10 秒 - \> 10 秒且 ≤ 30 秒 - \> 30 秒 設定如下所示： ``` { "monitoring": { "histograms": { "viewLoadDuration": [1000, 10000, 30000], "externalDataRequestDuration": [1000, 10000, 30000], "backgroundTaskDuration": [1000, 10000, 30000] } } } ``` 長條圖邊界也可以按環境設定。例如，識別碼為「staging-environment」的環境使用下列檢視長條圖存儲桶： - ≤ 2.5 秒 - \> 2.5 秒且 ≤ 5 秒 - \> 5 秒且 ≤ 30 秒 - \> 30 秒且 ≤ 1 分鐘 - \> 1 分鐘且 ≤ 10 分鐘 - \> 10 分鐘 設定如下所示： ``` { "environments": { "staging-environment": { "monitoring": { "histograms": { "viewLoadDuration": [2500, 5000, 30000, 60000, 600000] } } } } } ``` 「staging-environment」將回到背景工作的全域長條圖設定。 ## 最低 TLS 版本 預設情況下，RMT 將使用安全版本的 TLS 來加密流量。預設最低版本為 1.2，但如果有特定的安全性要求，要求停用舊版本的 TLS，則可以修改 `server.minimumTlsVersion` 設定檔的區段以強制執行最低 TLS 版本，如下面的範例程式碼片段所示，其中最低版本設定為 1.3。有效值清單 `minimumTlsVersion` 定義於 [.Net Core 中的 SslProtocols](https://learn.microsoft.com/zh-tw/dotnet/api/system.security.authentication.sslprotocols?view=net-8.0 "SslProtocols 列舉")。 ``` "server": { "url": "https://rmtserver:443", "https": { "enforce": true, "certificate": { "mode": Default, "local": { "name": null, "password": null }, "store": { "certificateThumbprint": ""} }, "minimumTlsVersion": "Tls13" }, ``` ### 事件設定 有關可用事件選項以及如何設定這些選項的詳情，請參閱[事件](https://help.tableau.com/current/server-linux/zh-tw/rmt-incidents-index-incidents.htm)。 ### RMT 伺服器記錄檔 參閱 [Tableau Resource Monitoring Tool 記錄檔](https://help.tableau.com/current/server-linux/zh-tw/rmt-admin-logs.htm)。 ## 代理程式 代理程式服務的組態檔位於 `/var/opt/tableau/tabrmt/master/config.json` 變更組態檔之後，您將需要重新啟動代理程式服務。 ### Tableau Server 偵測 在幾乎所有的情況下，代理程式都會自動偵測 Tableau Server 安裝，而不需要在標準 [代理程式設定處理序](https://help.tableau.com/current/server-linux/zh-tw/rmt-admin-installation.htm#agent-setup)之外執行任何設定。如果需要，您可以透過 `config.json` 檔案手動設定 Tableau Server 資訊。 定義執行代理程式所需之 Tableau Server 資訊的範例 `config.json` 程式碼片段： ``` { "agent": { "tableauServer": { "override": true, "productVersion": 2021.4, "applicationDirectory": "/var/opt/tableau/tableau_server/2021.4" } } } ``` `agent.tableauServer` 設定區段中可用的設定值完整清單： | 機碼 | 資料類型 | 是否為必要項目？ | 描述 | | --- | --- | --- | --- | | `applicationDirectory` | 字串 | 必要 | Tableau Server 應用程式根目錄。 | | `dataDirectory` | 字串 | 選用 | 取得 Tableau Server 資料檔案的目錄。 | | `override` | 布林值 | 選用 | 若設定值優先於任何自動偵測值，則為 `true`。若設定值作為任何自動偵測值的後備，則為 `false`。 | | `productVersion` | 數字 | 必要 | Tableau Server 的版本號。 | ### 代理程式記錄 參閱 [Tableau Resource Monitoring Tool 記錄檔](https://help.tableau.com/current/server-linux/zh-tw/rmt-admin-logs.htm)。 ## 通用 RMT 伺服器和代理程式中都可以使用通用設定值。如需尋找組態檔的指引，請參閱特定應用程式的章節。 變更組態檔之後，您將需要重新啟動應用程式服務。 ## 加密訊息 若要啟用加密訊息，必須先將 RabbitMQ 伺服器設定為允許 TLS。如需詳細資訊，請參閱[加密資料收集](https://help.tableau.com/current/server-linux/zh-tw/rmt-admin-encrypted-data-collection.htm)管理員導引。 將 RMT 伺服器和代理程式設定為啟用加密傳訊時： - 必須設定 `enabled` 旗標和 `certificateHostName` 才能啟用加密。 - `certificateHostName` 變數必須符合伺服器憑證上的正式名稱 (CN=)，否則連線將會失敗。 - `mq` 區段中的 `port` 設定可能需要根據您設定的 RabbitMQ TLS 連接埠來變更。 ``` { "mq": { "port": 5671, "tls": { "enabled": true, "certificateHostName": "foo" } } } ``` `mq.tls` 設定區段中可用的設定值完整清單： | 機碼 | 資料類型 | 是否為必要項目？ | 描述 | | --- | --- | --- | --- | | `enabled` | 布林值 | 選用 | `true` 啟用 TLS 加密進行訊息連線。`false` 使用未加密連線進行訊息傳送。預設值：`false` | | `certificateHostName` | 字串 | 選用 | `certificateHostName` 必須符合伺服器憑證的正式名稱 (CN=)，否則連線將會失敗。預設值：`""` | ## 誰可以執行此動作 Resource Monitoring Tool 管理員或具備**伺服器/環境管理**角色的 Resource Monitoring Tool 使用者。