Connect 到 Google 雲端監控資料來源 - Amazon Managed Grafana
新增資料來源身分驗證使用查詢編輯器模板註釋從 Grafana 面板深層鏈接到谷歌雲控制台中的指標資源管理器

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Connect 到 Google 雲端監控資料來源

注意

在早期版本的 Grafana，這個數據源被命名為谷歌堆棧驅動程序。

新增 Google 雲端監控資料來源，以便為您的 GCP 監控指標建立儀表板。

新增資料來源

  1. 通過選擇頂部標題中的圖標打開側面菜單圖標。

  2. 在側面菜單中，在儀表板鏈接下，您應該找到數據源鏈接。

  3. 選擇頂部標題中的 + 添加數據源按鈕。

  4. 從類型下拉列表中選擇谷歌雲監控。

  5. 上傳或貼上服務帳戶金鑰檔案。如需建立服務帳戶金鑰檔案的步驟，請參閱本文件稍後的部分。

注意

如果您在側邊功能表中沒有看到 [資料來源] 連結，表示您目前的使用者沒有該Admin角色。

名稱 描述
Name 資料來源名稱。這是您在面板和查詢中引用數據源的方式。
Default 預設資料來源表示將為新面板預先選取該資料來源。
Service Account Key GCP 專案的服務帳戶金鑰檔案。請參閱本文件稍後的有關如何建立它的指示。

身分驗證

有兩種方法來驗證谷歌雲監控插件

  • 上傳一個谷歌 JWT 文件

  • 自動從 Google 元數據服務器檢索憑據

後一個選項僅在 GCE 虛擬機上運行 Grafana 時可用。

使用 Google 服務帳戶密鑰文件

若要使用 Google 雲端監控 API 進行驗證，您必須為要顯示資料的專案建立 Google 雲端平台 (GCP) 服務帳戶。Grafana 資料來源與一個 GCP 專案整合。若要將多個 GCP 專案中的資料視覺化，您必須為每個 GCP 專案建立一個資料來源。

啟用 API

必須先啟用下列 API：

選擇列出的連結，然後選擇 [啟用] 按鈕。

為專案建立 GCP 服務帳戶

  1. 導覽至「API 和服務認證」頁面。

  2. 選擇「建立憑證」下拉式清單/按鈕，然後選擇「服務帳戶金鑰」選項。

    {{< 文檔圖像框 IMG =」/img/docs/v71/cloudmonitoring_create_service_account_button.png「類 =」文檔圖像-無陰影」標題 =「創建服務帳戶按鈕」>}}

  3. 在 [建立服務帳戶金鑰] 頁面上，選擇金鑰類型JSON。然後，在服務帳戶下拉列表中，選擇新服務帳戶選項。

    {{< 文檔圖像框 IMG =」/img/docs/v71/cloudmonitoring_create_service_account_key.png「類 =」文檔圖像-無陰影」標題 =「創建服務帳戶密鑰」>}}

  4. 將會出現一些新欄位。在 [服務帳戶名稱] 欄位中填入服務帳戶的名稱，然後從 [角色] 下拉式清單中選擇 [監視檢視器] 角色。

    {{< 文檔圖像框 IMG =」/img/docs/v71/cloudmonitoring_service_account_choose_role.png「類 =」文檔圖像-無陰影」字幕 =「選擇角色」>}}

  5. 選擇建立按鈕。將創建 JSON 密鑰文件並將其下載到您的計算機。將此文件存儲在安全的地方，因為它允許訪問您的 Google 雲監控數據。

  6. 將其上傳到資料來源設定頁面上的 Grafana。您可以上傳文件或粘貼到文件的內容中。

    {{< 文檔圖像框 IMG =」/img/docs/v71/cloudmonitoring_grafana_upload_key.png「類 =」文檔圖像，無陰影」標題 =「上傳服務密鑰文件到 Grafana」>}}

  7. 文件內容將被加密並保存在 Grafana 數據庫中。上傳文件後不要忘記保存！

    {{< 文檔圖像框 IMG =」/img/docs/v71/cloudmonitoring_grafana_key_uploaded.png「類 =」文檔圖像，無陰影」標題 =「服務密鑰文件上傳到 Grafana」>}}

使用查詢編輯器

Google 雲端監控查詢編輯器可讓您建立兩種類型的查詢：量度和服務等級目標 (SLO)。兩種類型都會傳回時間序列資料。

量度查詢

量度查詢編輯器可讓您選取量度、依標籤和時間分組/彙總，以及使用篩選器來指定要在結果中顯示的時間序列。

若要建立量度查詢，請依照下列步驟執行：

  1. 在「查詢類型」下拉式清單中選擇「度量」選項。

  2. 從「專案」下拉式清單中選擇專案。

  3. 從「服務」下拉式清單中選擇 Google 雲端平台服務。

  4. 從「量度」下拉式清單中選擇量度。

  5. 若要新增或移除篩選器或依子句分組，請在篩選條件中使用加號和減號圖示，並依區段分組。此為選擇性步驟。

