Google Distributed Cloud (GDC) 實體隔離設備中的 MonitoringTarget 自訂資源可讓您為抓取的指標加上標籤,區分指標特徵及篩選時間序列資料。除了收集指標之外,您還可以設定重新標籤規則,將指標轉送至其他專案、新增自訂鍵/值標籤,或在擷取前重新命名指標。
每個不重複的鍵/值標籤組合都會建立新的時間序列,這可能會大幅增加資料儲存空間。請避免將標籤用於具有多個可能值的高基數維度,例如使用者 ID 或電子郵件地址。如要進一步瞭解指標重新標籤,請參閱「Prometheus 重新標籤的運作方式」。
事前準備
如要管理 MonitoringTarget 自訂資源,請向管理員要求必要權限。
必要的 IAM 角色
請與專案 IAM 管理員聯絡,要求下列角色:
- MonitoringTarget 建立者 (
monitoringtarget-creator):在專案命名空間中建立MonitoringTarget自訂資源。 - MonitoringTarget 編輯者 (
monitoringtarget-editor):編輯或修改專案命名空間中的MonitoringTarget自訂資源。 - MonitoringTarget 檢視者 (
monitoringtarget-viewer):查看專案命名空間中的MonitoringTarget自訂資源。
將指標傳送至其他專案
容器作者可以編寫程式碼,將特定指標傳送至其他專案,甚至是他們不擁有的專案。如要將指標傳送至特定專案,請在程式碼中為指標新增 _gdch_project 標籤,並將其值設為目的地專案名稱。
或者,您也可以使用 MonitoringTarget 自訂資源,將「所有」收集到的指標資料傳送至其他專案。在 metricsRelabelings 欄位中,將 _gdch_project 標籤設為目標標籤,並以新專案名稱做為替換值。
下列程式碼範例說明如何在 MonitoringTarget 自訂資源中設定 _gdch_project 目標標籤,將指標傳送至名為 another-project-name 的專案:
apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
# Choose the same namespace as the workload pods.
namespace: PROJECT_NAMESPACE
name: MONITORING_TARGET_NAME
spec:
[...]
podMetricsEndpoints:
[...]
metricsRelabelings:
- action: replace
targetLabel: _gdch_project
replacement: another-project-name
[...]
更改下列內容:
PROJECT_NAMESPACE:專案命名空間。MONITORING_TARGET_NAME:MonitoringTarget定義檔案的名稱。
為指標新增標籤
標籤可識別指標特徵,有助於觀測及監控。您可以新增標籤,標示經抓取的容器一開始未公開的資訊。在 MonitoringTarget 自訂資源中,將新標籤設為目標標籤,並提供替換值。這個鍵/值組合會新增至資源收集的所有指標。
下列程式碼範例說明如何設定 my_new_label 目標標籤,並在 MonitoringTarget 自訂資源中將其值設為 my_label_value:
apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
# Choose the same namespace as the workload pods.
namespace: PROJECT_NAMESPACE
name: MONITORING_TARGET_NAME
spec:
[...]
podMetricsEndpoints:
[...]
metricsRelabelings:
- action: replace
targetLabel: my_new_label
replacement: my_label_value
[...]
更改下列內容:
PROJECT_NAMESPACE:專案命名空間。MONITORING_TARGET_NAME:MonitoringTarget定義檔案的名稱。
重新命名指標
您可以使用 MonitoringTarget 資源重新命名容器的指標。在 metricsRelabelings 欄位中設定原始指標名稱和替代名稱。原始名稱會視為規則運算式 (regex),並由新名稱取代。
下列程式碼範例說明如何將 MonitoringTarget 自訂資源中的 cpu_usage 指標名稱 (規則運算式) 替換為 cpu_usage_new_name:
apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
# Choose the same namespace as the workload pods.
namespace: PROJECT_NAMESPACE
name: MONITORING_TARGET_NAME
spec:
[...]
podMetricsEndpoints:
[...]
metricsRelabelings:
- action: replace
regex: cpu_usage
replacement: cpu_usage_new_name
sourceLabels: [__name__]
targetLabel: __name__
[...]
更改下列內容:
PROJECT_NAMESPACE:專案命名空間。MONITORING_TARGET_NAME:MonitoringTarget定義檔案的名稱。