# ログ内へのメトリクスの埋め込み
<a name="CloudWatch_Embedded_Metric_Format"></a>

CloudWatch 埋め込みメトリクス形式を使用すると、CloudWatch Logs に書き込まれるログの形式でカスタムメトリクスを非同期的に生成できます。詳細なログイベントデータと一緒にカスタムメトリクスを埋め込むことができます。CloudWatch はカスタムメトリクスを自動的に抽出し、リアルタイムのインシデント検出のためにそれらを可視化して警告できるようにします。また、CloudWatch Logs Insights を使用して、抽出されたメトリクスに関連付けられた詳細なログイベントを照会し、運用イベントの根本原因に関する深い洞察を提供できます。

埋め込みメトリクスフォーマットは、Lambda 関数やコンテナなどの一時的なリソースから実用的なカスタムメトリクスを生成するのに役立ちます。埋め込みメトリックフォーマットを使用してこれらの一時的なリソースからログを送信することにより、ログデータの強力な分析機能を獲得しながら、個別のコードをインストルメント化または保守することなく、カスタムメトリックを簡単に作成できるようになりました。

埋め込みメトリクス形式を使用するために設定は必要ありません。[埋め込みメトリクス形式の仕様](CloudWatch_Embedded_Metric_Format_Specification.md)に従ってログを構造化するか、クライアントライブラリを使用してログを生成し、[PutLogEvents API](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html) または [CloudWatch エージェント](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format_Generation_CloudWatch_Agent.html)を使用して CloudWatch Logs に送信します。

埋め込みメトリクス形式のログからメトリクスを生成するには、`logs:PutLogEvents` アクセス許可が必要ですが、`cloudwatch:PutMetricData` アクセス許可は必要ありません。

ログの取り込みとアーカイブ、および生成されるカスタムメトリックには料金が発生します。詳細については、[Amazon CloudWatch 料金表](https://aws.amazon.com/cloudwatch/pricing)をご覧ください。

**注記**  
カスタムメトリックの使用状況と対応する請求に影響するため、メトリックの抽出を設定するときには注意が必要です。高カーディナリティディメンション（`requestId` など）に基づいて意図せずにメトリックを作成すると、埋め込みメトリックフォーマットにより、各一意のディメンションの組み合わせに対応するカスタムメトリックが意図的に作成されます。詳細については、「[ディメンション](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)」を参照してください。

 以下のトピックでは、埋め込みメトリクスフォーマットを使用してログを発行する方法、コンソールでメトリクスとログを表示する方法、埋め込みメトリクスフォーマットで作成されたメトリクスにアラームを設定する方法について説明します。

**Topics**
+ [埋め込みメトリクス形式を使用したログの発行](CloudWatch_Embedded_Metric_Format_Generation.md)
+ [コンソールでのメトリクスおよびログの表示](CloudWatch_Embedded_Metric_Format_View.md)
+ [埋め込みメトリクス形式で作成されたメトリクスにアラームを設定する](CloudWatch_Embedded_Metric_Format_Alarms.md)