ログ内へのメトリクスの埋め込み
CloudWatch 埋め込みメトリクス形式を使用すると、CloudWatch Logs に書き込まれるログの形式でカスタムメトリクスを非同期的に生成できます。詳細なログイベントデータと一緒にカスタムメトリクスを埋め込むことができます。CloudWatch はカスタムメトリクスを自動的に抽出し、リアルタイムのインシデント検出のためにそれらを可視化して警告できるようにします。また、CloudWatch Logs Insights を使用して、抽出されたメトリクスに関連付けられた詳細なログイベントを照会し、運用イベントの根本原因に関する深い洞察を提供できます。
埋め込みメトリクスフォーマットは、Lambda 関数やコンテナなどの一時的なリソースから実用的なカスタムメトリクスを生成するのに役立ちます。埋め込みメトリックフォーマットを使用してこれらの一時的なリソースからログを送信することにより、ログデータの強力な分析機能を獲得しながら、個別のコードをインストルメント化または保守することなく、カスタムメトリックを簡単に作成できるようになりました。
埋め込みメトリクス形式を使用するために設定は必要ありません。埋め込みメトリクス形式の仕様に従ってログを構造化するか、クライアントライブラリを使用してログを生成し、PutLogEvents API または CloudWatch エージェントを使用して CloudWatch Logs に送信します。
ログの取り込みとアーカイブ、および生成されるカスタムメトリックには料金が発生します。詳細については、Amazon CloudWatch 料金表
注記
カスタムメトリックの使用状況と対応する請求に影響するため、メトリックの抽出を設定するときには注意が必要です。高カーディナリティディメンション(requestId
など)に基づいて意図せずにメトリックを作成すると、埋め込みメトリックフォーマットにより、各一意のディメンションの組み合わせに対応するカスタムメトリックが意図的に作成されます。詳細については、「ディメンション」を参照してください。
以下のトピックでは、埋め込みメトリクスフォーマットを使用してログを発行する方法、コンソールでメトリクスとログを表示する方法、埋め込みメトリクスフォーマットで作成されたメトリクスにアラームを設定する方法について説明します。