先决条件 IAM 权限 Vended logs（已出售日志）已售跨度已售指标启用可观测性

通过 Amazon 实现可观察性 CloudWatch

AgentCore payments 支持通过 Amazon 进行观察 CloudWatch，因此您可以监控您的付款集成并对其进行故障排除。

Amazon CloudWatch 是 AWS 监控和可观察性服务。它从您的 AWS 资源中收集和跟踪指标、日志和跟踪，让您了解应用程序的性能。
Vended 日志是 AWS 服务代表您直接发布到您的 CloudWatch 日志组的日志。与您自己检测的应用程序日志不同，销售日志是由服务自动生成的。您可以配置将它们交付到哪里。
跨度表示请求中的工作单元（例如，API 调用及其下游操作）。使用 span 来跟踪请求在系统中的流动，并识别延迟瓶颈或故障。

完成以下设置过程后，任何数据平面 API 调用（例如CreatePaymentInstrument）都会在您配置的日志组中生成 CloudWatch 日志和跟踪数据。

先决条件

作为传送目标的CloudWatch 日志组（例如，/bedrock-agentcore/payments/my-logs）。如果没有，请使用控制台或 CLI 创建一个。
您的资源 ARN。 PaymentManager

创建日志组：

例

IAM 权限

您的 IAM 用户或角色必须具有以下权限才能创建日志和跨度传输资源：


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "CloudWatchLogsVendedDelivery",
            "Effect": "Allow",
            "Action": [
                "logs:CreateDelivery",
                "logs:CreateLogGroup",
                "logs:CreateLogStream",
                "logs:DeleteDelivery",
                "logs:DeleteDeliveryDestination",
                "logs:DeleteDeliverySource",
                "logs:DeleteLogGroup",
                "logs:DeleteResourcePolicy",
                "logs:DescribeLogGroups",
                "logs:DescribeResourcePolicies",
                "logs:GetDelivery",
                "logs:GetDeliveryDestination",
                "logs:GetDeliverySource",
                "logs:PutDeliveryDestination",
                "logs:PutDeliverySource",
                "logs:PutLogEvents",
                "logs:PutResourcePolicy",
                "logs:PutRetentionPolicy"
            ],
            "Resource": "*"
        },
        {
            "Sid": "XRayApplicationSignalsCloudTrail",
            "Effect": "Allow",
            "Action": [
                "xray:GetTraceSegmentDestination",
                "xray:ListResourcePolicies",
                "xray:PutResourcePolicy",
                "xray:PutTelemetryRecords",
                "xray:PutTraceSegments",
                "xray:UpdateTraceSegmentDestination",
                "application-signals:StartDiscovery",
                "cloudtrail:CreateServiceLinkedChannel"
            ],
            "Resource": "*"
        },
        {
            "Sid": "CreateServiceLinkedRoleForAppSignals",
            "Effect": "Allow",
            "Action": "iam:CreateServiceLinkedRole",
            "Resource": "arn:*:iam::*:role/aws-service-role/application-signals.cloudwatch.amazonaws.com/AWSServiceRoleForCloudWatchApplicationSignals"
        },
        {
            "Sid": "BedrockAgentCoreVendedLogDelivery",
            "Effect": "Allow",
            "Action": "bedrock-agentcore:AllowVendedLogDeliveryForResource",
            "Resource": "*"
        }
    ]
}

Vended logs（已出售日志）

Vended Logs 在您配置的日志组中显示为应用程序日志。这些都是由 AgentCore 支付服务为每个数据平面API调用自动生成的。

已售跨度

已售跨度是单个请求的跟踪记录。使用它们来可视化请求流入 AWS X-Ray。每个跨度代表一个工作单元（例如，API 调用及其下游操作），使您能够识别延迟瓶颈或故障。

跨度名称

AgentCore 付款在每个数据平面 API 调用时发出一个跨度。跨度名称遵循以下模式Bedrock.AgentCore.Payments.<Operation>：

跨度名称	说明
`Bedrock.AgentCore.Payments.ProcessPayment`	处理付款交易
`Bedrock.AgentCore.Payments.CreatePaymentInstrument`	创建付款工具
`Bedrock.AgentCore.Payments.GetPaymentInstrument`	检索付款工具
`Bedrock.AgentCore.Payments.ListPaymentInstruments`	列出付款工具
`Bedrock.AgentCore.Payments.DeletePaymentInstrument`	删除付款工具
`Bedrock.AgentCore.Payments.GetPaymentInstrumentBalance`	获取乐器平衡
`Bedrock.AgentCore.Payments.CreatePaymentSession`	创建付款会话
`Bedrock.AgentCore.Payments.GetPaymentSession`	检索付款会话
`Bedrock.AgentCore.Payments.ListPaymentSessions`	列出付款时段
`Bedrock.AgentCore.Payments.DeletePaymentSession`	删除付款会话

跨度属性

每个跨度都包含以下用于筛选和分析的属性 AWS X-Ray：

