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

出售的日志和指标

您可以使用附带的 Amazon CloudWatch 指标和日志来监控您的代理空间和服务操作。本主题介绍 AWS DevOps 代理自动发布到您的账户的 CloudWatch 指标，以及您可以配置的发送到首选目的地的销售日志。

已售指标 CloudWatch

AWS DevOps 代理会自动将指标发布到您的账户 CloudWatch 中的 Amazon。这些指标无需任何配置即可使用。您可以使用它们来监控使用情况、跟踪操作活动和创建警报。

Service-Linked 角色

要在您的账户中发布该服务的亚马逊 CloudWatch 指标， AWS DevOps 代理将自动为您创建与服务相关的角色AWSServiceRoleForAIDevOps Service-Linked 角色。如果调用 API 的 IAM 角色没有适当的权限，则资源创建将失败，并显示为 InvalidParameterException。

手动创建 Service-Linked 角色（适用于现有客户）

请执行以下操作之一：

aws iam create-service-linked-role --aws-service-name aidevops.amazonaws.com

命名空间

所有指标都发布在AWS/AIDevOps命名空间下。

Dimensions

所有指标都包含以下维度。

指标参考

在 CloudWatch 控制台中查看指标

先决条件

在配置日志传输之前，请确保具备以下条件：

Vended logs（已出售日志）

AWS DevOps 代理支持销售日志，这些日志可让您了解您的代理空间和服务注册处理的事件。Vended Logs 使用 Amazon CloudWatch Logs 基础设施将日志传送到您的首选目的地。

要使用已售日志，必须配置传送目的地。支持以下目的地：

支持的日志类型

支持单一日志类型：APPLICATION_LOGS。此日志类型涵盖服务发出的所有操作事件。

记录事件类型

下表汇总了 AWS DevOps 代理记录的事件。

Permissions

AWS DevOps 代理使用CloudWatch 已售日志（V2 权限）来传送日志。要设置日志传输，配置传输的 IAM 角色必须具有以下权限：

有关每种目标类型所需的完整 IAM 政策，请参阅 A mazon CloudWatch Logs 用户指南中的以下主题：

配置日志传输（控制台）

AWS DevOps 代理在 AWS 管理控制台中提供了两个位置来配置日志传输：

为服务注册配置日志传输

为代理空间配置日志传输

配置日志传输 (CloudWatch API)

您还可以使用 CloudWatch 日志 API 以编程方式配置日志传输。工作日志传输由三个元素组成：

步骤 1：创建交付来源

使用PutDeliverySource操作创建交付来源。传递 AWS DevOps 代理空间资源的 ARN 并指定APPLICATION_LOGS为日志类型。

以下示例为代理空间创建交付源：

{
    "name": "my-agent-space-delivery-source",
    "resourceArn": "arn:aws:aidevops:us-east-1:123456789012:agentspace/my-agent-space-id",
    "logType": "APPLICATION_LOGS"
}

以下示例为服务创建交付源：

{
    "name": "my-service-delivery-source",
    "resourceArn": "arn:aws:aidevops:us-east-1:123456789012:service",
    "logType": "APPLICATION_LOGS"
}

步骤 2：创建配送目的地

使用PutDeliveryDestination操作来配置日志的存储位置。你可以选择 Amazon CloudWatch Logs、Amazon S3 或 Amazon Data Firehose。

以下示例创建了一个 CloudWatch 日志目标：

{
    "name": "my-cwl-destination",
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/aidevops/my-agent-space"
    },
    "outputFormat": "json"
}

以下示例创建了一个 Amazon S3 目的地：

{
    "name": "my-s3-destination",
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:s3:::my-aidevops-logs-bucket"
    },
    "outputFormat": "json"
}

以下示例创建了一个 Amazon Data Firehose 目标：

{
    "name": "my-firehose-destination",
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/my-aidevops-log-stream"
    },
    "outputFormat": "json"
}

如果你想使用 CloudFormation，你可以使用以下内容：

ResourceArn 是 AgentSpaceArn，LogType 必须是作为支持的日志类型的 APPLICATION_LOGS。

步骤 3：创建配送

使用CreateDelivery操作将传送源链接到传送目的地。

{
    "deliverySourceName": "my-agent-space-delivery-source",
    "deliveryDestinationArn": "arn:aws:logs:us-east-1:123456789012:delivery-destination:my-cwl-destination"
}

AWS CloudFormation

您还可以使用 AWS CloudFormation 以下资源来配置日志传输：

设置ResourceArn为 AWS DevOps 代理代理空间或服务 ARN，并设置为LogType。APPLICATION_LOGS

日志架构参考

AWS DevOps 代理在所有事件类型中使用共享日志架构。并非每个日志事件都会使用每个字段。

下表描述了日志架构中的字段。

管理和禁用日志传输

您可以随时通过 AWS 管理控制台中的 AWS DevOps 代理控制台或使用 CloudWatch 日志 API 修改或删除日志传输。

管理日志传输（控制台）

禁用日志传输（控制台）

禁用日志传输 (API)

要使用 API 删除日志传输，请按以下顺序删除资源：

定价

AWS DevOps 代理不为启用已售日志而收费。但是，根据您选择的日志传输目标，可能会产生传输、摄取、存储或访问费用。有关定价详情，请参阅 Amazon CloudWatch P ricing 中 “日志” 选项卡上的 “销售日志”。

有关特定目的地的定价，请参阅以下内容：