使用記錄檔

正常情況下,Tableau Server 會在其活動過程中建立記錄檔案。在您排查 Tableau Server 問題時或者 Tableau 支援人員需要使用記錄來說明您解決問題時,您可能需要使用伺服器記錄檔案。

您可以使用 tsm maintenance ziplogs 命令建立壓縮記錄檔存檔案。壓縮的存檔包含您可以解壓縮和檢視或者傳送給 Tableau 支援人員的記錄副本。在您擁有存檔副本之後,可以從伺服器刪除存檔案。有關記錄檔存檔案的詳細資料,請參閱記錄檔快照(將記錄封存)

這組主題提供了有關如何建立記錄檔存檔案的資訊、特定記錄檔案的內容以及有關您何時可能需要檢視檔和如何檢視的詳細資料。

Tableau Server 記錄檔的內容

每個 Tableau Server 流程都會將其正在執行動作的相關資訊寫入其自己的記錄檔。這些記錄檔會各自提供每個流程動作的相關詳細資訊。總體而言,這些記錄檔會包含 Tableau Server 元件在處理使用者的請求或執行自動工作時互相之間進行內部通訊的相關詳細資訊。Tableau Server 記錄檔僅會包含可用於疑難排解的技術資訊,例如,不同元件的狀態,不同流程執行的動作,通訊嘗試,對資料庫的查詢(不包括結果)以及請求時間。

記錄檔可能會包含某些特定資料,例如,資料庫伺服器的名稱及其 IP 位址和連接埠,Tableau Server 電腦的名稱或 IP 位址,以及使用者存取的工作簿和檢視的 URL 和名稱。

記錄檔不會包含任何敏感的客戶資料,例如,密碼、查詢結果或檢視中顯示的資料。

注意:DEBUG 等級登入時,Tableau 啟動會收集完整的環境資訊。這代表如果您在環境變數中有任何敏感資訊,它可能會包含在記錄中。在預設INFO 等級,記錄只收集安全環境資訊。

tsm maintenance ziplogs 不僅可讓使用者產生記錄檔的壓縮封存,而且若已指定 -d 選項,還可讓使用者包括 Tableau Server 存放庫資料。存放庫會包含來自 Tableau Server 的中繼資料(例如,使用者名稱、群組、專案、Tableau Server 上的權限、擷取重新整理排程)。存放庫還會包含工作簿的配置和連線資訊,但不會包含以下任何資料,例如,密碼、資料庫中的實際資料或檢視中顯示的資料。

檢視中顯示的資料來自擷取檔案或資料庫,並可在記憶體中快取。其不會儲存在記錄檔中,或者若是即時連線,其也不會儲存在 Tableau Server 電腦上的單獨檔案中。擷取檔案會以 .hyper 檔案的形式儲存在 Tableau Server 電腦上的 dataengine 資料夾中,但永遠不會包含在壓縮的記錄檔封存中。

調查 Tableau Server 問題

Tableau Server 可能出現的問題的範圍和複雜性不同,這意味著沒有可用於調查所有問題的簡單過程,但常規方法包括以下步驟:

  1. 清理現有記錄檔以減小其大小。有關詳情,請參閱移除不需要的檔案

    重要提示:若您將來可能會向 Tableau 支援人員尋求幫助,以對問題進行疑難排解,請務必在清理記錄檔之前建立記錄檔的壓縮封存。清理可能會刪除支援人員可能需要的重要資訊。有關建立記錄檔封存的詳情,請參閱記錄檔快照(將記錄封存)

  2. 設定適當的記錄記錄層級。Tableau 支援人員將指示您執行此操作。有關詳情(包括不同記錄檔層級的影響),請參閱變更記錄層級
  3. 重現您要解決的問題,以便記錄捕獲與問題相關的事件。
  4. 建立記錄的存檔案。有關詳情,請參閱記錄檔快照(將記錄封存)

    重要資訊:在檢視記錄檔時使用此存檔案。不應直接在伺服器上編輯、移動或刪除任何檔案。

  5. 檢閱 TSM 管理控制器記錄檔 (\tabadmincontroller\tabadmincontroller_node<n>-<n>.log),以瞭解透過命令列、Web UI 或 API (包括 TSM 啟動的工作)執行完成的任何設定和部署。從控制器記錄檔開始。您可以在其中取得最實用的資訊。

    附註:tsm.log 的內容少於 tabadmincontroller_*.log,但可以提供有用的免費疑難排解資訊。

  6. 檢視 Apache 記錄 \httpd\access.####_##_##_##_##_##.log\httpd\error.log中可能與您要調查的問題相關的請求。

    Apache 記錄將包含大量不適用於您遇到的問題的 [無用資料] 。

    • 如果您找到似乎與您的問題相關的請求,請在 vizqlserver 目錄中搜尋包含 Apache 記錄中的唯一請求 ID 的條目。
    • 尋找與請求 ID 關聯的回應代碼和消息。
    • 搜尋與您的問題相關的工作簿、檢視、儀表板或資料來源的名稱。確保尋找相關的時間戳記。
    • 如果您找到可能與您的問題相關的請求,請檢視與該請求關聯的回應代碼。(200 表示正常,500 表示問題)。
    • 找到與您已確定的請求關聯的唯一請求 ID(唯一請求 ID 位於請求的末尾,是一個包含 24 個字元的字母數位字串)。
  7. 進一步檢視記錄存檔案,以搜尋其他消息和可能的錯誤。

    • 使用 Apache 記錄中的請求 ID 搜尋記錄存檔案的 vizqlserver 資料夾,以尋找包含相關記錄條目的檔案。尋找問題的跡象(例如錯誤消息或長時間執行的查詢)。
    • 免費的開放原始碼工具 Logshark 是檢閱記錄檔的有用選項。有關詳情,請參閱 Tableau 藍圖中的對 Tableau Server 進行疑難排解(連結在新視窗開啟)
  8. 檢視指令碼記錄記錄。

    Tableau Server 為大多數 bash 指令碼包括了記錄,這些記錄位於指令碼目錄中。預設情況下:C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\ 這些記錄會儲存至:

    • <install_drive>\<install\path>\logs\
      預設情況下: 
    • C:\ProgramData\Tableau\Tableau Server\logs\
  9. 與支援人員聯繫

    如果您自己無法解決問題或者 Tableau 支援人員要求您這麼做,請將壓縮的存檔傳送給 Tableau。

感謝您的意見反應!已成功提交您的意見回饋。謝謝!