建立、查詢及管理 Analytics 檢視畫面

本文說明如何建立及管理 Analytics 檢視區。建立 Analytics 檢視區塊後，您可以使用類似於查詢可觀測性檢視區塊的方式查詢該檢視區塊。

如要瞭解數據分析檢視畫面，請參閱「關於數據分析檢視畫面」。

事前準備

  1. 登入 Google Cloud 帳戶。如果您是 Google Cloud新手，歡迎 建立帳戶，親自評估產品在實際工作環境中的成效。新客戶還能獲得價值 $300 美元的免費抵免額，可用於執行、測試及部署工作負載。

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Observability API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Observability API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

  8. 如要取得建立、管理及使用 Analytics 檢視畫面所需的權限，請要求系統管理員授予您下列 IAM 角色：

    • 觀測能力檢視畫面存取子 (roles/observability.viewAccessor) 在您要查詢的觀測能力檢視畫面中，這個角色支援 IAM 條件，可讓您將授權限制在特定檢視區塊。如果未將條件附加至角色授權，主體就能存取所有可觀測性檢視畫面。可觀測性檢視畫面為公開測試版。
    • 您專案的「Observability Analytics User」 (roles/observability.analyticsUser) 權限。這個角色具備儲存及執行私人查詢，以及執行共用查詢所需的權限。
    • 記錄檢視器 (roles/logging.viewer) 專案。

    如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

    您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

  9. 確認您有可觀測性檢視畫面。詳情請參閱 Cloud Trace 儲存空間模型。

建立 Analytics 檢視區塊

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

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

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

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

  2. 設定「可觀測性分析」頁面：
    1. 確認工具列顯示「執行查詢」。如果工具列顯示 在 BigQuery 中執行，請按一下 設定，然後選取 可觀測性分析 (預設)。
    2. 如果沒有顯示「檢視畫面」選單，請前往導覽窗格，然後按一下「檢視畫面和結構定義」。

  3. 輸入並驗證要儲存為數據分析檢視畫面的查詢。

    您可能需要載入並編輯可觀測性檢視畫面的預設查詢，供數據分析檢視畫面查詢。如要載入預設查詢，請執行下列操作：

    1. 在「檢視」選單中，前往「追蹤」 部分，然後選取 _Trace.Spans._AllSpans。

    2. 在「結構定義」工具列中，依序點選「查詢」和「覆寫」。

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

    3. 更新查詢，直到您對查詢結果感到滿意為止。

  4. 建立數據分析檢視畫面：

    1. 在工具列中，依序點選「儲存」和「另存為 Analytics 檢視區塊」。

    2. 輸入資料分析檢視的名稱和說明。

      名稱長度上限為 100 個字元，只能包含英文字母、數字、底線和連字號。分析檢視建立後即無法變更名稱。

    3. 按一下 [儲存]。

    系統會建立 Analytics 資料檢視，並列在「資料檢視」窗格的「data_table」「Analytics 資料檢視」部分。

查詢數據分析檢視畫面

查詢數據分析檢視畫面時，方式與查詢可觀測性檢視畫面類似。如要查詢 Analytics 檢視區塊，請使用下列格式的 FROM 子句：

FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

上述運算式中的欄位具有下列意義：

  • PROJECT_ID：專案的 ID。
  • LOCATION：分析檢視的位置。
  • ANALYTICS_VIEW_ID：Analytics 檢視區塊的 ID，最多 100 個字元，只能包含英文字母、數字、底線和連字號。

詳情請參閱「查詢及分析追蹤記錄」。

列出 Analytics 資料檢視

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

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

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

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

  2. 設定「可觀測性分析」頁面：
    1. 確認工具列顯示「執行查詢」。如果工具列顯示 在 BigQuery 中執行，請按一下 設定，然後選取 可觀測性分析 (預設)。
    2. 如果沒有顯示「檢視畫面」選單，請前往導覽窗格，然後按一下「檢視畫面和結構定義」。

  3. 在「Views」選單中，前往「data_table」「Analytics Views」部分。

取得 Analytics 資料檢視的詳細資料

您可以使用「結構定義」窗格中的選項，顯示有關 Analytics 檢視的下列資訊：

  • 名稱。
  • 建立日期。
  • 上次更新時間。
  • 結構定義。
  • 查詢。

如要查看 Analytics 檢視區塊的詳細資料，請列出專案中的 Analytics 檢視區塊，然後執行下列步驟：

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

修改 Analytics 資料檢視

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

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

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

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

  2. 設定「可觀測性分析」頁面：
    1. 確認工具列顯示「執行查詢」。如果工具列顯示 在 BigQuery 中執行，請按一下 設定，然後選取 可觀測性分析 (預設)。
    2. 如果沒有顯示「檢視畫面」選單，請前往導覽窗格，然後按一下「檢視畫面和結構定義」。

  3. 在「Views」(檢視) 選單中，前往「data_table」「Analytics Views」(Analytics 檢視) 部分，然後選取要修改的 Analytics 檢視。

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

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

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

刪除數據分析資料檢視

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

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

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

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

  2. 設定「可觀測性分析」頁面：
    1. 確認工具列顯示「執行查詢」。如果工具列顯示 在 BigQuery 中執行，請按一下 設定，然後選取 可觀測性分析 (預設)。
    2. 如果沒有顯示「檢視畫面」選單，請前往導覽窗格，然後按一下「檢視畫面和結構定義」。

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

限制

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

  • 分析檢視區塊只能查詢可觀測性檢視區塊。
  • 分析檢視區塊的上層資源必須是 Google Cloud 專案。
  • 您只能使用 Observability Analytics 頁面查詢 Analytics 檢視區， 且只能使用 Observability Analytics (預設) 查詢引擎。
  • Analytics 檢視區塊查詢的所有檢視區塊都必須位於相同位置。
  • 您必須使用 Google Cloud 控制台建立或管理 Analytics 檢視區。
  • 每個專案最多可建立 100 個 Google Cloud 分析資料檢視。
  • 每個區域最多可建立 50 個 Analytics 資料檢視。
  • 每個 Google Cloud 專案最多可有 10 個區域包含數據分析檢視畫面。

後續步驟