mon-get-stats - Amazon CloudWatch
描述語法選項常用選項輸出範例相關主題

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

mon-get-stats

描述

取得指定統計的時間序列資料。

注意

當您使用 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..."

指標的維度。您可以用兩種方式指定維度，而且格式可以合併或互換使用：

  • 每個維度一個選項：--dimensions "key1=value1" --dimensions "key2=value2"

  • 全部在一個選項中：--dimensions "key1=value1,key2=value2"

類型：映射

有效值：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 命名空間。

類型：字串

有效值：長度為 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

據以擷取指標的單位。指標可以用多個單位來報告，此參數會擷取指定指標的特定單位。不要求單位會導致傳回所有單位。如果指標總是只使用一個單位來報告，則此參數沒有效果。

類型：列舉

有效值：下列其中一個：

  • 秒鐘

  • 微秒

  • 毫秒

  • 位元組

  • KB

  • MB

  • GB

  • TB

  • 位元

  • 千位元數

  • 百萬位元數

  • 十億位元數

  • 兆位元數

  • 百分比

  • 計數

  • 位元組/秒

  • KB/秒

  • MB/秒

  • GB/秒

  • TB/秒

  • 位元/秒

  • 千位元數/秒

  • 百萬位元數/秒

  • 十億位元數/秒

  • 兆位元數/秒

  • 計數/秒

  • 無

預設：無

必要：否

常用選項

名稱 描述

--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 或 AWS Identity and Access Management提供的 PEM 檔案的有效檔案路徑。

預設：使用環境變數 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 來指定該值。該區域用於建立用於呼叫的 URL CloudWatch，且必須是有效的 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。您可以使用環境變數 AWS_CLOUDWATCH_URL 來設定這個值。這個值可與 --region 搭配使用，以建立預期的 URL。此選項會覆寫用於服務呼叫的 URL。

類型：字串

有效值：有效的 HTTP 或 HTTPS URL。

預設：使用 AWS_CLOUDWATCH_URL 中指定的值 (如果設定)。

輸出

此命令會傳回一個表格，其中包含下列項目：

  • Time - 取得指標的時間。

  • SampleCount -此欄沒有可用的說明。

  • Average - 平均值。

  • Sum - 值的總和。

  • Minimum - 最小觀察值。

  • Maximum - 最大觀察值。

  • Unit - 指標的單位。

Amazon CloudWatch CLI 在標準錯誤上顯示錯誤。

範例

範例請求

此範例以 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"

相關主題

下載

相關動作

相關命令