谷歌雲監控指標可以是不同的類型（GRAFT，增量，累計），這些類型支持不同的聚合選項（減速器和對準器）。Grafana 查詢編輯器會顯示所選量度的可用彙總方法清單，並在您選取量度時設定預設的縮減器和對齊器。查詢編輯器也會自動選取 Y 軸的單位。

篩選條件

若要新增篩選條件，請選擇加號圖示，選擇篩選依據的欄位，然後輸入篩選值。例如，​輸入 instance_name = grafana-1。您可以選擇篩選名稱並選取來移除篩選--remove filter--。

簡單的萬用字元

當運算子設定為或時，=!=可以在篩選值欄位中新增萬用字元。例如，us-*擷取所有以「us-」開頭的值，並*central-a擷取所有以「central-a」結尾的值。 *-central-*會擷取具有子字串的central-所有值。簡單的萬用字元比規則運算式便宜。

常規表達式

當運算子設定為或時，可=~!=~以將規則運算式新增至篩選器值欄位。例如，us-central[1-3]-[af]符合以「us-Central」開頭的所有值，後跟 1 到 3 範圍內的數字、破折號，然後是「a」或「f」。建立規則運算式時，不需要前置和尾隨斜線。

聚合

彙總欄位可讓您根據一般統計資料合併時間序列。如需彙總的詳細資訊，請參閱彙總選項。

此Aligner欄位可讓您依時間間隔對齊同一個群組之後的多個時間序列。如需有關對齊器的詳細資訊，請參閱對齊度量選擇器。

對齊週期和按時間分組

如果選擇彙總，則會依時間將測量結果分Alignment Period組。預設值是使用 GCP Google 雲端監控預設分組 (可讓您比較 Grafana 中的圖形與 Google 雲端監控 UI 中的圖形)。該選項被調用cloud monitoring auto，默認值是：

  • 1 米，用於時間範圍 <23 小時

  • 5 米的時間範圍 > = 23 小時和少於 6 天

  • 1 小時的時間範圍 > = 6 天

另一個自動選項是grafana auto。這將根據選擇的時間範圍和圖形面板的寬度自動按時間設置組。如需詳細資訊，請參閱 新增間隔變數。

也可以選擇固定的時間間隔進行分組，例如1h或1d。

分組依據

依資源或量度標籤分組，以減少時間序列數目，並依群組彙總結果。例如，按照 instance_name 分組以查看計算執行個體的彙總指標。

元數據標籤

資源中繼資料標籤包含可唯一識別 GCP 中資源的資訊。中繼資料標籤只有在時間序列請求中屬於「群組依據」區段的一部分時，才會在時間序列回應中傳回。沒有用於擷取中繼資料標籤的 API，因此無法依下拉式清單填入群組，其中包含可用於所選服務和量度的中繼資料標籤。不過，「群組依據」(Group By) 欄位下拉式清單隨附一般系統標籤的預先定義清單。

使用者標籤無法預先定義，但您可以在 [分組依據] 欄位中手動輸入。如果「分組依據」區段中包含中繼資料標籤、使用者標籤或系統標籤，您可以根據該標籤建立篩選器，並在「別名」欄位中展開其值。

別名模式

「別名依據」欄位可讓您控制圖例鍵的格式。預設值是顯示量度名稱和標籤。這可能很長且難以閱讀。使用別名欄位中的下列模式，您可以依照您想要的方式格式化圖例索引鍵。

量度類型模式

別名模式 描述 示例結果
{{metric.type}} 傳回完整的「度量類型」。 compute.googleapis.com/instance/cpu/utilization
{{metric.name}} 返回度量名稱部分。 instance/cpu/utilization
{{metric.service}} 傳回服務零件。 compute

標籤模式

在「分組依據」下拉式清單中，您可以看到量度的量度和資源標籤清單。這些可以使用別名模式包含在圖例鍵中。

別名模式格式 描述 別名模式範例 示例結果
{{metric.label.xxx}} 傳回量度標籤值。 {{metric.label.instance_name}} grafana-1-prod
{{resource.label.xxx}} 返回資源標籤值。 {{resource.label.zone}} us-east1-b
{{metadata.system_labels.xxx}} 返回元數據系統標籤值。 {{metadata.system_labels.name}} grafana
{{metadata.user_labels.xxx}} 返回元數據用戶標籤值。 {{metadata.user_labels.tag}} production

範例別名依據：{{metric.type}} - {{metric.label.instance_name}}

示例結果：compute.googleapis.com/instance/cpu/usage_time - server1-prod

您也可以解析「受監控資源類型」的名稱。

別名模式格式 描述 示例結果
{{resource.type}} 傳回受監視資源類型的名稱。 gce_instance

範例別名依據：{{resource.type}} - {{metric.type}}

示例結果：gce_instance - compute.googleapis.com/instance/cpu/usage_time

SLO 查詢

注意

SLO 查詢僅適用於 Grafana v7.0 +

Google 雲端監控資料來源中的 SLO 查詢產生器可讓您以時間序列格式顯示 SLO 資料。若要瞭解服務監控的基本概念，請參閱 Google 雲端監控官方文件。

建立 SLO 查詢

