建立、查詢及管理數據分析檢視畫面

預先發布版

這項產品或功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。 正式發布前的產品和功能是按照「原樣」提供，支援範圍可能有限。 詳情請參閱推出階段說明。

本文說明如何建立、管理及查詢 Analytics 檢視區塊。如需概念總覽，請參閱「關於數據分析檢視區塊」。

事前準備

注意： 沒有預先定義的 Cloud Logging Identity and Access Management (IAM) 角色，包含建立或查詢 Analytics 檢視區塊所需的權限。

由於 Analytics 資料檢視會查詢記錄檔資料檢視，因此您的 IAM 角色也必須允許您查詢記錄檔資料檢視，並使用 Log Analytics，才能建立及查詢 Analytics 資料檢視。本節列出建立 Analytics 檢視區塊所需的 IAM 角色，以及查詢記錄檢視區塊和使用記錄檔分析所需的角色：

• 如要取得建立、管理及使用 Analytics 檢視畫面所需的權限，請要求管理員授予您專案的「可觀測性 Analytics 使用者」 (roles/observability.analyticsUser) IAM 角色。

  這個預先定義的角色具備建立、管理及使用數據分析檢視畫面所需的權限。如要查看確切的必要權限，請展開「必要權限」部分：

  所需權限

  如要建立、管理及使用 Analytics 資料檢視，必須具備下列權限：

  • observability.analyticsViews.get
  • observability.analyticsViews.list
  • observability.analyticsViews.create
  • observability.analyticsViews.update
  • observability.analyticsViews.delete

• 如要取得查詢記錄檢視區和使用記錄檔分析功能所需的權限，請要求管理員將專案的下列 IAM 角色授予您：

  • 如要查詢 _Required 和 _Default 記錄檔值區： 記錄檢視器 (roles/logging.viewer)
  • 如要查詢專案中的所有記錄檢視畫面： 記錄檢視畫面存取者 (roles/logging.viewAccessor)

  如要將主體限制為特定記錄檢視畫面，請在專案層級授予記錄檢視畫面存取者角色時新增 IAM 條件，或在記錄檢視畫面的政策檔案中新增 IAM 繫結。詳情請參閱「控管記錄檢視畫面存取權」。

  如要瞭解查詢使用者定義值區中的檢視區塊，或查詢 _Default 記錄值區的 _AllLogs 檢視區塊時，需要哪些額外角色，請參閱「Cloud Logging 角色」一文。

建立 Analytics 檢視畫面

注意： Analytics 檢視區只能查詢記錄檢視區。查詢多個記錄檢視時，這些記錄檢視所屬的記錄桶必須位於同一位置。舉例來說，如果您在 us-east1 位置有兩個記錄檔值區，則可以建立分析檢視區塊，查詢這些記錄檔值區的記錄檔檢視區塊。

如要建立 Analytics 檢視區，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Log Analytics」(記錄檔分析) 頁面：

   前往「Log Analytics」(記錄檔分析)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Logging」的結果。

2. 在「Views」(檢視畫面) 選單中，前往「segment」(區隔)「Logs」(記錄) 專區，然後選取要查詢的記錄檢視畫面。

   如要尋找記錄檢視畫面，可以使用「篩選」列，或捲動瀏覽記錄檢視畫面清單。清單中的每個項目都採用下列格式 BUCKET_ID.LOG_VIEW_ID，其中這些欄位是指記錄水桶和記錄檢視區塊的 ID。

3. 在「結構定義」工具列中，按一下「查詢」。

   「查詢」窗格會更新為 SQL 查詢。

4. 確認工具列顯示「執行查詢」。

   如果工具列顯示「在 BigQuery 中執行」，請按一下「設定」，然後選取「記錄分析 (預設)」。

5. 在「Query」(查詢) 窗格中更新 SQL 查詢，直到您對查詢結果感到滿意為止。

6. 依序按一下工具列中的「儲存」和「另存為 Analytics 檢視區塊」。

7. 輸入 Analytics 檢視區的名稱和說明，然後按一下「儲存」。

   名稱長度上限為 100 個字元，只能包含英文字母、數字、底線和連字號。

   注意： 分析檢視建立後，即無法變更名稱。你可以修改說明和查詢。

   系統會建立您的數據分析檢視，並列在「檢視」窗格中，位於「data_table」data_table「Analytics 檢視」部分下方。清單中的每個項目都採用以下格式LOCATION.ANALYTICS_VIEW_ID，其中這些欄位是指 Analytics 檢視的地區和 ID。舉例來說，如果您建立的 Analytics 資料檢視名稱為 my-analytic-view，且查詢的記錄檢視區塊位於 global 區域，則這個部分會顯示 global.my-analytic-view。

查詢數據分析檢視畫面

建立分析檢視後，您就可以查詢該檢視，方式與查詢記錄檢視類似。如需說明如何使用「記錄檔分析」頁面的文件清單，請參閱本文的「後續步驟」一節。

如要為 Analytics 檢視畫面執行預設查詢，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Log Analytics」(記錄檔分析) 頁面：

   前往「Log Analytics」(記錄檔分析)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Logging」的結果。

