

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

# Monitoramento de eventos e chamadas de API usando o registro
<a name="ipa-monitoring"></a>

Na Amazon CodeCatalyst, os eventos de gerenciamento do espaço são coletados AWS CloudTrail e registrados na trilha da conta de cobrança do espaço. CloudTrail o registro é o método principal para gerenciar o registro de CodeCatalyst eventos, e um método secundário é visualizar o login de eventos CodeCatalyst.

Os eventos na conta são registrados com a trilha e o bucket designado que está configurado para a Conta da AWS. 

O diagrama a seguir mostra como todos os eventos de gerenciamento do espaço são registrados na conta CloudTrail de cobrança, enquanto os eventos da conta e connections/billing os eventos de AWS recursos são registrados na respectiva CloudTrail conta.

![\[Diagrama mostrando como o registro de eventos para espaços é gerenciado\]](http://docs.aws.amazon.com/pt_br/codecatalyst/latest/userguide/images/ipa/logging-codecatalyst.png)


O diagrama ilustra as seguintes etapas:

1. Quando um espaço é criado, um Conta da AWS é conectado ao espaço e é designado como a conta de cobrança. A trilha usada é a trilha que foi criada CloudTrail para a conta de cobrança, na qual os eventos espaciais são registrados. CloudTrail captura chamadas de API e eventos relacionados feitos por ou em nome de um CodeCatalyst espaço e entrega os arquivos de log em um bucket do S3 que você especificar. Se a conta de faturamento mudar para outra conta da AWS, os eventos de espaço serão registrados na trilha e no bucket dessa conta. Para obter mais informações sobre eventos de CodeCatalyst gerenciamento registrados por CloudTrail, consulte[CodeCatalyst informações em CloudTrail](ipa-logging-connections.md#info-in-cloudtrail). 

1. Outras contas conectadas ao espaço, incluindo a conta de cobrança, registram um subconjunto de eventos para conexões de contas e eventos de cobrança. CodeCatalyst fluxos de trabalho que geram eventos de conta para AWS recursos implantados nessa conta também são registrados na trilha e no bucket do. Conta da AWS CloudTrail captura chamadas de API e eventos relacionados feitos por ou em nome de um CodeCatalyst espaço e entrega os arquivos de log em um bucket do S3 que você especificar. Para obter mais informações sobre eventos de CodeCatalyst gerenciamento registrados por CloudTrail, consulte[Acesso a eventos de logs usando o registro de eventos](ipa-logging-connections.md). 

1. Você também pode monitorar CodeCatalyst ações em seu espaço dentro de um horário específico no espaço com o [https://docs.aws.amazon.com//cli/latest/reference/codecatalyst/list-event-logs.html](https://docs.aws.amazon.com//cli/latest/reference/codecatalyst/list-event-logs.html)comando usando AWS CLI o. Para obter mais informações, consulte [o Guia de referência de CodeCatalyst APIs da Amazon](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/Welcome.html). Você deve ter a função de **administrador do espaço** para chamar a lista de eventos para CodeCatalyst ações em seu espaço. Para obter mais informações, consulte [Acesso a eventos de logs usando o registro de eventos](ipa-logging-connections.md). 
**nota**  
`ListEventLogs` garante eventos dos últimos 30 dias em um determinado espaço. Você também pode visualizar e recuperar uma lista de eventos de gerenciamento dos últimos 90 dias CodeCatalyst no AWS CloudTrail console visualizando o **histórico de eventos** ou criando uma trilha para criar e manter um registro de eventos que se estendem por mais de 90 dias. Para obter mais informações, consulte [Trabalhando com histórico de CloudTrail eventos](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) e [Trabalhando com CloudTrail trilhas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html).

**nota**  
AWS os recursos que são implantados em contas conectadas para CodeCatalyst fluxos de trabalho não são registrados como parte do CloudTrail registro do espaço. CodeCatalyst Por exemplo, CodeCatalyst os recursos incluem um espaço ou projeto. AWS os recursos incluem um serviço Amazon ECS ou uma função Lambda. Você deve configurar o CloudTrail registro separadamente para cada Conta da AWS local em que os recursos são implantados.

Aqui está um fluxo possível para monitoramento de eventos em CodeCatalyst.

Mary Major é **administradora espacial** de um CodeCatalyst espaço e visualiza todos os eventos de gerenciamento CodeCatalyst de recursos em nível espacial e em nível de projeto no espaço que está conectado. CloudTrail Veja, [CodeCatalyst informações em CloudTrail](ipa-logging-connections.md#info-in-cloudtrail) por exemplo, eventos que estão logados CloudTrail. 

Para recursos criados em CodeCatalyst, como ambientes de desenvolvimento, Mary visualiza o **histórico de eventos** na conta de cobrança do espaço e investiga eventos em que os ambientes de desenvolvimento foram criados pelos membros do projeto. CodeCatalyst O evento fornece o tipo de identidade do IAM do repositório de identidades e as credenciais para o ID do AWS Builder para o usuário que criou o Dev Environment. Para recursos criados AWS quando implantados por fluxos de trabalho em CodeCatalyst, como uma função Lambda para uma implantação sem servidor, o Conta da AWS proprietário pode visualizar o histórico de eventos da trilha associada à ação separada Conta da AWS (que também é uma conta conectada à CodeCatalyst) da ação de implantação do fluxo de trabalho.

Para investigar mais, Mary também pode visualizar eventos para todos CodeCatalyst APIs no espaço usando o [https://docs.aws.amazon.com//cli/latest/reference/codecatalyst/list-event-logs.html](https://docs.aws.amazon.com//cli/latest/reference/codecatalyst/list-event-logs.html)comando no AWS CLI.

**Topics**
+ [Monitoramento de chamadas de API Contas da AWS usando o AWS CloudTrail registro](ipa-logging-connections.md)
+ [Acesso a eventos de logs usando o registro de eventos](ipa-logs.md)

# Monitoramento de chamadas de API Contas da AWS usando o AWS CloudTrail registro
<a name="ipa-logging-connections"></a>

 CodeCatalyst A Amazon está integrada com AWS CloudTrail, um serviço que fornece um registro das ações realizadas por um usuário, função ou um AWS service (Serviço da AWS). CloudTrail captura chamadas de API feitas em nome de CodeCatalyst in connected Contas da AWS as events. Se você criar uma trilha, poderá habilitar a entrega contínua de CloudTrail eventos em um bucket do S3, incluindo eventos para CodeCatalyst. Se você não configurar uma trilha, ainda poderá ver os eventos mais recentes no CloudTrail console no **Histórico de eventos**.

CodeCatalyst suporta o registro das seguintes ações como eventos em arquivos de CloudTrail log:
+ Os eventos de gerenciamento de CodeCatalyst espaços serão registrados na Conta da AWS conta de cobrança designada para o espaço. Para obter mais informações, consulte [CodeCatalyst eventos espaciais](#cloudtrail-logs-spaces-projects). 
**nota**  
Os eventos de dados para CodeCatalyst espaços podem ser acessados usando a CLI, conforme detalhado em. [Acesso a eventos de logs usando o registro de eventos](ipa-logs.md)
+ Eventos para recursos usados em ações CodeCatalyst de fluxo de trabalho que ocorrem em um Conta da AWS ambiente conectado serão registrados como eventos nesse Conta da AWS. Para obter mais informações, consulte [CodeCatalyst conexões de conta e eventos de cobrança](#cloudtrail-logs-connections). 

**Importante**  
Embora várias contas possam ser associadas a um espaço, o CloudTrail registro de eventos em CodeCatalyst espaços e projetos se aplica somente à conta de faturamento.

A conta de faturamento de espaço é sua Conta da AWS que é cobrada por CodeCatalyst recursos além do nível AWS  gratuito. Várias contas podem ser conectadas a um espaço, enquanto somente uma conta pode ser a conta de faturamento designada. A conta de cobrança ou contas adicionais conectadas ao espaço podem ter funções do IAM que são usadas para implantar AWS recursos e infraestrutura, como um cluster do Amazon ECS ou um bucket do S3, a partir de fluxos de trabalho. CodeCatalyst Você pode usar o fluxo de trabalho YAML para identificar aquele em Conta da AWS que você implantou.

**nota**  
AWS os recursos que são implantados em contas conectadas para CodeCatalyst fluxos de trabalho não são registrados como parte do CloudTrail registro do espaço. CodeCatalyst Por exemplo, CodeCatalyst os recursos incluem um espaço ou projeto. AWS os recursos incluem um serviço Amazon ECS ou uma função Lambda. CloudTrail o registro deve ser configurado separadamente para cada Conta da AWS local em que os recursos são implantados.

CodeCatalyst o login em contas conectadas inclui as seguintes considerações:
+ O acesso aos CloudTrail eventos é gerenciado com o IAM na conta conectada e não na CodeCatalyst.
+ Conexões de terceiros, como a vinculação a um GitHub repositório, resultarão na gravação de nomes de recursos de terceiros nos CloudTrail registros.

**nota**  
CloudTrail o registro de CodeCatalyst eventos está no nível do espaço e não isola os eventos pelos limites do projeto.

Para obter mais informações sobre CloudTrail, consulte o [Guia AWS CloudTrail do usuário](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html).

**nota**  
Esta seção descreve o CloudTrail registro de todos os eventos registrados em um CodeCatalyst espaço conectado e aos Contas da AWS quais estão conectados. CodeCatalyst Além disso, para revisar todos os eventos registrados em um CodeCatalyst espaço, você também pode usar o AWS CLI **aws codecatalyst list-event-logs** comando e. Para obter mais informações, consulte [Acesso a eventos de logs usando o registro de eventos](ipa-logs.md).

## CodeCatalyst eventos espaciais
<a name="cloudtrail-logs-spaces-projects"></a>

As ações CodeCatalyst para gerenciar recursos no nível do espaço e no nível do projeto são registradas na conta de cobrança do espaço. Para CloudTrail registrar um CodeCatalyst espaço, os eventos são registrados com as seguintes considerações.
+ CloudTrail os eventos se aplicam a todo o espaço e não têm como escopo nenhum projeto único.
+ Quando você conecta um Conta da AWS a um CodeCatalyst espaço, os eventos registráveis para conexões da conta serão registrados nele. Conta da AWS Depois de habilitar essa conexão, você não poderá desativá-la.
+ Quando você conecta um Conta da AWS a um CodeCatalyst espaço e o designa como a conta de cobrança do espaço, os eventos serão registrados nele. Conta da AWS Depois de habilitar essa conexão, você não poderá desativá-la.

  Eventos para recursos no nível do espaço e no nível do projeto são registrados somente na conta de faturamento. Para alterar a conta de CloudTrail destino, atualize a conta de cobrança em CodeCatalyst. No início do próximo ciclo de cobrança mensal, a alteração entra em vigor para a nova conta de cobrança em. CodeCatalyst Depois disso, a conta de CloudTrail destino é atualizada.

A seguir estão exemplos de eventos relacionados a ações CodeCatalyst para gerenciar recursos em nível espacial e em nível de projeto. AWS Os itens a seguir APIs são lançados por meio do SDK e da CLI. Os eventos serão registrados na conta de cobrança Conta da AWS especificada para o CodeCatalyst espaço.
+ `[CreateDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_CreateDevEnvironment.html)`
+  `[CreateProject](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_CreateProject.html)`
+ `[DeleteDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_DeleteDevEnvironment.html)`
+ `[GetDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_GetDevEnvironment.html)`
+ `[GetProject](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_GetProject.html)`
+ `[GetSpace](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_GetSpace.html)`
+ `[GetSubscription](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_GetSubscription.html)`
+ `[ListDevEnvironments](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_ListDevEnvironments.html)`
+ `[ListDevEnvironmentSessions](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_ListDevEnvironmentSessions.html)`
+ `[ListEventLogs](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_ListEventLogs.html)`
+ `[ListProjects](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_ListProjects.html)`
+ `[ListSourceRepositories](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_ListSourceRepositories.html)`
+ `[StartDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_StartDevEnvironment.html)`
+ `[StartDevEnvironmentSession](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_StartDevEnvironmentSession.html)`
+ `[StopDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_StopDevEnvironment.html)`
+ `[StopDevEnvironmentSession](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_StopDevEnvironmentSession.html)`
+ `[UpdateDevEnvironment](https://docs.aws.amazon.com/codecatalyst/latest/APIReference/API_UpdateDevEnvironment.html)`

## CodeCatalyst conexões de conta e eventos de cobrança
<a name="cloudtrail-logs-connections"></a>

Veja a seguir exemplos de eventos relacionados a ações em conexões CodeCatalyst de contas ou faturamento: AWS 
+ `AcceptConnection`
+ `AssociateIAMRoletoConnection`
+ `DeleteConnection`
+ `DissassociateIAMRolefromConnection`
+ `GetBillingAuthorization`
+ `GetConnection`
+ `GetPendingConnection`
+ `ListConnections`
+ `ListIAMRolesforConnection`
+ `PutBillingAuthorization`
+ `RejectConnection`

## CodeCatalyst informações em CloudTrail
<a name="info-in-cloudtrail"></a>

CloudTrail é ativado em e Conta da AWS quando você cria essa conta. Quando você conecta isso Conta da AWS a um CodeCatalyst espaço, os eventos desse espaço que ocorrem nele Conta da AWS são registrados são registrados nessa CloudTrail conta da AWS. Os eventos registráveis CodeCatalyst são registrados como CloudTrail eventos nos CloudTrail registros na conta conectada e no **histórico de eventos** no CloudTrail console, junto com outros AWS eventos registráveis nessa conta.





Cada entrada de log ou evento contém informações sobre quem gerou a solicitação. As informações de identidade ajudam a determinar o seguinte: 
+ Se a solicitação foi feita por um usuário com o ID do AWS construtor.
+ Se a solicitação foi feita com credenciais de usuário root ou AWS Identity and Access Management (IAM).
+ Se a solicitação foi feita com credenciais de segurança temporárias de um perfil ou de um usuário federado.
+ Se a solicitação foi feita por outro AWS serviço.

Para obter mais informações, consulte [Elemento userIdentity do CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).

## Acessando CloudTrail eventos
<a name="ipa-logging-connections-view"></a>

Para obter um registro contínuo dos eventos em sua Conta da AWS, incluindo eventos de CodeCatalyst atividades no Conta da AWS, crie uma trilha. Uma *trilha* permite que o CloudTrail forneça arquivos de log para um bucket do S3. Por padrão, quando você cria uma trilha no console, ela é aplicada a todas as Regiões da AWS. A trilha registra eventos de todas as regiões na AWS partição e entrega os arquivos de log ao bucket do S3 que você especificar. Além disso, você pode configurar outros AWS serviços para analisar e agir com base nos dados de eventos coletados nos CloudTrail registros. Para saber mais, consulte: 
+ [Visão geral da criação de uma trilha](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail serviços e integrações suportados](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html)
+ [Configurar notificações do Amazon SNS para o CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Recebendo arquivos de CloudTrail log de várias regiões](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) e [Recebendo arquivos de CloudTrail log de várias contas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)

Uma trilha é uma configuração que permite a entrega de eventos como arquivos de log para um bucket do S3 que você especificar. CloudTrail os arquivos de log contêm uma ou mais entradas de log. Um evento representa uma única solicitação de qualquer fonte e inclui informações sobre a ação solicitada, a data e a hora da ação, os parâmetros da solicitação e assim por diante. CloudTrail os arquivos de log não são um rastreamento de pilha ordenado das chamadas públicas de API, portanto, eles não aparecem em nenhuma ordem específica.

## Exemplo de evento de conexões de CodeCatalyst conta em AWS
<a name="understanding-cloudtrail-entries"></a>

O exemplo a seguir mostra uma entrada de CloudTrail registro que demonstra a `ListConnections` ação. Para um Conta da AWS que está conectado ao espaço, `ListConnections` é usado para visualizar todas as conexões da conta CodeCatalyst para isso Conta da AWS. O evento será registrado no local Conta da AWS especificado e o valor do `arn` será o Amazon Resource Name (ARN) da função usada para a ação. `accountId`

```
{
    "eventVersion": "1.08",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "AKIAI44QH8DHBEXAMPLE",
        "arn": "role-ARN",
        "accountId": "account-ID",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "sessionContext": {
            "sessionIssuer": {
                "type": "Role",
                "principalId": "AKIAI44QH8DHBEXAMPLE",
                "arn": "role-ARN",
                "accountId": "account-ID",
                "userName": "user-name"
            },
            "webIdFederationData": {},
            "attributes": {
                "creationDate": "2022-09-06T15:04:31Z",
                "mfaAuthenticated": "false"
            }
        }
    },
    "eventTime": "2022-09-06T15:08:43Z",
    "eventSource": "account-ID",
    "eventName": "ListConnections",
    "awsRegion": "us-west-2",
    "sourceIPAddress": "192.168.0.1",
    "userAgent": "aws-cli/1.18.147 Python/2.7.18 Linux/5.4.207-126.363.amzn2int.x86_64 botocore/1.18.6",
    "requestParameters": null,
    "responseElements": null,
    "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ",
    "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ",
    "readOnly": true,
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "account-ID",
    "eventCategory": "Management"
}
```

## Exemplo de evento de recurso do CodeCatalyst projeto em AWS
<a name="understanding-cloudtrail-resource-example"></a>

O exemplo a seguir mostra uma entrada de CloudTrail registro que demonstra a `CreateDevEnvironment` ação. Uma Conta da AWS que esteja conectada ao espaço e seja a conta de cobrança designada para o espaço é usada para eventos em nível de projeto no espaço, como a criação de um ambiente de desenvolvimento.

Abaixo`userIdentity`, no `accountId` campo, está o ID da conta do IAM Identity Center (`432677196278`) que hospeda o pool de identidades para todas as identidades de ID do AWS Builder. Esse ID da conta contém as seguintes informações sobre o CodeCatalyst usuário do evento.
+ O campo `type` indica o tipo de entidade do IAM para a solicitação. Para CodeCatalyst eventos para recursos espaciais e de projetos, esse valor é`IdentityCenterUser`. O campo `accountId` especifica a conta proprietária da entidade que foi usada para obter credenciais.
+ O `userId` campo contém o identificador de ID do AWS construtor para o usuário.
+ O campo `identityStoreArn` contém o ARN do perfil da conta e do usuário do repositório de identidades.

O campo `recipientAccountId` contém o ID da conta de faturamento do espaço, com um valor de exemplo aqui de 111122223333.

Para obter mais informações, consulte [Elemento userIdentity do CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).

```
{
	"eventVersion": "1.09",
	"userIdentity": {
		"type": "IdentityCenterUser",
		"accountId": "432677196278",
		"onBehalfOf": {
			"userId": "user-ID",
			"identityStoreArn": "arn:aws:identitystore::432677196278:identitystore/d-9067642ac7"
		},
		"credentialId": "ABCDefGhiJKLMn11Lmn_1AbCDEFgHijk-AaBCdEFGHIjKLmnOPqrs11abEXAMPLE"
	},
	"eventTime": "2023-05-18T17:10:50Z",
	"eventSource": "codecatalyst.amazonaws.com",
	"eventName": "CreateDevEnvironment",
	"awsRegion": "us-west-2",
	"sourceIPAddress": "192.168.0.1",
	"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Firefox/102.0",
	"requestParameters": {
		"spaceName": "MySpace",
		"projectName": "MyProject",
		"ides": [{
			"runtime": "public.ecr.aws/q6e8p2q0/cloud9-ide-runtime:2.5.1",
			"name": "Cloud9"
		}],
		"instanceType": "dev.standard1.small",
		"inactivityTimeoutMinutes": 15,
		"persistentStorage": {
			"sizeInGiB": 16
		}
	},
	"responseElements": {
		"spaceName": "MySpace",
		"projectName": "MyProject",
		"id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 "
	},
	"requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
	"eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
	"readOnly": false,
	"eventType": "AwsApiCall",
	"managementEvent": true,
	"recipientAccountId": "111122223333",
	"sharedEventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
	"eventCategory": "Management"
}
```

**nota**  
Em alguns eventos, o agente do usuário pode não ser conhecido. Nesse caso, CodeCatalyst fornecerá um valor de `Unknown` no `userAgent` campo no CloudTrail evento.

## Consultando suas trilhas de CodeCatalyst eventos
<a name="ipa-logging-connections-query"></a>

Você pode criar e gerenciar consultas para seus CloudTrail registros usando uma tabela de consultas no Amazon Athena. Para ter mais informações sobre a criação de uma consulta, veja [Consultar os logs do AWS CloudTrail](https://docs.aws.amazon.com/athena/latest/ug/cloudtrail-logs.html) no *Manual do usuário do Amazon Athena*.

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