若要建立 SLO 查詢，請依照下列步驟執行：

  1. 在「查詢型態」下拉式清單中，選擇「服務層次目標 (SLO)」選項。

  2. 從「專案」下拉式清單中選擇專案。

  3. 從「服務」下拉式清單中選擇 SLO 服務。

  4. 從 SLO 下拉式清單中選擇 SLO。

  5. 從選取器下拉式清單中選擇時間序列選取器。

時間序列選擇器的友好名稱顯示在 Grafana 中。下表顯示從易記名稱到「服務監視」文件中使用之系統名稱的對應。

選擇器下拉列表值 使用對應的時間序列選擇
SLI 值 選擇健康
SLO 法規遵循 選擇符合性
剩餘 SLO 錯誤預算 選擇 _ 槽 _ 預算 _ 分數

SLO 查詢的別名模式

您可以使用「別名依據」欄位來控制 SLO 查詢之圖例索引鍵的格式。

別名模式 描述 示例結果
{{project}} 傳回 GCP 專案名稱。 myProject
{{service}} 返回服務名稱。 myService
{{slo}} 傳回 SLO。 latency-slo
{{selector}} 返回選擇器。 select_slo_health

SLO 查詢的對齊週期和按時間分組

SLO 查詢使用與度量查詢相同的對齊週期功能。如需詳細資訊，請參閱 量度查詢。

模板

您可以在指標查詢中使用變量，而不是硬編碼（例如服務器，應用程序和傳感器名稱）的內容。變數會顯示為儀表板頂端的下拉式選取方塊。您可以使用這些下拉式方塊來變更顯示在儀表板中的資料。

如需範本變數和範本變數的詳細資訊，請參閱〈〉模板和變量。

查詢變數

「查詢」類型的變數可讓您查詢各種資料類型的 Google 雲端監控。谷歌雲監控數據源插件提供以下內容Query Types。

名稱 描述
Metric Types 傳回指定服務可用的測量結果類型名稱清單。
Labels Keys 傳回指定量度resource label中metric label與的金鑰清單。
Labels Values 傳回指定量度中標籤的值清單。
Resource Types 傳回指定量度的資源類型清單。
Aggregations 傳回指定量度的彙總清單 (交叉系列縮減器)。
Aligners 傳回指定量度的對齊器清單 (每個系列對齊器)。
Alignment periods 傳回 Grafana 中 Google 雲端監控查詢編輯器中可用的所有對齊週期的清單。
Selectors 傳回可在 SLO (服務等級目標) 查詢中使用的選取器清單。
SLO Services 傳回可用於 SLO 查詢的服務監視服務清單。
Service Level Objectives (SLO) 傳回指定 SLO 服務的 SLO 清單。

在查詢中使用變數

有兩種語法：

  • $<varname> 範例: metric.label.$metric_label

  • [[varname]] 範例: metric.label.[[metric_label]]

為什麼有兩種方式？ 第一種語法更容易閱讀和寫入，但不允許您在單詞中間使用變量。啟用「多值」或「包含所有值」選項時，Grafana 會將標籤從純文字轉換為正則運算式相容字串，這表示您必須使用而不是。=~ =

註釋

您可以使用註釋在圖表上覆蓋豐富的事件信息。您可以透過「儀表板」功能表/「註釋」檢視來新增註釋 註釋渲染費用昂貴，因此限制返回的行數非常重要。目前尚不支援顯示 Google 雲端監控註解和事件，但可與 Google 雲端監控中的自訂指標搭配使用。

如需註釋的詳細資訊，請參閱註釋。

使用註釋的查詢編輯器，您可以選取量度和篩選器。「標題」和「文字」欄位支援範本，而且可以使用查詢傳回的資料。例如，「標題」欄位可能包含下列文字：

{{metric.type}} has value: {{metric.value}}

示例結果：monitoring.googleapis.com/uptime_check/http_status has this value: 502

註解查詢編輯器的模式

別名模式格式 描述 別名模式範例 示例結果
{{metric.value}} 公制/點的值。 {{metric.value}} 555
{{metric.type}} 傳回完整的「度量類型」。 {{metric.type}} compute.googleapis.com/instance/cpu/utilization
{{metric.name}} 返回度量名稱部分。 {{metric.name}} instance/cpu/utilization
{{metric.service}} 傳回服務零件。 {{metric.service}} compute
{{metric.label.xxx}} 傳回量度標籤值。 {{metric.label.instance_name}} grafana-1-prod
{{resource.label.xxx}} 返回資源標籤值。 {{resource.label.zone}} us-east1-b

從 Grafana 面板深層鏈接到谷歌雲控制台中的指標資源管理器

注意

此功能僅適用於量度查詢。

在面板中選擇時間序列，即可查看內容功能表，其中包含「在 GCP 主控台的指標總管中檢視」連結。選擇該連結會在 GCP 主控台中開啟指標資源管理器，並從該處的 Grafana 面板執行查詢。該鏈接將用戶首先導航到 Google 帳戶選擇器。成功選取帳戶後，會將使用者重新導向至「度量總管」。提供的連結對任何帳戶都有效，但只有在您的帳戶可存取查詢中指定的 GCP 專案時，才會顯示查詢。