使用活動記錄檔監視檢視載入時間

確保檢視以最佳方式呈現給使用者是管理員的重要職責。使用活動記錄檔,可以即時識別效能問題並解決出現的問題,以確保站台順利運作。

本主題會介紹管理員可以如何使用 vizql_http_request 事件類型來瞭解檢視載入時間並對效能瓶頸進行疑難排解。

先決條件

若要監視檢視載入時間,活動記錄檔資料必須採用結構化且可查詢的格式。在繼續之前,請確保滿足以下先決條件:

  • 活動記錄檔設定:設定活動記錄檔,以將記錄檔檔案寫入 AWS S3 儲存貯體。

  • 資料匯入:將活動記錄檔產生的記錄檔檔案匯入監視工具,例如 Splunk 或 Amazon EventBridge。或者,也可以將它們匯入到 Snowflake 或 Google BigQuery 等雲端資料倉儲。目標是將資料轉換為易於查詢和分析的格式。

附註:本主題不會介紹將活動記錄檔資料匯入資料存放區的過程。有關詳細說明,請參閱設定活動記錄和所選資料平台的文件。

開始使用

那麼我們從何處開始呢?可以透過關注儀表板或檢視的初始載入(稱為「啟動程序工作階段」事件)來監視檢視效能。此事件通常會擷取呈現檢視所需的大部分時間,從而清楚地指示載入花費的時間。

若要監視啟動程序事件:

  1. 開啟已設定的監視工具,例如 Splunk 或 Amazon EventBridge。

  2. 篩選這些值:

    1. eventType = vizql_http_request

    2. endpointName = bootstrapSession

    3. eventOutcome = success

  3. 在結果中,尋找欄位 duration

vizql_http_request 事件的「持續時間」欄位表示作業完成所花費的時間(以毫秒為單位)。這有助於追蹤和分析 Tableau 檢視的初始載入時間。

提示:不確定從何處入手?使用「管理員洞察入門」工作簿中包含的「儀表板載入時間」儀表板。此儀表板會顯示內容的載入時間和效能評級,幫助您識別有問題的檢視。然後,可以使用活動記錄檔即時查看哪些使用者遇到了問題,以及工作簿修訂可能如何影響效能。有關詳情,請參閱使用管理員洞察建立自訂檢視

監視錯誤

除了效能之外,還可以使用啟動程序工作階段資料來查看使用者在檢視內容時是否遇到錯誤。若要查看這些錯誤,請搜尋 eventOutcome 和 eventOutcomeReason 欄位。這些欄位對於設定監視通知和提供調查起點非常有用。例如,若使用者在檢視儀表板時報告錯誤,您可以查看啟動程序工作階段,以查看歷史使用者互動。這有助於您查明觸發錯誤的原因並確定問題開始的時間。瞭解此資訊對於問題的根本原因疑難排解非常重要。

  • eventOutcome:此欄位會記錄每個作業的高層級成功或失敗類別(成功、失敗、client_error 或 internal_error)。

  • eventOutcomeReason:此欄位會提供有關所發生問題的更多詳細資訊,通常會記錄描述錯誤的 HTTP 狀態代碼。

若要監視錯誤:

  1. 開啟已設定的監視工具,例如 Splunk 或 Amazon EventBridge。

  2. 篩選這些值:

    1. eventType = vizql_http_request

    2. endpointName = bootstrapSession

    3. eventOutcome != success

  3. 在結果中,檢閱 eventOutcomeReason,以取得有關錯誤的更多詳細資訊。

效能問題疑難排解

有許多因素可能導致效能問題,使得它們難以調查。但是,您可以採用一些方法來簡化該過程。本節會概述使用啟動程序工作階段對工作簿效能進行疑難排解的常用方法。首先,確定問題是局限於一個工作簿還是多個工作簿。然後,請遵循相關部分中的說明。

對單一工作簿進行疑難排解

若效能問題與單一工作簿有關,請執行下列步驟。

  1. 識別工作簿修訂:

    檢查效能問題是否是由新的工作簿修訂引入。可以透過檢閱啟動程序工作階段中的 workbookRevision 屬性來執行此動作。此過程可能需要將使用者造訪情況與工作簿的先前版本進行比較。

    若新的修訂導致了效能問題,請聯絡工作簿擁有者,並與他們合作改進設計。

  2. 檢查使用者特定的問題:

    若效能問題並非特定於工作簿修訂,請確定它是否僅影響某些使用者。可以透過查看啟動程序工作階段中的 requestUriactorUserLuid 屬性來執行此動作。requestUri 屬性會提供正在存取的工作簿或檢視的 URL,actorUserLuid 屬性會提供存取該檢視的使用者。同時使用兩者可幫助您區分個別使用者工作階段。

    若問題特定於使用者,請尋找使用者之間的相似之處。例如,這可能是由於這些使用者正在存取的自訂檢視或他們與檢視互動的某些方式所致。您將需要剖析 requestURI 屬性以識別特定檢視。

  3. 檢閱列層級安全性:

    若某些使用者遇到效能問題,而自訂檢視不是導致問題的原因,則問題可能與工作簿中實作的列層級安全性 (RLS) 有關。RLS 會顯著影響效能,尤其是在安全性規則複雜或資料集較大的情況下。有關更多資訊,請參閱 Tableau 中的列層級安全性選項概觀

對部分工作簿進行疑難排解

若效能問題與部分工作簿有關,請執行下列步驟。

  1. 識別常用資料來源:

    尋找受影響的工作簿所使用的資料來源中的共同點。

    若受影響的工作簿使用與資料庫伺服器或雲端資料倉儲的即時連線,則效能問題可能出在即時連線上。

    若受影響的工作簿使用資料擷取,請檢查它們是否有最近的更新。可以使用活動記錄檔中的 hist_publish_datasource 事件類型或「管理員洞察」中的 TS 事件資料來源來識別近期變更。

  2. 檢閱資料來源效能:

    對於即時連線,請監視資料庫伺服器或雲端資料倉儲的效能。檢查伺服器端是否有任何近期變更或問題。此步驟在 Tableau 外部執行。

    對於擷取資料來源,請檢閱擷取過程和任何近期更新。確保擷取已最佳化,且資料不會過大或過於複雜。有關詳情,請參閱在 Web 上建立擷取

重要注意事項

使用活動記錄檔監視檢視載入時間是掌控儀表板效能和使用者參與度的絕佳方法。但是,並非每個儀表板或檢視呈現作業都會產生啟動程序工作階段事件。以下是一些不需要啟動程序工作階段事件的情境:

  • 快取儀表板:若儀表板或檢視從先前的快取中擷取。

  • 索引標籤切換:若使用者在同一工作簿內切換索引標籤,並且新索引標籤的內容已載入或快取。

透過使用 vizql_http_request 事件類型並關注 bootstrapSession 事件,可以取得有關檢視效能的寶貴見解並主動解決問題。

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