기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

판매 로그 및 지표

판매된 Amazon CloudWatch 지표 및 로그를 사용하여 에이전트 공간 및 서비스 작업을 모니터링할 수 있습니다. 이 주제에서는 AWS DevOps 에이전트가 계정에 자동으로 게시하는 CloudWatch 지표와 원하는 대상으로 전송하도록 구성할 수 있는 판매 로그에 대해 설명합니다.

판매된 CloudWatch 지표

AWS DevOps Agent는 계정의 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 Agent는 에이전트 스페이스 및 서비스 등록이 처리하는 이벤트에 대한 가시성을 제공하는 판매 로그를 지원합니다. 판매 로그는 Amazon CloudWatch Logs 인프라를 사용하여 원하는 대상으로 로그를 전송합니다.

판매 로그를 사용하려면 전송 대상을 구성해야 합니다. 지원되는 대상은 다음과 같습니다.

지원되는 로그 유형

단일 로그 유형이 지원됩니다APPLICATION_LOGS. 이 로그 유형은 서비스가 내보내는 모든 운영 이벤트를 포함합니다.

로그 이벤트 유형

다음 표에는 AWS DevOps 에이전트가 로깅하는 이벤트가 요약되어 있습니다.

권한

AWS DevOps Agent는 CloudWatch 벤딩 로그(V2 권한)를 사용하여 로그를 전송합니다. 로그 전송을 설정하려면 전송을 구성하는 IAM 역할에 다음 권한이 있어야 합니다.

각 대상 유형에 필요한 전체 IAM 정책은 Amazon CloudWatch Logs 사용 설명서의 다음 주제를 참조하세요.

로그 전송 구성(콘솔)

AWS DevOps Agent는 AWS 관리 콘솔에서 로그 전송을 구성하기 위한 두 위치를 제공합니다.

서비스 등록에 대한 로그 전송을 구성하려면

에이전트 공간에 대한 로그 전송을 구성하려면

로그 전송 구성(CloudWatch API)

CloudWatch Logs 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 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 Agent는 모든 이벤트 유형에서 공유 로그 스키마를 사용합니다. 모든 로그 이벤트가 모든 필드를 사용하는 것은 아닙니다.

다음 표에서는 로그 스키마의 필드를 설명합니다.

로그 전송 관리 및 비활성화

AWS 관리 콘솔의 AWS DevOps 에이전트 콘솔에서 또는 CloudWatch Logs API를 사용하여 언제든지 로그 전송을 수정하거나 제거할 수 있습니다.

로그 전송 관리(콘솔)

로그 전송 비활성화(콘솔)

로그 전송 비활성화(API)

API를 사용하여 로그 전송을 제거하려면 다음 순서로 리소스를 삭제합니다.

가격 책정

AWS DevOps 에이전트는 벤딩 로그 활성화에 대해 요금을 부과하지 않습니다. 그러나 선택한 로그 전송 대상에 따라 전송, 수집, 스토리지, 액세스에 대한 요금이 발생할 수 있습니다. 요금 세부 정보는 Amazon CloudWatch 요금의 로그 탭에서 판매 로그를 참조하세요.

대상별 요금은 다음을 참조하세요.