Amazon CodeCatalyst는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 마이그레이션하는 방법](migration.md) 단원을 참조하십시오.

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

# 이벤트 로깅을 사용하여 로깅된 이벤트에 액세스
<a name="ipa-logs"></a>

사용자가 Amazon CodeCatalyst에서 작업을 수행하면 이러한 작업이 이벤트로 기록됩니다. AWS CLI를 사용하여 지정된 기간 동안 스페이스의 이벤트 로그를 볼 수 있습니다. 이러한 이벤트를 보고 작업의 날짜 및 시간, 작업을 수행한 사용자의 이름, 사용자가 요청한 IP 주소를 포함하여 스페이스에서 수행된 작업을 검토할 수 있습니다.

**참고**  
CodeCatalyst 스페이스의 관리 이벤트는 연결된 청구 계정의 CloudTrail에 기록됩니다. CloudTrail에서 로깅하는 CodeCatalyst 관리 이벤트에 대한 자세한 내용은 [CloudTrail의 CodeCatalyst 정보](ipa-logging-connections.md#info-in-cloudtrail) 섹션을 참조하세요.

스페이스에 대한 이벤트 로그를 보려면 CodeCatalyst의 프로파일로 AWS CLI를 설치하고 구성해야 하며, 스페이스에 대한 **스페이스 관리자** 역할이 있어야 합니다. 자세한 내용은 [CodeCatalyst AWS CLI 에서를 사용하도록 설정](set-up-cli.md) 및 [스페이스 관리자 역할](ipa-role-types.md#ipa-role-space-admin) 섹션을 참조하세요.

**참고**  
연결된 AWS 계정에서 CodeCatalyst를 대신하여 발생하는 이벤트에 대한 로깅을 보거나 연결된 청구 계정의 스페이스 또는 프로젝트 리소스에 대한 이벤트에 대한 로깅을 보려면 AWS CloudTrail를 사용할 수 있습니다. 자세한 내용은 [AWS CloudTrail 로깅을 AWS 계정 사용하여 API 호출 모니터링](ipa-logging-connections.md) 섹션을 참조하세요.

1. 터미널 또는 명령줄을 열고 다음을 지정하여 **aws codecatalyst list-event-logs** 명령을 실행합니다.
   + 스페이스의 이름(**--space-name** 옵션 사용).
   + **--start-time** 옵션을 사용하여 [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339#section-5.6)에 지정된 협정 세계시(UTC) 타임스탬프 형식으로 이벤트 검토를 시작하려는 날짜 및 시간입니다.
   + **--end-time** 옵션을 사용하여 [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339#section-5.6)에 지정된 협정 세계시(UTC) 타임스탬프 형식으로 이벤트 검토를 중지하려는 날짜 및 시간입니다.
   + (선택 사항) **--max-results** 옵션을 사용하여 단일 응답으로 반환할 최대 결과 수입니다. 결과 수가 지정한 수보다 크면 응답에 다음 결과를 반환하는 데 사용할 수 있는 `nextToken` 요소가 포함됩니다.
   + (선택 사항) **--event-name** 옵션을 사용하여 반환하려는 특정 이벤트 유형으로 결과를 제한합니다.

   이 예시는 *ExampleCorp*이라는 스페이스에 *2022-11-30*부터 *2022-12-01*까지의 로깅된 이벤트를 반환하고 응답에 최대 *2*개의 이벤트를 반환합니다.

   ```
   aws codecatalyst list-event-logs --space-name ExampleCorp --start-time 2022-11-30 --end-time 2022-12-01 --event-name list-event-logs --max-results 2
   ```

1. 이 기간에 이벤트가 발생한 경우 명령은 다음과 유사한 결과를 반환합니다.

   ```
   {
       "nextToken": "EXAMPLE",
       "items": [
           {
               "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
               "eventName": "listEventLogs",
               "eventType": "AwsApiCall",
               "eventCategory": "MANAGEMENT",
               "eventSource": "manage",
               "eventTime": "2022-12-01T22:47:24.605000+00:00",
               "operationType": "READONLY",
               "userIdentity": {
                   "userType": "USER",
                   "principalId": "a1b2c3d4e5-678fgh90-1a2b-3c4d-e5f6-EXAMPLE11111"
                   "userName": "MaryMajor"
               },
               "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
               "requestPayload": {
                   "contentType": "application/json",
                   "data": "{\"spaceName\":\"ExampleCorp\",\"startTime\":\"2022-12-01T00:00:00Z\",\"endTime\":\"2022-12-10T00:00:00Z\",\"maxResults\":\"2\"}"
               },
               "sourceIpAddress": "127.0.0.1",
               "userAgent": "aws-cli/2.9.0 Python/3.9.11 Darwin/21.3.0 exe/x86_64 prompt/off command/codecatalyst.list-event-logs"
           },
           {
               "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa",
               "eventName": "createProject",
               "eventType": "AwsApiCall",
               "eventCategory": "MANAGEMENT",
               "eventSource": "manage",
               "eventTime": "2022-12-01T09:15:32.068000+00:00",
               "operationType": "MUTATION",
               "userIdentity": {
                   "userType": "USER",
                   "principalId": "a1b2c3d4e5-678fgh90-1a2b-3c4d-e5f6-EXAMPLE11111",
                   "userName": "MaryMajor"
               },
               "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
               "requestPayload": {
                   "contentType": "application/json",
                   "data": "{\"spaceName\":\"ExampleCorp\",\"name\":\"MyFirstProject\",\"displayName\":\"MyFirstProject\"}"
               },
               "responsePayload": {
                   "contentType": "application/json",
                   "data": "{\"spaceName\":\"ExampleCorp\",\"name\":\"MyFirstProject\",\"displayName\":\"MyFirstProject\",\"id\":\"a1b2c3d4-5678-90ab-cdef-EXAMPLE4444\"}"
               },
               "sourceIpAddress": "192.0.2.23",
               "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:102.0) Gecko/20100101 Firefox/102.0"
           }
       ]
   }
   ```

1. **--next-token** 옵션과 반환된 토큰 값을 사용하여 **list-event-logs** 명령을 다시 실행하고 요청과 일치하는 다음 로그 이벤트 세트를 검색합니다.