使用事件记录访问已记录的事件

当用户在 Amazon 中执行操作时 CodeCatalyst，这些操作会被记录为事件。您可以使用 AWS CLI 来查看空间中指定时间范围内的事件日志。您可以查看这些事件以查看在空间中执行的操作，包括操作的日期和时间、执行操作的用户的姓名以及用户发出请求的 IP 地址。

注意

CodeCatalyst 空间的管理事件是为关联 CloudTrail 的结算账号登录的。有关由记录的 CodeCatalyst 管理事件的更多信息 CloudTrail，请参阅CodeCatalyst 信息在 CloudTrail。

要查看空间的事件日志，您必须已安装并配置了 AWS CLI 空间的配置文件 CodeCatalyst，并且必须具有该空间的空间管理员角色。有关更多信息，请参阅 设置为AWS CLI与一起使用 CodeCatalyst 和 空间管理员角色。

注意

要查看代表连接 CodeCatalyst 中发生的事件的日志记录 AWS 账户，或者查看关联账单账户中空间或项目资源的事件日志记录，可以使用 AWS CloudTrail。有关更多信息，请参阅 AWS 账户 使用 AWS CloudTrail 日志记录监控 API 调用。

1. 打开终端或命令行并运行aws codecatalyst list-event-logs命令，指定：

   • 带有--space-name选项的空间的名称。

   • 您要开始查看事件的日期和时间，采用协调世界时 (UTC) 时间戳格式，如 RFC 3339 中指定，带有选项。--start-time

   • 您想要停止查看事件的日期和时间，采用协调世界时 (UTC) 时间戳格式，如 RFC 3339 中指定，带有选项。--end-time

   • （可选）在单个响应中返回的最大结果数，带--max-results选项。如果结果数大于您指定的数字，则响应中将包含一个可用于返回下一个结果的nextToken元素。

   • （可选）使用--event-name选项，将结果限制为要返回的特定事件类型。

   此示例返回名为 2022-11-30 ExampleCorp到 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

2. 如果事件发生在此时间范围内，则该命令将返回类似于以下内容的结果：

   {
       "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"
           }
       ]
   }

3. 使用--next-token选项和返回的令牌的值再次运行该list-event-logs命令，以检索与请求匹配的下一组记录的事件。