本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# mon-get-stats
## Description
取得指定統計的時間序列資料。
**注意**
當您使用 `mon-put-data` 命令建立新指標時，最多可能需要經過兩分鐘，您才可以使用 `mon-get-stats` 命令擷取新指標的統計資料。不過，可能需要長達 15 個分鐘，新的指標才會顯示在使用 `mon-list-metrics` 命令所擷取的指標清單中。
## 語法
****mon-get-stats** MetricName --namespace {{value}} --statistics {{value}}[,{{value}}...] [--dimensions "key1={{value1}},key2={{value2}}..." ] [--end-time {{value}}] [--period {{value}}] [--start-time {{value}}] [--unit {{value}}] [Common Options] **
## 選項
| 名稱 | 描述 |
| --- | --- |
| `MetricName` | 指標的名稱 您也可以使用 `--metric-name` 設定此值。
類型：引數
有效值：1 到 255 個字元的任何有效指標名稱。
預設：無
必要：是 |
| `--dimensions` `"key1=value1,key2=value2..." ` | 指標的維度。您可以用兩種方式指定維度，而且格式可以合併或互換使用：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/AmazonCloudWatch/latest/cli/cli-mon-get-stats.html)
類型：映射
有效值：name=value 格式的字串，其中 key 是維度的名稱，value 是維度的值。維度名稱和值必須是長度為 1 到 250 個字元的 ANSI 字串。最多允許 10 個維度。
預設：無
必要：否 |
| `--end-time` `VALUE` | 傳回的資料點允許的最晚時間戳記。結束時間不包括在內。時間戳記是使用 ISO8601 合併格式來指定。例如，2013 年 7 月 30 日 12:30:00 PST 的日期和時間是以 2013-07-30T12:30:00-07:00 或 UTC: 2013-07-30T19:30:00Z 表示。由 CloudWatch 傳回的最高解析是 1 分鐘，因此，所有時間戳記會無條件捨去到最接近的分鐘。
類型：引數
有效值：以 ISO8601 格式表示的有效時間戳記 (含時區位移)，或 UTC 指標。
預設：當前日期/時間。
必要：否 |
| `-n, --namespace` `VALUE` | 指標的命名空間。如需命名空間的詳細資訊，請參閱[AWS 命名空間](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/aws-namespaces.html)。
類型：字串
有效值：長度為 1 到 250 個字元的有效命名空間。
預設：無
必要：是 |
| `--period` `VALUE` | 據以擷取統計資料的精細程度 (以秒為單位)。期間至少必須為 60 秒且為 60 的倍數。
類型：引數
有效值：60 秒的倍數 (以秒為單位)。
預設：60 秒。
必要：否 |
| `-s, --statistics` `VALUE1,VALUE2,VALUE3...` | 針對指定的指標傳回的統計資料。
類型：列舉
有效值：Average、Sum、Maximum 或 Minimum
預設：無
必要：是 |
| `--start-time` `VALUE` | 傳回的資料點允許的最早時間戳記。開始時間包括在內。時間戳記是使用 ISO8601 合併格式來指定。例如，2013 年 7 月 30 日 12:30:00 PST 的日期和時間是以 2013-07-30T12:30:00-07:00 或 UTC: 2013-07-30T19:30:00Z 表示。由 CloudWatch 傳回的最高解析是 1 分鐘，因此，所有時間戳記會無條件捨去到最接近的分鐘。
類型：引數
有效值：以 ISO8601 格式表示的有效時間戳記 (含時區位移)，或 UTC 指標。
預設：目前時間的前一小時。
必要：否 |
| `--unit` `VALUE` | 據以擷取指標的單位。指標可以用多個單位來報告，此參數會擷取指定指標的特定單位。不要求單位會導致傳回所有單位。如果指標總是只使用一個單位來報告，則此參數沒有效果。
類型：列舉
有效值：下列其中一個：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/AmazonCloudWatch/latest/cli/cli-mon-get-stats.html)
預設：無
必要：否 |
## 常用選項
| 名稱 | 描述 |
| --- | --- |
| `--aws-credential-file` `VALUE` | 檔案與 AWS 登入資料的位置。您可以使用環境變數 `AWS_CREDENTIAL_FILE` 來設定這個值。如果您定義環境變數或提供憑證檔案的路徑，則檔案必須存在或請求失敗。所有 CloudWatch 請求必須使用存取金鑰 ID 和私密存取金鑰簽署。
類型：字串
有效值：檔案的有效路徑，包含存取金鑰 ID 和私密存取金鑰。
預設：使用環境變數 `AWS_CREDENTIAL_FILE` (如果設定)。 |
| `-C, --ec2-cert-file-path` `VALUE` | 用於簽署請求的 EC2 憑證檔案位置。您可使用環境變數 `EC2_CERT` 來指定這個值。
類型：字串
有效值：Amazon EC2 或 所提供 PEM 檔案的有效檔案路徑 AWS Identity and Access Management。
預設：使用環境變數 `EC2_CERT` (如果設定)。 |
| `--connection-timeout` `VALUE` | 連線逾時值 (以秒為單位)。
類型：整數
有效值：任何正數。
預設：30 |
| `--delimiter` `VALUE` | 顯示分隔符號 (長) 結果時使用的分隔符號。
類型：字串
有效值：任何字串。
預設：逗號 (,) |
| `--headers` `` | 如果您要顯示表格式或分隔式結果，請包含欄標題。如果顯示 XML 結果，請從服務請求傳回 HTTP 標題 (如適用）。
類型：標記
有效值：如果存在，則顯示標題。
預設：`--headers` 選項預設為關閉。 |
| `-I, --access-key-id` `VALUE` | 將用於簽署請求的存取金鑰 ID，與私密金鑰搭配使用。此參數必須與私密金鑰搭配使用，否則會忽略該選項。所有對 CloudWatch 的請求都必須經過簽署，否則會拒絕該請求。
類型：字串
有效值：有效的存取金鑰 ID。
預設：無 |
| `-K, --ec2-private-key-file-path` `VALUE` | 將用於簽署請求的私有金鑰。使用公有/私有金鑰會導致 CLI 使用 SOAP。使用公有憑證和私有金鑰簽署請求。此參數必須與 `EC2_CERT` 搭配使用，否則會忽略該值。如果已設定環境變數的值 `EC2_PRIVATE_KEY` 且未指定此選項，則將使用該值。如果環境變數，則會忽略此選項。`AWS_CREDENTIAL_FILE`已設定，或`--aws-credentials-file`被使用。所有對 CloudWatch 的請求都必須經過簽署，否則會拒絕該請求。
類型：字串
有效值：有效 ASN.1 私有金鑰的路徑。
預設：無 |
| `--region` `VALUE` | 該區域請求被導向。您可使用環境變數 `EC2_REGION` 來指定該值。該區域可用於建立用來呼叫 CloudWatch 的 URL，並且必須是有效的 Amazon Web Services (AWS) 區域。
類型：字串
有效值：任何 AWS 區域，例如 us-east-1。
預設：us-east-1，除非設定了 `EC2_REGION` 環境變數。 |
| `S, --secret-key` `VALUE` | 將用於簽署請求的私密存取金鑰，與存取金鑰 ID 搭配使用。此參數必須與 `--access-key-id` 搭配使用，否則會忽略該選項。
類型：字串
有效值：您的存取金鑰 ID。
預設：無 |
| `--show-empty-fields` `` | 使用 (nil) 作為預留位置顯示空欄位，表示未請求此資料。
類型：標記
有效值：無
預設：預設不會顯示空欄位。 |
| `--show-request` `` | 顯示 CLI 用來呼叫 AWS的 URL。
類型：標記
有效值：無
預設：false |
| `--show-table, --show-long, --show-xml, --quiet` `` | 指定結果的顯示方式：在表格中、分隔符號 (長)、XML 或無輸出 (靜音)。`--show-table` 顯示以固定欄寬形式顯示資料子集；`--show-long` 顯示以字元分隔的所有傳回的值；`--show-xml` 是從服務傳回的原始值；和 `--quiet` 會抑制所有標準輸出。所有選項是互斥的，且具有優先順序 `--show-table`、`--show-long`、`--show-xml` 及 `--quiet`。
類型：標記
有效值：無
預設：`--show-table` |
| `-U, --url` `VALUE` | 用於聯絡 CloudWatch 的 URL。您可以使用環境變數 `AWS_CLOUDWATCH_URL` 來設定這個值。這個值可與 `--region` 搭配使用，以建立預期的 URL。此選項會覆寫用於服務呼叫的 URL。
類型：字串
有效值：有效的 HTTP 或 HTTPS URL。
預設：使用 `AWS_CLOUDWATCH_URL` 中指定的值 (如果設定)。 |
## Output
此命令會傳回一個表格，其中包含下列項目：
+ Time - 取得指標的時間。
+ SampleCount - 此欄沒有描述。
+ Average - 平均值。
+ Sum - 值的總和。
+ Minimum - 最小觀察值。
+ Maximum - 最大觀察值。
+ Unit - 指標的單位。
Amazon CloudWatch CLI 會在 stderr 上顯示錯誤。
## 範例
### 範例請求
此範例以 1 小時解析度傳回 EC2 執行個體 i-c07704a9 的平均、最小、最大 CPU 使用率。
```
mon-get-stats CPUUtilization --start-time 2013-02-14T23:00:00.000Z --end-time 2013-03-14T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "AWS/EC2" --dimensions "InstanceId=i-c07704a9"
```
這是 Samples 和 Average 指標一分鐘解析度的輸出範例。
```
Time Samples Average Unit
2013-05-19 00:03:00 2.0 0.19 Percent
2013-05-19 00:04:00 2.0 0 Percent
2013-05-19 00:05:00 2.0 0 Percent
2013-05-19 00:06:00 2.0 0 Percent
2013-05-19 00:07:00 2.0 0 Percent
2013-05-19 00:08:00 2.0 0 Percent
2013-05-19 00:09:00 2.0 0 Percent
2013-05-19 00:10:00 2.0 0 Percent
2013-05-19 00:11:00 2.0 0 Percent
2013-05-19 00:12:00 2.0 0.195 Percent
2013-05-19 00:13:00 2.0 0.215 Percent
...
```
### 範例請求
此範例傳回整個 EC2 機群的 CPU 使用率。
```
mon-get-stats CPUUtilization --start-time 2013-02-14T23:00:00.000Z --end-time 2013-03-14T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "AWS/EC2"
```
### 範例請求
此範例以 1 小時解析度傳回針對特定使用者的 MyService 測試堆疊而提出的平均、最小、最大請求計數。
```
mon-get-stats RequestCount --start-time 2013-11-24T23:00:00.000Z --end-time 2013-11-25T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "MyService" --dimensions "User=SomeUser,Stack=Test"
```
### 範例請求
此範例顯示整個 "MyService" 的 RequestCount 統計資料。
```
mon-get-stats RequestCount --start-time 2013-11-24T23:00:00.000Z --end-time 2013-11-25T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum,SampleCount" --namespace "MyService"
```
## 相關主題
### 下載
+ [設定命令列介面](SetupCLI.md)
### 相關動作
+ [GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)
### 相關命令
+ [mon-list-metrics](cli-mon-list-metrics.md)
+ [mon-describe-alarms](cli-mon-describe-alarms.md)