案例：將指標發佈至 CloudWatch - Amazon CloudWatch
步驟 1：定義資料組態步驟 2：將指標新增至 CloudWatch步驟 3：從 CloudWatch 獲得統計數字步驟 4：使用主控台檢視圖形

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

案例：將指標發佈至 CloudWatch

在此案例中，您可以使用 AWS Command Line Interface (AWS CLI) 來發佈名為 GetStarted 之假設應用程式的單一指標。如果您尚未安裝並設定 AWS CLI，請參閱AWS Command Line Interface 《 使用者指南》中的使用 進行設定 AWS Command Line Interface。

步驟 1：定義資料組態

在此案例中，您發佈資料點以追蹤應用程式的請求延遲。為指標和命名空間選擇符合您需求的名稱。在此範例中，將指標命名為 RequestLatency，並將所有資料點放入 GetStarted 命名空間。

您發佈數個資料點，共同代表三個小時的延遲資料。原始資料包含分散於三小時內的 15 個請求延遲讀數。每個讀取皆以毫秒為單位：

  • 第一小時：87、51、125、235

  • 第二小時：121、113、189、65、89

  • 第三小時：100、47、133、98、100、328

您可以將資料發佈給 CloudWatch，做為單一資料點或稱為統計資料集的彙總資料點集合。您可以將指標最短彙總為一分鐘的精細程度。您可以將彙總的資料點發佈到 CloudWatch，做為一組有四個預先定義金鑰的統計資料：Sum、Minimum、Maximum 和 SampleCount。

您將第一小時的資料點發佈為單一資料點。對於第二小時至第三小時的資料，您每小時彙總資料點並發佈一組統計。金鑰值如下表所示。

小時 原始資料 總和 下限 最大 SampleCount

1

87

1

51

1

125

1

235

2

121, 113, 189, 65, 89

577

65

189

5

3

100, 47, 133, 98, 100, 328

806

47

328

6

步驟 2：將指標新增至 CloudWatch

在您定義資料組態之後，就可以新增資料。

若要發佈資料點至 CloudWatch

  1. 在命令提示字元中執行以下 put-metric-data 命令，以新增第一小時的資料。以過去兩小時的時間戳記取代範例時間戳記，以國際標準時間 (UTC) 為準。

    aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--timestamp 2016-10-14T20:30:00Z --value 87 --unit Milliseconds
aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--timestamp 2016-10-14T20:30:00Z --value 51 --unit Milliseconds
aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--timestamp 2016-10-14T20:30:00Z --value 125 --unit Milliseconds
aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--timestamp 2016-10-14T20:30:00Z --value 235 --unit Milliseconds

  2. 使用第一個小時之後 1 小時的時間戳記，新增第二個小時的資料。

    aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--timestamp 2016-10-14T21:30:00Z --statistic-values Sum=577,Minimum=65,Maximum=189,SampleCount=5 --unit Milliseconds

  3. 新增第三個小時的資料，省略時間戳記以預設為目前時間。

    aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--statistic-values Sum=806,Minimum=47,Maximum=328,SampleCount=6 --unit Milliseconds

步驟 3：從 CloudWatch 獲得統計數字

現在您已將指標發佈至 CloudWatch，您可以根據這些指標，如下所示使用 get-metric-statistics 命令來擷取統計資料。請務必指定過去夠久以前的 --start-time 和 --end-time，以涵蓋您所發佈的最早時間戳記。

aws cloudwatch get-metric-statistics --namespace GetStarted --metric-name RequestLatency --statistics Average \
--start-time 2016-10-14T00:00:00Z --end-time 2016-10-15T00:00:00Z --period 60

下列為範例輸出：

{
	"Datapoints": [],
	"Label": "Request:Latency"
}

步驟 4：使用主控台檢視圖形

在您將指標發佈至 CloudWatch 之後，就可以使用 CloudWatch 主控台檢視統計圖形。

在主控台檢視您的統計數字圖形

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

  2. 在 Navigation (導覽) 窗格中，選擇 Metrics (指標)。

  3. 在 All metrics (所有指標) 標籤的搜尋方塊中，輸入 RequestLatency，然後按 Enter 鍵。

  4. 選取 RequestLatency 指標的核取方塊。上方窗格將顯示指標資料的圖形。

如需詳細資訊，請參閱建立指標圖形。