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

# 案例：將指標發布至 CloudWatch
<a name="PublishMetrics"></a>

在此案例中，您可以使用 AWS Command Line Interface (AWS CLI) 來發佈名為 *GetStarted* 之假設應用程式的單一指標。如果您尚未安裝並設定 AWS CLI，請參閱*AWS Command Line Interface 《 使用者指南*》中的[使用 進行設定 AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html)。

**Topics**
+ [

## 步驟 1：定義資料組態
](#define-data-domain)
+ [

## 步驟 2：將指標新增至 CloudWatch
](#add-metrics-to-scenario)
+ [

## 步驟 3：從 CloudWatch 獲得統計數字
](#GetStatistics)
+ [

## 步驟 4：使用主控台檢視圖形
](#ViewGraphs)

## 步驟 1：定義資料組態
<a name="define-data-domain"></a>

在此案例中，您發布資料點以追蹤應用程式的請求延遲。為指標和命名空間選擇符合您需求的名稱。在此範例中，將指標命名為 *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
<a name="add-metrics-to-scenario"></a>

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

**若要發布資料點至 CloudWatch**

1. 在命令提示字元中執行以下 [put-metric-data](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-data.html) 命令，以新增第一小時的資料。以過去兩小時的時間戳記取代範例時間戳記，以國際標準時間 (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
   ```

1. 使用第一個小時之後 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
   ```

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

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

## 步驟 3：從 CloudWatch 獲得統計數字
<a name="GetStatistics"></a>

現在您已將指標發布至 CloudWatch，您可以根據這些指標，如下所示使用 [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html) 命令來擷取統計資料。請務必指定過去夠久以前的 `--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：使用主控台檢視圖形
<a name="ViewGraphs"></a>

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

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

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

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

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

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

如需詳細資訊，請參閱[建立指標圖形](graph_metrics.md)。