本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

已取代的日誌和指標

您可以使用 vended Amazon CloudWatch 指標和日誌來監控代理程式空間和服務操作。本主題說明 AWS DevOps 代理程式自動發佈至您帳戶的 CloudWatch 指標，以及您可以設定以交付至您偏好目的地的付費日誌。

已取代的 CloudWatch 指標

AWS DevOps 代理程式會自動將指標發佈至您帳戶中的 Amazon CloudWatch。這些指標無需任何組態即可使用。您可以使用它們來監控用量、追蹤操作活動，以及建立警示。

服務連結角色

若要在您的帳戶中發佈此服務的 Amazon CloudWatch 指標， AWS DevOps 代理程式會自動為您建立服務連結角色 AWSServiceRoleForAIDevOps 服務連結角色。如果叫用 API 的 IAM 角色沒有適當的許可，資源建立將會失敗，並顯示 InvalidParameterException。

手動建立服務連結角色 （適用於現有客戶）

執行以下任意一項：

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

命名空間

所有指標都會在 AWS/AIDevOps 命名空間下發佈。

維度

所有指標都包含下列維度。

指標參考

在 CloudWatch 主控台中檢視指標

先決條件

設定日誌交付之前，請確定您有下列項目：

付費日誌

AWS DevOps 代理程式支援自動提供的日誌，可讓您查看代理程式空間和服務註冊處理的事件。已取代的日誌使用 Amazon CloudWatch Logs 基礎設施，將日誌交付至您偏好的目的地。

若要使用付費日誌，您必須設定交付目的地。支援下列目的地：

支援的日誌類型

支援單一日誌類型：APPLICATION_LOGS。此日誌類型涵蓋服務發出的所有操作事件。

日誌事件類型

下表摘要說明 AWS DevOps 代理程式記錄的事件。

許可

AWS DevOps 代理程式使用 CloudWatch 提供的日誌 (V2 許可） 來交付日誌。若要設定日誌交付，設定交付的 IAM 角色必須具有下列許可：

如需每個目的地類型所需的完整 IAM 政策，請參閱《Amazon CloudWatch Logs 使用者指南》中的下列主題：

設定日誌交付 （主控台）

AWS DevOps Agent 在 AWS 管理主控台中提供兩個位置來設定日誌交付：

設定服務註冊的日誌交付

設定客服人員空間的日誌交付

設定日誌交付 (CloudWatch API)

您也可以使用 CloudWatch Logs API，以程式設計方式設定日誌交付。工作日誌交付包含三個元素：

步驟 1：建立交付來源

使用 PutDeliverySource 操作來建立交付來源。傳遞 your 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 Logs 目的地：

{
    "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 Logs API 來修改或移除日誌交付。

管理日誌交付 （主控台）

停用日誌交付 （主控台）

停用日誌交付 (API)

若要使用 API 移除日誌交付，請依下列順序刪除資源：

定價

啟用付費日誌時 AWS DevOps 代理程式不會收取費用。不過，您可能需要支付交付、擷取、儲存或存取的費用，視您選取的日誌交付目的地而定。如需定價詳細資訊，請參閱 Amazon CloudWatch 定價中日誌索引標籤上的已修訂日誌。

如需目的地特定的定價，請參閱下列內容：