View a markdown version of this page

需要额外权限 [V2] 的日志记录 - Amazon CloudWatch 日志
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

需要额外权限 [V2] 的日志记录

一些 Amazon 服务使用新的方法来发送日志。这是一种灵活的方法,可让您设置从这些服务到以下一个或多个目标的日志传输: CloudWatch 日志、Amazon S3 或 Firehose 以及 X-Ray 用于跟踪传输。

工作日志传输由三个元素组成:

  • DeliverySource,这是代表实际发送日志的资源的逻辑对象。

  • DeliveryDestination,这是代表实际传输目标的逻辑对象。

  • Delivery,这连接传输源与传输目标

要在支持的 Amazon 服务和目标之间配置日志传输,必须执行以下操作:

  • 使用创建交付来源PutDeliverySource。

  • 使用创建配送目的地PutDeliveryDestination。

  • 如果您跨账户传送日志,则只能使用 Amazon S3 和 Firehose 目标。您必须在目标账户 PutDeliveryDestinationPolicy中使用才能将 IAM 策略分配给目标。此策略授权创建从账户 A 中的传输源到账户 B 中的传输目标的传输。对于跨账户传输,您必须手动创建权限策略。有关设置示例,请参阅Cross-account 配送示例。

  • 通过使用将一个配送来源和一个配送目的地精确配对来创建配送 CreateDelivery。

日志传送设置示例

以下示例在同一个 Amazon 账户中创建配送来源和配送目的地。将源资源 ARN 和日志类型替换为生成日志的服务支持的值。这些示例不需要配送目的地政策。

为 Lo CloudWatch gs Insights 查询执行日志创建传送源

以下示例为 L CloudWatch ogs Insights 查询执行日志创建了传输源。有关 ARN 的完整要求logType和资源,请参阅。PutDeliverySource

注意

中的尾随通配符log-group:*是必需的,因为查询执行日志不绑定到一个日志组。 Amazon 不支持此日志类型的特定日志组 ARN。

aws logs put-delivery-source \ --name insights-query-logs \ --resource-arn arn:aws:logs:region:account-id:log-group:* \ --log-type INSIGHTS_QUERY_LOGS

创建交付来源

创建交付源,然后使用以下目标示例之一。

aws logs put-delivery-source \ --name my-delivery-source \ --resource-arn source-resource-arn \ --log-type log-type

创建发送到 Lo CloudWatch gs 的传输

为现有日志组创建传送目标。

aws logs put-delivery-destination \ --name my-cwl-delivery-destination \ --delivery-destination-configuration \ "destinationResourceArn=arn:aws:logs:region:account-id:log-group:log-group-name"

创建配送。

aws logs create-delivery \ --delivery-source-name my-delivery-source \ --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-cwl-delivery-destination

创建发往亚马逊 S3 的货件

为现有存储桶创建配送目的地。

aws logs put-delivery-destination \ --name my-s3-delivery-destination \ --delivery-destination-configuration \ "destinationResourceArn=arn:aws:s3:::bucket-name"

创建配送。

aws logs create-delivery \ --delivery-source-name my-delivery-source \ --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-s3-delivery-destination

要配置目标前缀、后缀路径或路 Hive-compatible 径,请参见亚马逊 S3 对象密钥格式。

向 Firehose 创建配送

为现有传输流创建传 DirectPut 送目的地。

aws logs put-delivery-destination \ --name my-firehose-delivery-destination \ --delivery-destination-configuration \ "destinationResourceArn=arn:aws:firehose:region:account-id:deliverystream/delivery-stream-name"

创建配送。

aws logs create-delivery \ --delivery-source-name my-delivery-source \ --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-firehose-delivery-destination

创建配送至 X-Ray

要进行跟踪传输,请使用支持传送到的源服务和日志类型 X-Ray。创建逻辑 X-Ray 传送目的地。

aws logs put-delivery-destination \ --name my-xray-delivery-destination \ --delivery-destination-type XRAY

创建配送。

aws logs create-delivery \ --delivery-source-name my-delivery-source \ --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-xray-delivery-destination

要验证交付,请使用以下命令。

aws logs describe-deliveries \ --delivery-source-name-prefix my-delivery-source

以下各节详细介绍了在登录期间使用 V2 流程将日志传输到每种类型目标时需要具备的权限。这些权限可以授予您登录时使用的 IAM 角色。

重要

删除日志生成资源后,您有责任删除日志传输资源。为此,请按照以下步骤操作。

  1. Delivery使用DeleteDelivery操作删除。

  2. DeliverySource使用DeleteDeliverySource操作删除。

  3. 如果与您刚刚删除的DeliveryDestinationDeliverySource关联仅用于此特定用途DeliverySource,则可以使用DeleteDeliveryDestinations操作将其删除。