本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
需要额外权限 [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-arnsource-resource-arn\ --log-typelog-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 角色。
删除日志生成资源后,您有责任删除日志传输资源。为此,请按照以下步骤操作。
-
Delivery使用DeleteDelivery操作删除。 -
DeliverySource使用DeleteDeliverySource操作删除。 -
如果与您刚刚删除的
DeliveryDestinationDeliverySource关联仅用于此特定用途DeliverySource,则可以使用DeleteDeliveryDestinations操作将其删除。