使用 StatsD 擷取自訂指標 - Amazon CloudWatch
檢視代理程式匯入的 CloudWatch StatsD 測量結果

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

使用 StatsD 擷取自訂指標

您可以使用 CloudWatch代理程式搭配StatsD通訊協定，從應用程式或服務擷取其他自訂指標。StatSD 是一種普遍的開放原始碼解決方案，可以從各種應用程式收集指標。StatSD 對於檢測您自己的指標特別有用。如需將 CloudWatch 代理程式和 StatsD 一起使用的範例，請參閱如何使用 Amazon 代理程式更好地監控自訂應用程 CloudWatch 式指標。

StatsD在 Linux 伺服器和執行視窗伺服器的伺服器上均受支援。 CloudWatch 支援以下StatsD格式：

MetricName:value|type|@sample_rate|#tag1:
  value,tag1...

  • MetricName – 字串，不含冒號、直線、# 字元或 @ 字元。

  • value – 這可以是整數或浮點數。

  • type – 指定 c (用於計數器)、g (用於測量儀)、ms (用於計時器)、h (用於長條圖) 或 s (用於 set)。

  • sample_rate – (選用) 介於 0 和 1 的浮點數，包含 0 和 1。僅適用於計數器、長條圖、計時器指標。預設值為 1 (抽樣 100% 的時間)。

  • tags— (選用) 以逗號分隔的標籤清單。 StatsD標籤與中的標註類似 CloudWatch。對鍵/值標籤使用冒號，例如 env:prod。

您可以使用任何遵循此格式的用StatsD戶端，將度量傳送至 CloudWatch 代理程式。如需有關某些可用用StatsD戶端的詳細資訊，請參閱中的 StatsD 用戶端頁面 GitHub。

若要收集這些自訂指標，請將 "statsd": {} 這一行新增到代理程式組態檔案的 metrics_collected 區段。您可以手動加入這一行。如果您使用精靈來建立組態檔案，它會替您完成這項作業。如需詳細資訊，請參閱建立 CloudWatch 代理程式組態檔。

StatsD 預設的組態可適用於大部分的使用者。有多個選用欄位，您可以視需要將其新增至代理程式組態檔的 statsd 區段：

  • service_address— CloudWatch 代理程式應監聽的服務位址。格式是 ip:port。如果您省略 IP 地址，代理程式會監聽所有可用介面。僅支持UDP格式，因此您不需要指定UDP前綴。

    預設值為 :8125。

  • metrics_collection_interval – StatsD 外掛程式執行和收集指標的頻率 (以秒為單位)。預設值為 10 秒。範圍介於 1 – 172,000 之間。

  • metrics_aggregation_interval— 將指標 CloudWatch彙總到單一資料點的頻率 (以秒為單位)。預設值為 60 秒。

    例如，如果metrics_collection_interval為 10 且metrics_aggregation_interval為 60，則每 10 秒 CloudWatch 收集一次資料。每分鐘之後，該分鐘的六個資料讀數會彙總成單一資料點，並傳送至該資料點 CloudWatch。

    範圍介於 0 – 172,000 之間。將 metrics_aggregation_interval 設為 0，會停止彙整 StatsD 指標。

  • allowed_pending_messages— 允許佇列的UDP訊息數目。當佇列已滿時，StatsD 伺服器會開始捨棄封包。預設值為 10000。

  • drop_original_metrics - 選用。如果您使用 metrics 區段中的 aggregation_dimensions 欄位，將指標彙總為彙總結果，則代理程式預設會同時傳送為每個維度值分開的彙總指標和原始指標。如果您不想將原始量度傳送至 CloudWatch，可以使用量度清單來指定此參數。與此參數一起指定的量度沒有依維度報告的量度 CloudWatch。而是只報告彙總指標。這樣可以減少代理程式收集的指標數量，降低您的成本。

以下範例是代理程式組態檔案的 statsd 區段，其中使用預設的連接埠和自訂收集以及彙總間隔。

{
   "metrics":{
      "metrics_collected":{
         "statsd":{
            "service_address":":8125",
            "metrics_collection_interval":60,
            "metrics_aggregation_interval":300
         }
      }
   }
}

檢視代理程式匯入的 CloudWatch StatsD 測量結果

將 StatsD 指標匯入後 CloudWatch，您可以將這些指標視為時間序列圖表，並建立警示以監視這些指標，並在超出您指定的閾值時通知您。下列程序顯示如何以時間序列圖形檢視 StatsD 指標。如需設定警示的詳細資訊，請參閱 使用 Amazon CloudWatch 警報。

若要在主 CloudWatch 控台中檢視 StatsD 指標

  1. 在開啟 CloudWatch 主控台https://console.aws.amazon.com/cloudwatch/。

  2. 在導覽窗格中，選擇 指標。

  3. 選擇用於代理程式所收集指標的命名空間。依預設，這是 CWAgent，但您可能在 CloudWatch 代理程式組態檔中指定了不同的命名空間。

  4. 選擇指標維度 (例如 Per-Instance Metrics (每個執行個體指標))。

  5. All metrics (所有指標) 索引標籤會顯示命名空間中該維度的所有指標。您可以執行下列作業：

    1. 若要將指標圖形化，請勾選指標旁的核取方塊。若要選擇所有指標，請勾選表格標題列中的核取方塊。

    2. 若要將資料表排序，請使用直欄標題。

    3. 若要依資源篩選，請選擇資源 ID，然後選擇 Add to search (新增至搜尋)。

    4. 若要依指標篩選，請選擇指標名稱，然後選擇 Add to search (新增至搜尋)。

  6. (選擇性) 若要將此圖形新增至 CloudWatch 儀表板，請選擇動作 > 新增至儀表板。