# 在日志中嵌入指标
<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)