--- schema_version: "1" id: e44e0382c491a8526753af21e3f072a523e51b1f71c25b3465b6fabbf6b6005b title: 變更記錄層級 collection: tableau version: next locale: zh-tw portal_url: https://docs.salesforce.com/tableau/next/zh-tw/server-linux/logs_debug_level.md canonical_url: https://help.tableau.com/v0.0/server-linux/zh-tw/logs_debug_level.htm source_site: help.tableau.com content_type: documentation content_hash: 2faf8d7bfe9164456928e633085eb464e2beaffb54147db76f2228545dc46c13 description: Change logging levels for Tableau Services Manager and Tableau Server. --- [跳至主要內容](#main-content) # 變更記錄層級預設情況下，Tableau 服務管理員 (TSM) 和 Tableau Server 會記錄**資訊**層級的事件。如果您需要收集更多資訊，可以變更此層級（例如，如果您與 Tableau 支援人員合作）。依照「支援部門」指示，最佳作法除非是為了排查問題，否則不應提高記錄層級。您只應在調查特定問題時將記錄層級設定為調試。變更記錄層級可能會產生以下影響： - 將記錄層級提高到 `debug` 或 `trace` 會增加要記錄的資訊量，可能會對效能產生顯著影響。重現問題，然後將記錄層級重設回資訊。 - 將記錄層級設定為 `warn` 或 `error` 可以大幅減少資訊量，以至於對 Tableau 支援部門沒有用處。 **注意：**在 `DEBUG` 等級登入時，Tableau 啟動會收集完整的環境資訊。這代表如果您在環境變數中有任何敏感資訊，它可能會包含在記錄中。在預設`INFO` 等級，記錄只收集安全環境資訊。 ## 記錄層級以下記錄層級是按照記錄的資訊量的遞增順序列出的： - off（關閉） - fatal（致命） - error（錯誤） - warn（警告） - info (the default)（資訊（預設值）） - debug（調試） - trace（跟蹤） ## 變更記錄層級使用 **tsm configuration set** 組態金鑰為 TSM 和 Tableau Server 程序設定記錄層級。您使用的金鑰取決於您要變更 TSM 或 Tableau Server 中哪個元件的記錄層級。 ### 動態記錄層級組態在版本 2020.2 中，我們引入了動態設定。在隨後的版本中擴展已擴展此功能。若僅變更其中一個或多個元件的記錄層次，且正在執行正確的 Tableau 版本，則無需重新啟動 Tableau Server。從以下版本開始，可以動態設定這些記錄層次： - 2020.2 - tsm 服務 (`tsm.log.level` ) 和控制應用程式服務 (`tsm.controllerapp.log.level` ）。 - 2020.3 - 背景資料 (`backgrounder.log.level` ), 叢集控制器 (`clustercontroller.log.level` ), 資料伺服器 (`dataserver.log.level` ), 檔案存放區 (`filestore.log.level` ), 資料來源屬性 (`tdsservice.log.level` ) 和 VizQL 服務器 (`vizqlserver.log.level` ）。 - 2020.4 - 新增了互動式微服務容器 (`tomcatcontainer.log.level`) 和應用程式伺服器 (`vizportal.log.level`)。 ## 用於變更記錄層次的設定鍵此表包括可動態設定鍵和不可動態設定鍵。

設定鍵

受影響的記錄的位置

（路徑以 /var/opt/tableau/tableau_server/data/tabsvc/logs/ 開頭）

tsm.log.level

變更 TSM 記錄層級：activationservice、appzookeeper、backuprestore、clientfileservice、databasemaintenance、licenseservice、siteimportexport、tabadminagent、tabadmincontroller、tabsvc

/<service>/<service>_node<n>-<instance>.log

範例： /clientfileservice/clientservice_node1-0.log

tsm.controlapp.log.level

變更以下項目的 TSM 記錄層級：控制應用程式

/<service>/control_<service>_node<n>-<instance>.log

範例： /clientfileservice/control_clientservice_node1-0.log

