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

您可以在 Observability Analytics 中使用 Analytics 檢視畫面，透過 Cloud Trace 資料的自訂結構定義 SQL 查詢，簡化及重複使用複雜的轉換作業。建立分析檢視畫面後，您可以在其他 SQL 查詢的 FROM 子句中查詢結果，就像查詢可觀測性檢視畫面一樣。

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

事前準備

  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, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). 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, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    8.

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

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

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

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

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

建立分析檢視表

如要建立分析檢視表，請按照下列步驟操作：

  1. 在 Google Cloud 控制台中，前往 「Observability Analytics」(觀測能力分析) 頁面：

    前往「Observability Analytics」(觀測能力分析) 頁面

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

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

  3. 輸入並驗證要儲存為分析檢視表的查詢。

    您可能需要載入並編輯預設查詢，供 Analytics 檢視區塊查詢可觀測性檢視區塊。如要載入預設查詢，請按照下列步驟操作：

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

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

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

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

  4. 建立分析檢視表：

    1. 在工具列中，依序點選 儲存，然後選取 另存為分析檢視表。

    2. 輸入 Analytics 分析檢視表的名稱和說明。

      名稱最多只能有 100 個字元，且只能包含英文字母、數字、底線和連字號。分析檢視建立後即無法變更名稱。

    3. 按一下 [儲存]。

    系統會建立分析檢視表，並列在 Views 窗格的 Analytics Views 部分。

查詢分析檢視表

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

FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

先前運算式中的欄位具有下列意義：

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

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

列出 Analytics 資料檢視

如要列出 Google Cloud 專案中的 Analytics 檢視畫面，請執行下列操作：

  1. 在 Google Cloud 控制台中，前往 「Observability Analytics」(觀測能力分析) 頁面：

    前往「Observability Analytics」(觀測能力分析) 頁面

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

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

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

取得數據分析檢視的詳細資料

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

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

如要查看分析檢視表的詳細資料，請列出專案中的分析檢視表，然後執行下列操作：

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

修改 Analytics 分析檢視表

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

  1. 在 Google Cloud 控制台中，前往 「Observability Analytics」(觀測能力分析) 頁面：

    前往「Observability Analytics」(觀測能力分析) 頁面

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

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

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

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

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

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

刪除分析檢視表

如要刪除分析檢視表，請按照下列步驟操作：

  1. 在 Google Cloud 控制台中，前往 「Observability Analytics」(觀測能力分析) 頁面：

    前往「Observability Analytics」(觀測能力分析) 頁面

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

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

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

限制

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

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

後續步驟