使用自訂指標

本指南說明如何建立及使用自訂指標,相關資訊分成下列部分:

  • 使用 OpenCensus 的自訂指標一文說明如何使用 OpenCensus (監控和追蹤程式庫的開放原始碼) 建立自訂指標、為其新增指標資料,以及將指標匯出至 Stackdriver Monitoring。

    將指標從 OpenCensus 匯出至 Stackdriver Monitoring 之後,Monitoring 即會將這些指標視為任何其他自訂指標。

  • 建立自訂指標一文說明如何使用 Stackdriver Monitoring API 建立自訂指標,以及如何將時間序列資料新增至這些指標。

    我們會使用 API Explorer、C#、Go、Java、Node.js、PHP、Python 和 Ruby 程式設計語言的範例來說明 Monitoring API。

下列資訊同時適用於自訂指標以及 Stackdriver Monitoring 提供的指標:

  • 瀏覽指標一文說明如何列出及檢查您的自訂指標以及超過 900 個內建指標。
  • 讀取指標說明如何使用 Monitoring API,從自訂與內建指標擷取時間序列資料。您也可以在圖表與快訊中使用指標資料。

所有這些指標的作業都需要使用 Stackdriver Monitoring API v3。如需參考說明文件,請參閱 Stackdriver Monitoring API 簡介

如需 Stackdriver Monitoring 指標基礎概念的討論,請參閱指標、時間序列和資源一文。

事前準備

自訂指標是 Stackdriver Monitoring 的一項計費功能,因此您的自訂指標可能需要付費。如要進一步瞭解定價資訊,請參閱 Stackdriver 定價一文。

自訂指標屬於身為工作區成員的 Google Cloud Platform 專案。即使您只是要瀏覽內建指標,您仍然需要可以工作的專案:

  1. 建立或選取您要存取監控資料的 Google Cloud Platform 主控台專案。在本指南中,專案的 ID 稱為 {your-project-id}
  2. 為 Monitoring 啟用您的專案

如果要根據 GCP 專案中的 Stackdriver 記錄設定指標,請使用記錄指標

關於自訂指標

自訂指標與 Monitoring 的內建指標相同,但以下情況除外:

  • 您可在 GCP 專案內建立自訂指標。
  • 自訂指標名稱通常會以 custom.googleapis.com/ 開頭,這與內建指標不同。
  • 您可將時間序列資料寫入您的自訂指標。
  • 您可以刪除自訂指標。

如需瞭解內建指標的詳細資料,請參閱指標清單

下表顯示 Monitoring API 中可與自訂指標和內建指標搭配使用的方法:

Monitoring API 方法 與自訂指標
搭配使用
與內建指標
搭配使用
monitoredResourceDescriptors.get 是的 是的
monitoredResourceDescriptors.list 是的 是的
metricDescriptors.get 是的 是的
metricDescriptors.list 是的 是的
timeSeries.list 是的 是的
timeSeries.create 是的
metricDescriptors.create 是的
metricDescriptors.delete 是的

限制與延遲時間

如需瞭解自訂指標的數量以及有效時間序列數量的限制以及資料保留期限,請參閱配額與限制一文。如果您想在保留期限以外仍繼續保留您的指標資料,您必須將資料手動複製到其他位置,例如 Cloud Storage 或 BigQuery。

如要瞭解與寫入資料至自訂指標相關聯的延遲時間,請參閱指標資料的延遲時間一節。

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Stackdriver Monitoring
需要協助嗎?請前往我們的支援網頁