AWS CLI を使う CloudWatch Logs の例 - AWS Command Line Interface

AWS CLI を使う CloudWatch Logs の例

次のコード例は、CloudWatch Logs で AWS Command Line Interface を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。

トピック

アクション

次のコード例は、create-log-group を使用する方法を示しています。

AWS CLI

次のコマンドは、my-logs という名前のロググループを作成します。

aws logs create-log-group --log-group-name my-logs
  • API の詳細については、AWS CLI コマンドリファレンスの「CreateLogGroup」を参照してください。

次のコード例は、create-log-stream を使用する方法を示しています。

AWS CLI

次のコマンドは、ロググループ my-logs20150601 という名前のログストリームを作成します。

aws logs create-log-stream --log-group-name my-logs --log-stream-name 20150601
  • API の詳細については、AWS CLI コマンドリファレンスの「CreateLogStream」を参照してください。

次のコード例は、delete-log-group を使用する方法を示しています。

AWS CLI

以下のコマンドは、my-logs という名前のロググループを削除します。

aws logs delete-log-group --log-group-name my-logs
  • API の詳細については、AWS CLI コマンドリファレンスの「DeleteLogGroup」を参照してください。

次の例は、delete-log-stream を使用する方法を説明しています。

AWS CLI

次のコマンドは、my-logs という名前のロググループから 20150531 という名前のログストリームを削除します。

aws logs delete-log-stream --log-group-name my-logs --log-stream-name 20150531
  • API の詳細については、「AWS CLI コマンドリファレンス」の「DeleteLogStream」を参照してください。

次の例は、delete-retention-policy を使用する方法を説明しています。

AWS CLI

次のコマンドは、my-logs という名前のロググループに以前に適用された保持ポリシーを削除します。

aws logs delete-retention-policy --log-group-name my-logs
  • API の詳細については、「AWS CLI コマンドリファレンス」の「DeleteRetentionPolicy」を参照してください。

次の例は、describe-log-groups を使用する方法を説明しています。

AWS CLI

次のコマンドは、my-logs という名前のロググループを記述します。

aws logs describe-log-groups --log-group-name-prefix my-logs

出力:

{ "logGroups": [ { "storedBytes": 0, "metricFilterCount": 0, "creationTime": 1433189500783, "logGroupName": "my-logs", "retentionInDays": 5, "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:*" } ] }
  • API の詳細については、AWS CLI コマンドリファレンスの「DescribeLogGroups」を参照してください。

次の例は、describe-log-streams を使用する方法を説明しています。

AWS CLI

次のコマンドは、ロググループ my-logs のプレフィックス 2015 で始まるすべてのログストリームを表示します。

aws logs describe-log-streams --log-group-name my-logs --log-stream-name-prefix 2015

出力:

{ "logStreams": [ { "creationTime": 1433189871774, "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150531", "logStreamName": "20150531", "storedBytes": 0 }, { "creationTime": 1433189873898, "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150601", "logStreamName": "20150601", "storedBytes": 0 } ] }
  • API の詳細については、「AWS CLI コマンドリファレンス」の「DescribeLogStreams」を参照してください。

次の例は、get-log-events を使用する方法を説明しています。

AWS CLI

次のコマンドは、ロググループ my-logs20150601 という名前のログストリームからログイベントを取得します。

aws logs get-log-events --log-group-name my-logs --log-stream-name 20150601

出力:

{ "nextForwardToken": "f/31961209122447488583055879464742346735121166569214640130", "events": [ { "ingestionTime": 1433190494190, "timestamp": 1433190184356, "message": "Example Event 1" }, { "ingestionTime": 1433190516679, "timestamp": 1433190184356, "message": "Example Event 1" }, { "ingestionTime": 1433190494190, "timestamp": 1433190184358, "message": "Example Event 2" } ], "nextBackwardToken": "b/31961209122358285602261756944988674324553373268216709120" }
  • API の詳細については、「AWS CLI コマンドリファレンス」の「GetLogEvents」を参照してください。

次の例は、put-log-events を使用する方法を説明しています。

AWS CLI

次のコマンドは、ロググループ my-logs20150601 という名前のログストリームにログイベントを配置します。

aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events

出力:

{ "nextSequenceToken": "49542672486831074009579604567656788214806863282469607346" }

上記の例では、現在のディレクトリにある events という名前のファイルからイベントの JSON 配列を読み取ります。

[ { "timestamp": 1433190184356, "message": "Example Event 1" }, { "timestamp": 1433190184358, "message": "Example Event 2" }, { "timestamp": 1433190184360, "message": "Example Event 3" } ]

以降の各呼び出しでは、前の呼び出しで提供された次のシーケンストークンをシーケンストークンオプションで指定する必要があります。

aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events2 --sequence-token "49542672486831074009579604567656788214806863282469607346"

出力:

{ "nextSequenceToken": "49542672486831074009579604567900991230369019956308219826" }
  • API の詳細については、「AWS CLI コマンドリファレンス」の「PutLogEvents」を参照してください。

次の例は、put-retention-policy を使用する方法を説明しています。

AWS CLI

次のコマンドは、my-logs という名前のロググループに 5 日間の保持ポリシーを追加します。

aws logs put-retention-policy --log-group-name my-logs --retention-in-days 5
  • API の詳細については、「AWS CLI コマンドリファレンス」の「PutRetentionPolicy」を参照してください。