在 Observability Analytics 中,您可以使用分析檢視表,透過 Cloud Logging 資料的自訂結構定義定義 SQL 查詢,以便簡化及重複使用複雜的轉換作業。建立分析檢視表後,您可以在其他 SQL 查詢的 FROM 子句中查詢結果,就像查詢記錄檢視表一樣。
如需分析檢視表的總覽,請參閱「關於分析檢視表」。
事前準備
-
如要取得建立、管理及使用分析檢視表所需的權限,請要求管理員授予您專案的下列 IAM 角色:
- Observability Analytics 使用者 (
roles/observability.analyticsUser) - 記錄檔檢視存取者 (
roles/logging.viewAccessor)
如要限制主體只能存取特定記錄檢視,您可以在專案層級授予「記錄檢視存取子」角色時,新增 IAM 條件,或是在記錄檢視的政策檔案中新增 IAM 繫結。詳情請參閱「控管記錄檔檢視畫面的存取權」。
如要瞭解查詢使用者定義 bucket 上的檢視表,或查詢
_Default記錄檔 bucket 的_AllLogs檢視表時,需要哪些其他角色,請參閱「Cloud Logging 角色」。 - Observability Analytics 使用者 (
- 確認您有已升級為使用 Observability Analytics 的記錄檔 bucket。如要瞭解這個步驟,請參閱「設定記錄檔 bucket」。
建立分析檢視表
如要建立分析檢視表,請按照下列步驟操作:
-
在 Google Cloud 控制台中,前往 manage_search「Observability Analytics」(觀測能力分析) 頁面:
前往「Observability Analytics」(觀測能力分析) 頁面
如果您是使用搜尋列尋找這個頁面,請選取子標題為「Logging」的結果。
- 設定「Observability Analytics」頁面:
- 確認工具列顯示「執行查詢」。 如果工具列顯示「Run in BigQuery」(在 BigQuery 中執行),請按一下 settings「Settings」(設定),然後選取「Observability Analytics (default)」(Observability Analytics (預設))。
- 如果未顯示「Views」(檢視表) 選單,請前往導覽窗格,然後按一下 last_page「Views and Schema」(檢視表和結構定義)。
輸入並驗證要儲存為分析檢視表的查詢。
您可能需要載入並編輯預設查詢,以便分析檢視表查詢記錄檢視表。如要載入預設查詢,請按照下列步驟操作:
在「Views」(檢視表) 選單中,前往「Logs」(記錄) ,找到並選取要查詢的記錄檢視表。
在「Schema」(結構定義) 工具列中,依序點選「Query」(查詢) 和「Overwrite」(覆寫)。
「查詢」窗格會更新,並顯示 SQL 查詢。
更新查詢,直到您滿意查詢結果為止。
建立分析檢視表:
在工具列中,按一下「save」(儲存) ,然後選取「Save as analytics view」(另存為分析檢視表)。
輸入分析檢視表的名稱和說明。
名稱長度上限為 100 個字元,且只能包含英文字母、數字、底線和連字號。分析檢視表建立後即無法變更名稱。
按一下 [儲存]。
系統會建立分析檢視表,並列在「Views」(檢視表) 窗格的「data_table」「Analytics Views」(分析檢視表) 部分。
查詢分析檢視表
查詢分析檢視表的方式與查詢記錄檢視表類似。如要查詢分析檢視表,請使用下列格式的 FROM 子句:
FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`
上述運算式中的欄位含義如下:
- PROJECT_ID:專案 ID。
- LOCATION:分析檢視表的位置。
- ANALYTICS_VIEW_ID:分析檢視表的 ID,長度上限為 100 個字元,且只能包含英文字母、數字、底線和連字號。
詳情請參閱「查詢及分析記錄檔總覽」。
列出分析檢視表
如要列出 Google Cloud 專案中的分析檢視表,請按照下列步驟操作:
-
在 Google Cloud 控制台中,前往 manage_search「Observability Analytics」(觀測能力分析) 頁面:
前往「Observability Analytics」(觀測能力分析) 頁面
如果您是使用搜尋列尋找這個頁面,請選取子標題為「Logging」的結果。
- 設定「Observability Analytics」頁面:
- 確認工具列顯示「執行查詢」。 如果工具列顯示「Run in BigQuery」(在 BigQuery 中執行),請按一下 settings「Settings」(設定),然後選取「Observability Analytics (default)」(Observability Analytics (預設))。
- 如果未顯示「Views」(檢視表) 選單,請前往導覽窗格,然後按一下 last_page「Views and Schema」(檢視表和結構定義)。
- 在「Views」(檢視表) 選單中,前往「data_table Analytics Views」(data_table 分析檢視表) 專區。
取得分析檢視表的詳細資料
您可以使用「Schema」(結構定義) 窗格中的選項,顯示分析檢視表的下列資訊:
- 名稱
- 建立日期
- 上次更新時間
- 結構定義
- 查詢
如要查看分析檢視表的詳細資料,請列出專案中的分析檢視表,然後執行下列操作:
- 選取要查看資訊的分析檢視表。
- 在「Schema」(結構定義) 工具列中,按一下 more_vert「View analytics view options」(查看分析檢視表選項),然後選取「View details」(查看詳細資料)。
修改分析檢視表
如要修改分析檢視表,請按照下列步驟操作:
-
在 Google Cloud 控制台中,前往 manage_search「Observability Analytics」(觀測能力分析) 頁面:
前往「Observability Analytics」(觀測能力分析) 頁面
如果您是使用搜尋列尋找這個頁面,請選取子標題為「Logging」的結果。
- 設定「Observability Analytics」頁面:
- 確認工具列顯示「執行查詢」。 如果工具列顯示「Run in BigQuery」(在 BigQuery 中執行),請按一下 settings「Settings」(設定),然後選取「Observability Analytics (default)」(Observability Analytics (預設))。
- 如果未顯示「Views」(檢視表) 選單,請前往導覽窗格,然後按一下 last_page「Views and Schema」(檢視表和結構定義)。
- 在「Views」(檢視表) 選單中,前往「data_table Analytics Views」(data_table 數據分析檢視表) 區段,然後選取要修改的數據分析檢視表。
在「Schema」(結構定義) 工具列中,按一下 more_vert「View analytics view options」(查看分析檢視表選項),然後選取「Edit view」(編輯畫面)。
對話方塊隨即開啟,顯示分析檢視表的相關資訊。您可以修改說明和查詢。
完成修改後,按一下「Overwrite saved view」(覆寫已儲存的檢視畫面)。
刪除分析檢視表
如要刪除分析檢視表,請按照下列步驟操作:
-
在 Google Cloud 控制台中,前往 manage_search「Observability Analytics」(觀測能力分析) 頁面:
前往「Observability Analytics」(觀測能力分析) 頁面
如果您是使用搜尋列尋找這個頁面,請選取子標題為「Logging」的結果。
- 設定「Observability Analytics」頁面:
- 確認工具列顯示「執行查詢」。 如果工具列顯示「Run in BigQuery」(在 BigQuery 中執行),請按一下 settings「Settings」(設定),然後選取「Observability Analytics (default)」(Observability Analytics (預設))。
- 如果未顯示「Views」(檢視表) 選單,請前往導覽窗格,然後按一下 last_page「Views and Schema」(檢視表和結構定義)。
- 在「Views」(檢視表) 選單中,前往「data_table Analytics Views」(data_table 分析檢視表) 區段,然後選取要刪除的分析檢視表。
- 在「Schema」(結構定義) 工具列中,按一下 more_vert「View analytics view options」(查看分析檢視表選項),選取「Delete view」(刪除檢視表),然後完成對話方塊。
限制
分析檢視表有下列限制:
- 分析檢視表只能查詢記錄檢視表。
- 分析檢視表的父項資源必須是 Google Cloud 專案。
- 您只能透過 Observability Analytics 頁面查詢分析檢視表,且必須使用 Observability Analytics (預設) 查詢引擎。
- 分析檢視表查詢的所有檢視表,都必須位於相同位置。
- 您必須使用 Google Cloud 控制台建立或管理分析檢視表。
- 每個 Google Cloud 專案最多可建立 100 個分析檢視表。
- 每個區域最多可建立 50 個分析檢視表。
- 每個 Google Cloud 專案最多可有 10 個區域包含分析檢視表。