2. 輸入查詢或載入 Analytics 檢視區的預設查詢。 查詢的 FROM 子句應採用下列格式：

   FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`
   

   在上一個運算式中，各個欄位的意義如下：

   • PROJECT_ID：專案的 ID。
   • LOCATION：分析檢視的位置。 分析檢視區的位置會沿用查詢資源的位置。舉例來說，如果 Analytics 資料檢視查詢位於 global 位置的記錄檔檢視，則 Analytics 資料檢視的位置也會是 global。
   • ANALYTICS_VIEW_ID：Analytics 檢視區塊的 ID，長度上限為 100 個字元，且只能包含英文字母、數字、底線和連字號。

   如要執行預設查詢，請按照下列步驟操作：

   1. 在「Views」(檢視) 選單中，前往 data_table「Analytics Views」(數據分析檢視) 區段，然後選取要查詢的數據分析檢視。

      如要尋找數據分析檢視畫面，可以使用「篩選器」列，或捲動瀏覽數據分析檢視畫面清單。清單中的每個項目都採用以下格式LOCATION.ANALYTICS_VIEW_ID，其中這些欄位是指 Analytics 檢視區的位置和 ID。

   2. 在「結構定義」工具列中，按一下「查詢」。

      「查詢」窗格會更新，顯示查詢所選 Analytics 檢視區的 SQL 查詢。

3. 點選「執行查詢」

   如果工具列顯示「在 BigQuery 中執行」，請按一下「設定」，然後選取「記錄分析 (預設)」。

列出 Analytics 資料檢視

如要列出 Google Cloud 專案中的 Analytics 檢視區，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Log Analytics」(記錄檔分析) 頁面：

   前往「Log Analytics」(記錄檔分析)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Logging」的結果。

2. 在「Views」(檢視畫面) 選單中，前往「data_table」(資料表) data_table「Analytics Views」(數據分析檢視畫面) 部分。

   畫面上會顯示 Analytics 資料檢視清單。清單中的每個項目都採用以下格式 LOCATION.ANALYTICS_VIEW_ID，其中這些欄位是指 Analytics 檢視區的位置和 ID。舉例來說，如果您建立的 Analytics 資料檢視名稱為 my-analytic-view，且查詢的記錄檢視區塊位於 global 區域，則這個部分會顯示 global.my-analytic-view。

3. 如要查看特定 Analytics 檢視區的詳細資料，請按照下列步驟操作：

   1. 選取 Analytics 資料檢視。

      「Schema」(結構定義) 區段會顯示 Analytics 檢視區塊的結構定義。

   2. 在「結構定義」工具列中， 按一下 「查看分析檢視畫面選項」， 然後選取「查看詳細資料」。

      對話方塊會顯示 Analytics 資料檢視的相關資訊，包括 Analytics 資料檢視的建立時間、結構定義和查詢。

修改 Analytics 資料檢視

如要修改 Analytics 檢視區，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Log Analytics」(記錄檔分析) 頁面：

   前往「Log Analytics」(記錄檔分析)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Logging」的結果。

2. 在「Views」(檢視) 選單中，前往 data_table「Analytics Views」(數據分析檢視) 區段，然後選取要查詢的數據分析檢視。

3. 在「結構定義」工具列中， 按一下 「查看分析檢視畫面選項」， 然後選取「編輯檢視畫面」。

   系統會開啟對話方塊，顯示 Analytics 檢視畫面資訊。 你可以修改說明和查詢。

4. 完成修改後，按一下「覆寫已儲存的檢視畫面」。

刪除數據分析資料檢視

注意： 如果您已針對 Analytics 檢視區塊編寫查詢，並刪除該檢視區塊，這些查詢就會失敗。

如要刪除 Analytics 檢視區，請按照下列步驟操作：

1. 在 Google Cloud 控制台中，前往「Log Analytics」(記錄檔分析) 頁面：

   前往「Log Analytics」(記錄檔分析)

   如果您是使用搜尋列尋找這個頁面，請選取子標題為「Logging」的結果。

2. 在「Views」(檢視) 選單中，前往 data_table「Analytics Views」(數據分析檢視) 區段，然後選取要查詢的數據分析檢視。
3. 在「結構」工具列中， 按一下「查看數據分析檢視選項」， 選取「刪除檢視」，然後完成對話方塊。

限制

分析檢視畫面有下列限制：

• 分析檢視畫面無法查詢其他分析檢視畫面。
• 分析檢視區塊可以查詢多個記錄檢視區塊。不過，主機代管所查詢記錄檢視區的記錄 bucket 必須位於同一位置。舉例來說，假設您有兩個記錄值區，一個位於 us-east1，另一個位於 asia-east1。您無法建立分析檢視區塊，查詢這些記錄檔儲存空間中的記錄檔檢視區塊。
• Analytics 檢視區塊的父項資源必須是 Google Cloud 專案。您無法在資料夾或機構中建立 Analytics 檢視區。
• 分析檢視區不支援連結的資料集。因此，您只能使用「記錄檔分析」頁面查詢 Analytics 檢視畫面。此外，您必須在預設的 Cloud Logging 服務上執行這些查詢。
• 無法透過 API 建立或管理數據分析檢視區。

• 以下限制適用於 Analytics 檢視區：

  • 每個 Google Cloud 專案的 Analytics 檢視畫面數量上限：100 個
  • 每個 Google Cloud 專案在每個區域的 Analytics 檢視畫面數量上限：50 個
  • 每個 Google Cloud 專案最多可儲存 10 個區域的 Analytics 檢視畫面。

後續步驟

• 查詢及分析記錄檔總覽
• 儲存及共用 SQL 查詢
• 繪製 SQL 查詢結果圖表
• SQL 查詢示例