本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
mon-put-data
描述
將指標資料點新增到指定的指標。此呼叫會針對特定指標名稱的原始值或有效統計值，放置時間序列資料。它支援一次輸入單一資料點。
注意
當您使用 mon-put-data 命令建立新指標時，最多可能需要經過兩分鐘，您才可以使用 mon-get-stats 命令擷取新指標的統計資料。不過，可能需要長達 15 個分鐘，新的指標才會顯示在使用 mon-list-metrics 命令所擷取的指標清單中。
語法
mon-put-data --metric-name
value[--namespace value
[--dimensions
"key1=value1,key2=value2..."]
[--statisticValues
"key1=value1,key2=value2..."]
[--timestamp value] [--unit value]
[--value value] [Common Options]
選項
| 名稱 | 描述 |
|---|---|
|
-d, --dimensions "key1=value1,key2=value2..." |
唯一識別指標資料的維度。您可以用兩種方式指定維度，而且格式可以合併或互換使用：
類型：映射 有效值：name=value 格式的字串，其中 key 是維度的名稱，value 是維度的值。維度名稱和值必須是長度為 1 到 250 個字元的 ANSI 字串。最多允許 10 個維度。 預設：無 必要：否 |
|
|
指標的名稱 類型：字串 有效值：1 到 250 個字元的任何有效指標名稱。 預設：無 必要：是 |
|
|
指標的命名空間。如需命名空間的詳細資訊，請參閱AWS 命名空間。 類型：字串 有效值：長度為 1 到 250 個字元的 ANSI 字串。 預設：無 必要：是 |
|
|
針對指定的時間戳記和指標而存放的統計資料。此選項與 類型：映射 有效值：適用於所有統計名稱而包含所有 double 值的字串：SampleCount、Sum、Maximum 和 Minimum。所有這些值必須是 1E-130 和 1E130 之間的值。 預設：無 必要：是 |
|
|
指標要記錄的資料點或觀察的時間戳記。時間戳記是使用 ISO8601 合併格式來指定。例如，2013 年 7 月 30 日 12:30:00 PST 的日期和時間是以 2013-07-30T12:30:00-07:00 或 UTC: 2013-07-30T19:30:00Z 表示。 類型：簡易 有效值：以 ISO8601 格式表示的有效時間戳記 (含時區位移)，或 UTC 指標。 預設：當前 UTC 時間。 必要：否 |
|
|
指標的單位。 類型：列舉 有效值：下列其中一個：
預設：無 必要：否 |
|
|
要記錄的單一值。值會轉換成一組統計形式：SampleCount=1、Sum=VALUE、Minimum=VALUE、Maximum=VALUE。此選項與 類型：簡易 有效值：所有值必須是 1E-130 和 1E130 之間的數字。 預設：無 必要：是 |
常用選項
| 名稱 | 描述 |
|---|---|
|
|
檔案與登入 AWS 資料的位置。您可以使用環境變數 類型：字串 有效值：檔案的有效路徑，包含存取金鑰 ID 和私密存取金鑰。 預設：使用環境變數 |
|
|
用於簽署請求的 EC2 憑證檔案位置。您可使用環境變數 類型：字串 有效值：Amazon EC2 或 所提供 PEM 檔案的有效檔案路徑 AWS Identity and Access Management。 預設：使用環境變數 |
|
|
連線逾時值 (以秒為單位)。 類型：整數 有效值：任何正數。 預設：30 |
|
|
顯示分隔符號 (長) 結果時使用的分隔符號。 類型：字串 有效值：任何字串。 預設：逗號 (,) |
|
|
如果您要顯示表格式或分隔式結果，請包含欄標題。如果顯示 XML 結果，請從服務請求傳回 HTTP 標題 (如適用）。 類型：標記 有效值：如果存在，則顯示標題。 預設： |
|
|
將用於簽署請求的存取金鑰 ID，與私密金鑰搭配使用。此參數必須與私密金鑰搭配使用，否則會忽略該選項。所有對 CloudWatch 的請求都必須經過簽署，否則會拒絕該請求。 類型：字串 有效值：有效的存取金鑰 ID。 預設：無 |
|
|
將用於簽署請求的私有金鑰。使用公有/私有金鑰會導致 CLI 使用 SOAP。使用公有憑證和私有金鑰簽署請求。此參數必須與 類型：字串 有效值：有效 ASN.1 私有金鑰的路徑。 預設：無 |
|
|
該區域請求被導向。您可使用環境變數 類型：字串 有效值：任何 AWS 區域，例如 us-east-1。 預設：us-east-1，除非設定了 |
|
|
將用於簽署請求的私密存取金鑰，與存取金鑰 ID 搭配使用。此參數必須與 類型：字串 有效值：您的存取金鑰 ID。 預設：無 |
|
|
使用 (nil) 作為預留位置顯示空欄位，表示未請求此資料。 類型：標記 有效值：無 預設：預設不會顯示空欄位。 |
|
|
顯示 CLI 用來呼叫 AWS的 URL。 類型：標記 有效值：無 預設：false |
|
|
指定結果的顯示方式：在表格中、分隔符號 (長)、XML 或無輸出 (靜音)。 類型：標記 有效值：無 預設： |
|
|
用於聯絡 CloudWatch 的 URL。您可以使用環境變數 類型：字串 有效值：有效的 HTTP 或 HTTPS URL。 預設：使用 |
輸出
此命令會將指標資料點新增到指標。
Amazon CloudWatch CLI 會在 stderr 上顯示錯誤。
範例
範例請求
此範例將 RequestCount 的統計資料放在 MyService 命名空間。指標不含維度，因此代表整個服務的整體 RequestCount。度量是預先彙總的 statisticValue，代表 5 個稍早的度量，其最大值為 70、最小值為 30、總和為 250。
mon-put-data --metric-name RequestCount --namespace "MyService" --timestamp 2013-11-25T00:00:00.000Z --statisticValues "Sum=250,Minimum=30,Maximum=70,SampleCount=5"
範例請求
此範例將使用者特有的 RequestCount 測試資料放在 MyService 命名空間。使用者和堆疊名稱儲存為維度，以便區分這個指標與上述範例中的整體服務指標。
mon-put-data --metric-name RequestCount --namespace "MyService" --dimensions "User=SomeUser,Stack=Test" --timestamp 2013-11-25T00:00:00.000Z --value 50
相關主題
下載
相關動作
相關命令
