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)。

若要檢視空間的事件日誌，您必須已 AWS CLI 使用 CodeCatalyst 的描述檔安裝並設定 ，而且必須具有空間的 **Space 管理員**角色。如需詳細資訊，請參閱 [設定 以 AWS CLI 搭配 CodeCatalyst 使用](set-up-cli.md) 和 [空間管理員角色](ipa-role-types.md#ipa-role-space-admin)。

**注意**  
若要檢視連線中代表 CodeCatalyst 發生的事件記錄 AWS 帳戶，或檢視連線帳單帳戶中空間或專案資源的事件記錄記錄，您可以使用 AWS CloudTrail。如需詳細資訊，請參閱[AWS 帳戶 使用 AWS CloudTrail 記錄來監控 API 呼叫](ipa-logging-connections.md)。

1. 開啟終端機或命令列並執行 **aws codecatalyst list-event-logs**命令，指定：
   + 具有 **--space-name**選項的空格名稱。
   + 您想要開始檢閱事件的日期和時間，採用協調通用時間 (UTC) 時間戳記格式，如 [RFC 3339 ](https://www.rfc-editor.org/rfc/rfc3339#section-5.6)中所指定，並具有 **--start-time**選項。
   + 您希望停止檢閱事件的日期和時間，採用協調通用時間 (UTC) 時間戳記格式，如 [RFC 3339 ](https://www.rfc-editor.org/rfc/rfc3339#section-5.6)中所指定，並附有 **--end-time**選項。
   + （選用） 在單一回應中傳回的結果數目上限，使用 **--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**命令，以擷取符合請求的下一組記錄事件。