A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Acesso a eventos de logs usando o registro de eventos
<a name="ipa-logs"></a>

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 [CodeCatalyst informações em CloudTrail](ipa-logging-connections.md#info-in-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 obter mais informações, consulte [Configurando para usar o AWS CLI com CodeCatalyst](set-up-cli.md) e [Perfil de administrador do espaço](ipa-role-types.md#ipa-role-space-admin).

**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 obter mais informações, consulte [Monitoramento de chamadas de API Contas da AWS usando o AWS CloudTrail registro](ipa-logging-connections.md).

1. 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](https://www.rfc-editor.org/rfc/rfc3339#section-5.6), 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](https://www.rfc-editor.org/rfc/rfc3339#section-5.6), 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 elemento `nextToken` 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íodo *2022-11-30* a *2022-12-01*, e que no máximo *2* eventos sejam retornados na resposta.

   ```
   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. 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"
           }
       ]
   }
   ```

1. 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.