AWS CloudTrail을 사용하여 Performance Insights 호출 로깅

성능 개선 도우미는 사용자, 역할 또는 성능 개선 도우미의 AWS 서비스에서 수행한 작업을 기록하는 서비스인 AWS CloudTrail에서 실행됩니다. CloudTrail은 성능 개선 도우미에 대한 모든 API 호출을 이벤트로 캡처합니다. 이 캡처에는 Amazon RDS 콘솔과 코드에서 성능 개선 도우미 API 작업으로의 호출이 포함됩니다.

추적을 생성하면 성능 개선 도우미를 포함해 CloudTrail 이벤트를 Amazon S3 버킷으로 지속적으로 배포할 수 있습니다. 추적을 구성하지 않은 경우에도 CloudTrail 콘솔의 이벤트 기록에서 최신 이벤트를 볼 수 있습니다. CloudTrail에서 수집한 데이터를 사용하여 특정 정보를 확인할 수 있습니다. 이 정보에는 성능 개선 도우미에 대한 요청, 요청한 IP 주소, 요청 주체 및 요청한 시간이 포함됩니다. 또한 추가 세부 정보도 포함되어 있습니다.

CloudTrail에 대한 자세한 내용은 AWS CloudTrail 사용 설명서를 참조하십시오.

CloudTrail의 성능 개선 도우미 정보 작업

CloudTrail은 계정 생성 시 AWS계정에서 사용되도록 설정됩니다. 성능 개선 도우미에서 활동이 수행되면 해당 활동은 [이벤트 기록(Event history)]에서 CloudTrail 콘솔의 다른 AWS 서비스 이벤트와 함께 CloudTrail 이벤트에 기록됩니다. AWS 계정에서 최신 이벤트를 확인, 검색 및 다운로드할 수 있습니다. 자세한 내용은 AWS CloudTrail 사용 설명서에서 CloudTrail 이벤트 기록을 사용하여 이벤트 보기를 참조하세요.

성능 개선 도우미의 이벤트를 포함해 AWS 계정의 이벤트를 계속 기록하려면 trail을 생선합니다. CloudTrail은 추적을 사용하여 Amazon S3 버킷으로 로그 파일을 전송할 수 있습니다. 콘솔에서 추적을 생성하면 기본적으로 모든 AWS 지역에 추적이 적용됩니다. 추적은 AWS 파티션에 있는 모든 AWS 리전의 이벤트를 로깅하고 지정한 Amazon S3 버킷으로 로그 파일을 전송합니다. 추가적으로, CloudTrail 로그에서 수집된 이벤트 데이터를 추가 분석 및 처리하도록 다른 AWS 서비스를 구성할 수 있습니다. 자세한 내용은 AWS CloudTrail 사용 설명서에서 다음 주제를 참조하세요.

모든 성능 개선 도우미 작업은 CloudTrail이 기록하며 성능 개선 도우미 API 참조에 문서화됩니다. 예를 들어, DescribeDimensionKeys 및 GetResourceMetrics 작업에 대한 호출은 CloudTrail 로그 파일의 항목을 생성합니다.

모든 이벤트 및 로그 항목에는 요청을 생성한 사용자에 대한 정보가 들어 있습니다. ID 정보를 이용하면 다음을 쉽게 판단할 수 있습니다.

자세한 설명은 CloudTrail userIdentity 요소를 참조하십시오.

성능 개선 도우미 로그 파일 항목

추적이란 지정한 Amazon S3 버킷에 이벤트를 로그 파일로 입력할 수 있게 하는 구성입니다. CloudTrail 로그 파일에는 하나 이상의 로그 항목이 포함될 수 있습니다. 이벤트는 원본의 단일 요청을 나타냅니다. 각 이벤트에는 요청된 작업에 대한 정보, 작업 날짜 및 시간, 요청 파라미터 등이 포함됩니다. CloudTrail 로그 파일은 퍼블릭 API 호출의 주문 스택 트레이스가 아니므로 특정 순서로 표시되지 않습니다.

다음 예는 GetResourceMetrics작업을 보여주는 CloudTrail 로그 항목입니다.

{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "IAMUser",
         "principalId": "AKIAIOSFODNN7EXAMPLE",
        "arn": "arn:aws:iam::123456789012:user/johndoe",
        "accountId": "123456789012",
        "accessKeyId": "AKIAI44QH8DHBEXAMPLE",
        "userName": "johndoe"
    },
    "eventTime": "2019-12-18T19:28:46Z",
    "eventSource": "pi.amazonaws.com",
    "eventName": "GetResourceMetrics",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "72.21.198.67",
    "userAgent": "aws-cli/1.16.240 Python/3.7.4 Darwin/18.7.0 botocore/1.12.230",
    "requestParameters": {
        "identifier": "db-YTDU5J5V66X7CXSCVDFD2V3SZM",
        "metricQueries": [
            {
                "metric": "os.cpuUtilization.user.avg"
            },
            {
                "metric": "os.cpuUtilization.idle.avg"
            }
        ],
        "startTime": "Dec 18, 2019 5:28:46 PM",
        "periodInSeconds": 60,
        "endTime": "Dec 18, 2019 7:28:46 PM",
        "serviceType": "RDS"
    },
    "responseElements": null,
    "requestID": "9ffbe15c-96b5-4fe6-bed9-9fccff1a0525",
    "eventID": "08908de0-2431-4e2e-ba7b-f5424f908433",
    "eventType": "AwsApiCall",
    "recipientAccountId": "123456789012"
}