属性	说明
`aws.payments.payment_manager_id`	此请求的付款管理器 ID
`aws.payments.payment_connector_id`	付款连接器 ID（如果适用）
`aws.payments.payment_instrument_id`	付款工具编号（如果适用）
`aws.payments.payment_session_id`	付款会话 ID（如果适用）
`aws.payments.spend_amount`	付款金额（ProcessPayment 仅限）
`aws.payments.spend_currency`	付款货币（ProcessPayment 仅限）
`aws.payments.session_remaining_budget`	付款后的剩余会话预算（ProcessPayment 仅限）
`aws.payments.total_budget_amount`	会话总预算（ProcessPayment 仅限）
`aws.payments.merchant`	交易的商家地址 (PayTo)（ProcessPayment 仅限）
`aws.payments.payment_agent_name`	代理名称（如果通过`X-Amzn-Bedrock-AgentCore-Payments-Agent-Name`标题提供）
`aws.payments.token_fetch_latency_ms`	从 Ident AgentCore ity 检索凭证令牌的延迟（ProcessPayment 仅限）

标准 AWS 属性也包含在每个跨度上：

aws.region— 该 AWS 地区
aws.account.id— 来电者的账户 ID
aws.resource.arn— PaymentManager ARN
aws.request_id— 请求编号
http.response.status_code— HTTP 响应状态码

已售指标

AgentCore payments 会将以下指标发布到您的 Amazon CloudWatch 命名空间。使用它们来构建仪表板、设置警报和监控支付状况。

指标	单位	说明
`OperationSuccess`	计数	成功的 API 调用次数
`OperationFailure`	计数	失败的 API 调用次数
`OperationLatency`	毫秒	End-to-end 每次 API 调用的延迟
`SpendAmount`	无	已处理的付款金额（ProcessPayment 仅限）
`Throttles`	计数	受限请求数
`UserErrors`	计数	客户端验证错误数
`ActiveSessions`	计数	活跃的付款会话数
`PaymentRequestCount`	计数	付款申请总数
`PaymentSuccessCount`	计数	成功的付款交易
`PaymentFailureCount`	计数	付款交易失败
`PaymentLatency`	毫秒	付款处理延迟

指标维度

发布的指标采用以下维度进行筛选：

操作-API 操作名称（始终存在）
PaymentManagerId— 付款管理器 ID（如果有）
PaymentConnectorId— 支付连接器 ID（如果可用）
AgentName— 代理名称（当通过标题提供时）
货币-付款币种（用于 SpendAmount 指标）

启用可观测性

例

Console

在 Amazon Bedrock AgentCore 控制台的付款管理器详情页面中：

导航至 “记录交付和跟踪” 部分。
将日志传输配置到您的 CloudWatch 日志组。
启用跟踪以查看其中的跨度。 AWS X-Ray

付款管理器详情页面上的可观察性部分提供了实时指标，包括会话计数、API 调用次数、交易成功率和错误率。

AWS CLI


# Step 1: Allow vended log delivery for your Payment Manager
aws bedrock-agentcore allow-vended-log-delivery-for-resource \
    --resource-arn "arn:aws:bedrock-agentcore:us-west-2:123456789012:payment-manager/my-manager"

# Step 2: Create a delivery source
aws logs put-delivery-source \
    --name "payments-logs" \
    --resource-arn "arn:aws:bedrock-agentcore:us-west-2:123456789012:payment-manager/my-manager" \
    --log-type "APPLICATION_LOGS"

# Step 3: Create a delivery destination
aws logs put-delivery-destination \
    --name "payments-log-destination" \
    --delivery-destination-configuration '{"destinationResourceArn": "arn:aws:logs:us-west-2:123456789012:log-group:/bedrock-agentcore/payments/my-logs"}'

# Step 4: Create the delivery
aws logs create-delivery \
    --delivery-source-name "payments-logs" \
    --delivery-destination-arn "arn:aws:logs:us-west-2:123456789012:delivery-destination:payments-log-destination"

AWS SDK


import boto3

# Allow vended log delivery for your Payment Manager
agentcore_client = boto3.client("bedrock-agentcore-control", region_name="us-west-2")
agentcore_client.allow_vended_log_delivery_for_resource(
    resourceArn="arn:aws:bedrock-agentcore:us-west-2:123456789012:payment-manager/my-manager"
)

# Configure CloudWatch Logs delivery
logs_client = boto3.client("logs", region_name="us-west-2")

# Create delivery source
logs_client.put_delivery_source(
    name="payments-logs",
    resourceArn="arn:aws:bedrock-agentcore:us-west-2:123456789012:payment-manager/my-manager",
    logType="APPLICATION_LOGS"
)

# Create delivery destination
logs_client.put_delivery_destination(
    name="payments-log-destination",
    deliveryDestinationConfiguration={
        "destinationResourceArn": "arn:aws:logs:us-west-2:123456789012:log-group:/bedrock-agentcore/payments/my-logs"
    }
)

# Create the delivery
logs_client.create_delivery(
    deliverySourceName="payments-logs",
    deliveryDestinationArn="arn:aws:logs:us-west-2:123456789012:delivery-destination:payments-log-destination"
)

有关可 AgentCore 观测性的更多信息，请参阅可观AgentCore 测性。有关网关特定的指标和跨度，请参阅AgentCore 生成的网关可观察性数据。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

框架集成

支付安全