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

AWS CloudTrail 를 사용하여 API 호출 로깅

Amazon Chime SDK는 사용자 AWS CloudTrail, 역할 또는 서비스가 Amazon Chime SDK에서 수행한 작업에 대한 레코드를 제공하는 AWS 서비스와 통합됩니다. CloudTrail은 Amazon Chime SDK 콘솔의 호출 및 Amazon Chime SDK API에 대한 코드 호출을 포함하여 Amazon Chime SDK에 대한 모든 APIs.

추적을 생성하면 Amazon Chime SDK에 대한 이벤트를 포함하여 CloudTrail 이벤트를 Amazon S3 버킷으로 지속적으로 전송할 수 있습니다. Amazon S3 추적을 구성하지 않은 경우에도 CloudTrail 콘솔의 이벤트 기록 페이지에서 최신 이벤트를 볼 수 있습니다. 정보에는 각 요청, 요청이 수행된 IP 주소, 요청을 수행한 사람이 포함됩니다.

AWS 계정을 생성할 때 계정에서 CloudTrail이 활성화됩니다. Amazon Chime 관리 콘솔이 API를 호출하면 CloudTrail은 이벤트에서 해당 활동을 기록합니다. 이벤트를 보려면 CloudTrail 콘솔을 시작하고 이벤트 기록으로 이동합니다. AWS 계정에서 최근 이벤트를 보고 검색하고 다운로드할 수 있습니다. 자세한 내용은 CloudTrail 이벤트 기록을 사용하여 이벤트 보기를 참조하십시오.

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

추적 생성

다음 주제에서는 CloudTrail 콘솔을 사용하여 추적을 생성하는 방법을 설명합니다. 기본적으로 콘솔에서 추적을 생성하면 추적은 AWS 파티션의 모든 리전에서 이벤트를 로깅하고 지정한 Amazon S3 버킷으로 로그 파일을 전송합니다.

나열된 순서대로 다음 주제를 따르세요.

추적으로 캡처된 데이터

CloudTrail은 모든 Amazon Chime SDK 작업을 로깅합니다. 작업에 대한 자세한 내용은 Amazon Chime SDK API 참조를 참조하세요. 예를 들어를 호출하면 CreateAttendee작업이 CloudTrail 로그 파일에 항목을 생성합니다. 모든 이벤트에는 누가 요청을 생성했는지에 대한 정보가 포함됩니다. 자격 증명 정보를 이용하면 다음을 쉽게 판단할 수 있습니다.

자세한 내용은 CloudTrail userIdentity 요소를 참조하세요.

Amazon Chime SDK 로그 파일 항목 이해

추적이란 지정한 Amazon S3 버킷에 이벤트를 로그 파일로 입력할 수 있게 하는 구성입니다. CloudTrail 로그 파일에는 하나 이상의 로그 항목이 포함될 수 있습니다. 이벤트는 모든 소스의 단일 요청을 나타내며 요청된 작업, 작업 날짜와 시간, 요청 파라미터 등에 대한 정보를 포함하고 있습니다. CloudTrail 로그 파일은 퍼블릭 API 직접 호출에 대한 순서 지정된 스택 추적이 아니기 때문에 특정 순서로 표시되지 않습니다.

Amazon Chime SDK에 대한 항목은 chime.amazonaws.com 이벤트 소스로 식별됩니다.

Amazon Chime SDK 계정에 Active Directory를 구성한 경우 CloudTrail을 사용하여 AWS 디렉터리 서비스 API 호출 로깅을 참조하세요. 다음은 Amazon Chime SDK 사용자의 로그인 기능에 영향을 미칠 수 있는 문제를 모니터링하는 방법을 설명합니다.

다음 예제는 Amazon Chime SDK에 대한 CloudTrail 로그 항목을 보여줍니다.

{"eventVersion":"1.05",
         "userIdentity":{  
            "type":"IAMUser",
            "principalId":"AAAAAABBBBBBBBEXAMPLE",
            "arn":"arn:aws:iam::123456789012:user/Alice",
            "accountId":"0123456789012",
            "accessKeyId":"AAAAAABBBBBBBBEXAMPLE",
            "sessionContext":{  
               "attributes":{  
                  "mfaAuthenticated":"false",
                  "creationDate":"2017-07-24T17:57:43Z"
               },
               "sessionIssuer":{  
                  "type":"Role",
                  "principalId":"AAAAAABBBBBBBBEXAMPLE",
                  "arn":"arn:aws:iam::123456789012:role/Joe",
                  "accountId":"123456789012",
                  "userName":"Joe"
               }
            }
         } ,
         "eventTime":"2017-07-24T17:58:21Z",
         "eventSource":"chime.amazonaws.com",
         "eventName":"AddDomain",
         "awsRegion":"us-east-1",
         "sourceIPAddress":"72.21.198.64",
         "userAgent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Safari/537.36",
         "errorCode":"ConflictException",
         "errorMessage":"Request could not be completed due to a conflict",
         "requestParameters":{  
            "domainName":"example.com",
            "accountId":"11aaaaaa1-1a11-1111-1a11-aaadd0a0aa00"
         },
         "responseElements":null,
         "requestID":"be1bee1d-1111-11e1-1eD1-0dc1111f1ac1",
         "eventID":"00fbeee1-123e-111e-93e3-11111bfbfcc1",
         "eventType":"AwsApiCall",
         "recipientAccountId":"123456789012"
      }