建立、查詢及管理 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. 啟用 Observability API。

    啟用 API 時所需的角色

    如要啟用 API，您需要服務使用情形管理員 IAM 角色 (roles/serviceusage.serviceUsageAdmin)，其中包含 serviceusage.services.enable 權限。瞭解如何授予角色。

    啟用 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. 啟用 Observability API。

    啟用 API 時所需的角色

    如要啟用 API，您需要服務使用情形管理員 IAM 角色 (roles/serviceusage.serviceUsageAdmin)，其中包含 serviceusage.services.enable 權限。瞭解如何授予角色。

    啟用 API

    8.

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

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

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

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

  9. 請確認您已具備下列至少一項條件：

建立 Analytics 檢視區塊

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

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

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

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

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

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

    您可能需要載入並編輯預設查詢，以供 Analytics 檢視畫面查詢記錄檢視畫面或可觀測性檢視畫面。如要載入預設查詢，請執行下列操作：

    1. 在「檢視畫面」選單中，執行下列任一操作：

      • 前往「區隔」「記錄」部分，然後選取記錄檢視畫面。
      • 前往「追蹤」部分，然後選取 _Trace.Spans._AllSpans。

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

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

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

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

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

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

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

    3. 按一下 [儲存]。

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

查詢數據分析檢視畫面

查詢 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. 設定「Log Analytics」(記錄檔分析) 頁面：
    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. 設定「Log Analytics」(記錄檔分析) 頁面：
    1. 確認工具列顯示「執行查詢」。 如果工具列顯示「在 BigQuery 中執行」，請按一下「設定」，然後選取「記錄檔分析 (預設)」。
    2. 如果沒有顯示「檢視畫面」選單，請前往導覽窗格，然後按一下「檢視畫面和結構定義」。

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

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

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

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

刪除數據分析資料檢視

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

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

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

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

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

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

限制

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

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

後續步驟