mon-put-data - Amazon CloudWatch
説明構文オプション一般的なオプション出力例関連トピック

mon-put-data

説明

指定したメトリクスにメトリクスデータポイントを追加します。この呼び出しにより、生値または特定のメトリクス名の有効な統計値のデータが時系列で示されます。一度に一つのデータポイントの入力に対応しています。

注記

mon-put-data コマンドで新しいメトリクスを作成した場合、mon-get-stats コマンドを用いてその新規メトリクスの統計を取得できるようになるまで最大 2 分かかります。ただし、mon-list-metrics コマンドを用いて取得したメトリクスのリストに新規メトリクスが表示されるまで最大 15 分かかることがあります。

構文

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..."

メトリクスデータを一意に識別するディメンション。ディメンションは 2 つの方法で指定でき、形式を組み合わせて、あるいは互換的に使用することができます。

  • 1 ディメンションに 1 つのオプションの場合: --dimensions "key1=value1" --dimensions "key2=value2"

  • 1 つのオプションにまとめた場合: --dimensions "key1=value1,key2=value2"

型: マップ

有効値: name=value 形式の文字列。ここで、key はディメンション名、value はディメンションの値です。ディメンション名と値は、文字長が 1 から 250 の ANSI 文字列である必要があります。最大 10 ディメンションが許可されています。

デフォルト: N/A

必須: いいえ

-m, --metric-name VALUE1,VALUE2,VALUE3...

メトリクスの名前。

タイプ: 文字列

有効値: 1 から 250 文字の有効なメトリクス名

デフォルト: N/A

必須 : はい

n, --namespace VALUE

メトリクスの名前空間。名前空間の詳細については、「AWS の名前空間」を参照してください。

タイプ: 文字列

有効値: 文字長が 1 から 250 の ANSI 文字列

デフォルト: N/A

必須 : はい

-s, --statistic Values "key1=value1,key2=value2..."

指定したタイムスタンプとメトリクスに関して保存する統計。このオプションでは --value しか使用できません。少なくとも --statisticValue または --value のいずれか指定する必要があります。

型: マップ

有効値: すべての統計名 (SampleCount、Sum、Maximum、Minimum) のすべての倍精度浮動小数点数が含まれる文字列。これらの値はすべて、1E-130 から 1E130 の間の値である必要があります。

デフォルト: N/A

必須 : はい

-t, --timestamp VALUE

メトリクスで記録するデータポイントまたは監視のタイムスタンプ。タイムスタンプは、ISO8601 複合形式を使用して指定します。たとえば、日時が 2013 年 7 月 30 日 12:30:00 (PST) の場合、2013-07-30T12:30:00-07:00、または UTC で 2013-07-30T19:30:00Z と表記されます。

タイプ: シンプル

有効値: タイムゾーンオフセットまたは UTC 表示による、ISO8601 形式で表記された有効なタイムスタンプ

デフォルト: 現在の UTC 時間

必須: いいえ

-u, --unit VALUE

メトリクスの単位。

タイプ: 列挙法

有効な値: 以下のいずれかです。

  • Seconds

  • Microseconds

  • Milliseconds

  • バイト

  • Kilobytes

  • Megabytes

  • Gigabytes

  • Terabytes

  • Bits

  • Kilobits

  • Megabits

  • Gigabits

  • Terabits

  • 割合 (%)

  • カウント

  • Bytes/Second

  • Kilobytes/Second

  • Megabytes/Second

  • Gigabytes/Second

  • Terabytes/Second

  • Bits/Second

  • Kilobits/Second

  • Megabits/Second

  • Gigabits/Second

  • Terabits/Second

  • Count/Second

  • なし

デフォルト: N/A

必須: いいえ

-v, --value VALUE

記録する単一の値。値は、SampleCount=1、Sum=VALUE、Minimum=VALUE、Maximum=VALUE という形式の統計セットに変換されます。このオプションには --statisticValues は含まれません。

タイプ: シンプル

有効値: すべての値は、1E-130 から 1E130 の間の数値である必要があります。

デフォルト: N/A

必須 : はい

一般的なオプション

名前 説明

--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。これは、––secret-key と組み合わせて使用する必要があります。単独で使用すると、このオプションは無視されます。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)

デフォルト: 環境変数 EC2_REGION が設定されている場合を除き、us-east-1

S, --secret-key VALUE

リクエストの署名で、アクセスキー ID と組み合わせて使用するシークレットアクセスキー。このパラメータは、--access-key-id と組み合わせて使用する必要があります。単独で使用すると、このオプションは無視されます。

タイプ: 文字列

有効な値: アクセスキー ID

デフォルト: なし

--show-empty-fields

プレースホルダーとして (nil) を使用して空のフィールドを表示し、このデータがリクエストされなかったことを示します。

タイプ: フラグ

有効な値: なし

デフォルト: デフォルトでは、空のフィールドは表示されません。

--show-request

CLI が の呼び出しに使用する URL を表示しますAWS

タイプ: フラグ

有効な値: なし

デフォルト: 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 を使用して、この値を設定できます。この値は有効な URL を作成するために --region と組み合わせて使用されます。このオプションは、サービス呼び出しの URL をオーバーライドします。

タイプ: 文字列

有効な値:有効な HTTP または HTTPS URL。

デフォルト: 設定されている場合は、AWS_CLOUDWATCH_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

関連トピック

ダウンロード

関連アクション

関連コマンド