Quando os usuários realizam ações no Amazon CodeCatalyst, essas ações são registradas como eventos. Você pode usar a AWS CLI para visualizar logs de eventos em um espaço em um período especificado. Você pode visualizar esses eventos para analisar as ações realizadas no espaço, incluindo a data e a hora das ações, o nome do usuário que realizou a ação e o endereço IP em que o usuário fez a solicitação.
nota
Os eventos de gerenciamento de um espaço do CodeCatalyst são registrados no CloudTrail para a conta de faturamento conectada. Para ter mais informações sobre os eventos de gerenciamento do CodeCatalyst que são registrados pelo CloudTrail, consulte Informações do CodeCatalyst no CloudTrail.
Para visualizar um log de eventos de um espaço, você deve ter instalado e configurado a AWS CLI com um perfil para o CodeCatalyst e deve ter o perfil de Administrador do espaço. Para ter mais informações, consulte Configuração para usar o AWS CLI com o CodeCatalyst e Perfil de administrador do espaço.
nota
Para visualizar o registro de eventos que ocorrem em nome do CodeCatalyst nas Contas da AWS conectadas, ou para visualizar o registro de eventos de espaço ou recursos do projeto na conta de faturamento conectada, você pode usar o AWS CloudTrail. Para ter mais informações, consulte Monitoramento de chamadas de API em Contas da AWS usando o registro do AWS CloudTrail.
-
Abra um terminal ou uma linha de comando e execute o comando aws codecatalyst list-event-logs, especificando:
-
O nome do espaço com a opção
--space-name
. -
A data e a hora em que você deseja começar a revisar os eventos, no formato de carimbo de data/hora universal coordenada (UTC), conforme especificado na RFC 3339
, com a opção --start-time
. -
A data e a hora em que você deseja parar de revisar os eventos, no formato de carimbo de data/hora universal coordenada (UTC), conforme especificado na RFC 3339
, com a opção --end-time
. -
(Opcional) O número máximo de resultados a serem retornados em uma única resposta, com a opção
--max-results
. Se o número de resultados for maior que o número especificado, a resposta incluirá um elementonextToken
que você pode usar para retornar os próximos resultados. -
(Opcional) Limite os resultados a um tipo de evento específico que você deseja retornar, com a opção
--event-name
.
Este exemplo retorna eventos de logs no espaço chamado
ExampleCorp
do período2022-11-30
a2022-12-01
, e que no máximo2
eventos sejam retornados na resposta.aws codecatalyst list-event-logs --space-name
ExampleCorp
--start-time2022-11-30
--end-time2022-12-01
--event-namelist-event-logs
--max-results2
-
-
Se eventos tiverem ocorrido nesse período, o comando retornará resultados semelhantes a:
{ "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" } ] }
-
Execute o comando list-event-logs novamente com a opção --next-token e o valor do token retornado para recuperar o próximo conjunto de eventos registrados que correspondam à solicitação.