Cuando los usuarios llevan a cabo acciones en Amazon CodeCatalyst, estas se registran como eventos. Puede utilizar la AWS CLI para ver los registros de eventos en un espacio dentro de un período de tiempo específico. Puede ver estos eventos para revisar las acciones realizadas en el espacio; esto incluye la fecha y la hora de las acciones, el nombre del usuario que las llevó a cabo y la dirección IP en la que el usuario hizo la solicitud.
nota
Los eventos de administración de un espacio de CodeCatalyst se registran en CloudTrail para la cuenta de facturación conectada. Para obtener más información sobre los eventos de administración de CodeCatalyst registrados por CloudTrail, consulte Información de CodeCatalyst en CloudTrail.
A fin de ver un registro de eventos de un espacio, debe haber instalado y configurado la AWS CLI con un perfil para CodeCatalyst y debe tener el rol de administrador del espacio en ese espacio. Para obtener más información, consulte Configuración para usar la AWS CLI con CodeCatalyst y Rol de administrador del espacio.
nota
Para ver el registro de eventos que han ocurrido en nombre de CodeCatalyst en Cuentas de AWS conectadas, o para ver el registro de eventos en recursos de proyectos o espacios en la cuenta de facturación conectada, puede utilizar AWS CloudTrail. Para obtener más información, consulte Supervisión de llamadas a la API en Cuentas de AWS que usan el registro de AWS CloudTrail.
-
Abra un terminal o una línea de comandos y ejecute el comando aws codecatalyst list-event-logs especificando lo siguiente:
-
El nombre del espacio con la opción
--space-name
. -
La fecha y la hora en las que desea empezar a revisar los eventos, en el formato de hora universal coordinada (UTC), tal y como se especifica en RFC 3339
, con la opción --start-time
. -
La fecha y la hora en las que desea dejar de revisar los eventos, en el formato de hora universal coordinada (UTC), tal y como se especifica en RFC 3339
, con la opción --end-time
. -
(opcional) El número máximo de resultados que se devuelven en una única respuesta, con la opción
--max-results
. Si el número de resultados es mayor que el número que especifique, la respuesta incluirá un elementonextToken
que puede usar para devolver los siguientes resultados. -
(Opcional) Limite los resultados a un tipo de evento específico que desee que se devuelva, con la opción
--event-name
.
En este ejemplo, se devuelven los eventos registrados en el espacio con el nombre
ExampleCorp
desde el30 de noviembre de 2022
hasta el1 de diciembre de 2022
; también se especifica que se devuelvan, como máximo,2
eventos en la respuesta.aws codecatalyst list-event-logs --space-name
ExampleCorp
--start-time2022-11-30
--end-time2022-12-01
--event-namelist-event-logs
--max-results2
-
-
Si los eventos ocurrieron en este período de tiempo, el comando devuelve resultados similares a los siguientes:
{ "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" } ] }
-
Ejecute de nuevo el comando list-event-logs con la opción --next-token y el valor del token devuelto para recuperar el siguiente conjunto de eventos registrados que coincida con la solicitud.