/filestore/control_filestore_node1-0.log

<process>.native_api.log.level

有效的處理序名稱包括 backgrounder、vizportal、vizqlserver、dataserver

附註：這些處理序不是動態可設定的。

/vizqlserver/*.txt

backgrounder.log.level

變更以下項目的記錄層級：背景程式

/backgrounder/*.log

clustercontroller.log.level

變更以下項目的記錄層級：叢集控制器

/clustercontroller/*.log

dataserver.log.level

變更以下項目的記錄層級：資料伺服器

/dataserver/*.log

filestore.log.level

變更以下項目的記錄層級：檔案存放區

/filestore/*.log

gateway.log.level

變更以下項目的記錄層級：閘道控制流程

/gateway/*.log

gateway.httpd.loglevel

附註：已在版本 2021.3.0 中新增

變更以下項目的記錄層級：閘道

/gateway/*.log

hyper.log.level

變更以下項目的記錄層級：Hyper

/hyper/*.log

tdsservice.log.level

變更以下項目的記錄層級：資料來源屬性服務

/tdsservice/*.log

tomcatcontainer.log.level

變更以下項目的微服務記錄層級：互動式微服務容器和非互動式微服務容器

/tomcatcontainer/*.log

vizportal.log.level

變更以下項目的記錄層級：應用程式伺服器

/vizportal/*.log

vizqlserver.log.level

變更以下項目的記錄層級：VizQL 伺服器

/vizqlserver/*.log

如需更多資訊，請參閱 [tsm configuration set 選項](https://help.tableau.com/v0.0/server-linux/zh-tw/cli_configuration-set_tsm.htm)。若您僅變更動態可設定的記錄層級，則無需停止或啟動伺服器（有關詳情，請參閱上述[動態記錄層級組態](#DynamicLogLevel)）。若要變更其他記錄層級，則可能需要在變更記錄層級之前停止 Tableau Server，然後再重新啟動。若是這種情況，系統會提示您。執行 Tableau Server 的多節點安裝時，請從初始節點設定記錄層級。變更記錄層級： 1. （可對 2020.2.0 及更高版本中的動態可設定記錄層級選用）開啟命令提示字元並鍵入以下命令以停止 Tableau Server： `tsm stop` 2. 透過鍵入 `tsm configuration set -k -v ` 來設定記錄層級其中 `` 是上表的其中一組金鑰，`` 是有效記錄層級。範例： - tsm configuration set -k backgrounder.native\_api.log.level -v debug - tsm configuration set -k tsm.log.level -v debug - tsm configuration set -k tsm.controlapp.log.level -v debug 3. 透過執行 `tsm pending-changes apply` 命令應用未完成的變更。 4. （僅在伺服器停止時可選用）透過執行以下命令來啟動 Tableau Server： `tsm start` ## 重設記錄層級重現問題並收集相關資訊後，請重設記錄層級，以避免持續的效能影響和額外的磁碟空間佔用。在 Tableau Server 2026.2 及更高版本中，可以使用命令檢視 `tsm maintenance log-levels` 所有服務記錄層級並將其重設為預設值。有關詳情，請參閱 [tsm maintenance](https://help.tableau.com/v0.0/server-linux/zh-tw/cli_maintenance_tsm.htm)。 - 若要在重設之前查看所有記錄層級設定，請執行： `tsm maintenance log-levels list` - 若要將所有記錄層級設定設定為其預設值，請執行： `tsm maintenance log-levels reset` 對於 Tableau Server 的早期版本，或若要重設特定金鑰，請執行 `tsm configuration set` 帶有選項的 `-d` 命令。範例： - tsm configuration set -k backgrounder.native\_api.log.level -d - tsm configuration set -k tsm.log.level -d 重設記錄層級後，必須套用待定變更。如果要重設 Tableau Server 處理序的記錄層級，請檢查待定變更清單。如果更新需要重新啟動，請停止伺服器，套用變更，然後重新啟動。