Acesso a eventos de logs usando o registro de eventos - Amazon CodeCatalyst

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.

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

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 obter mais informações, consulte Configurando para usar o AWS CLI com 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 obter mais informações, consulte Monitoramento de chamadas de API em Contas da AWS usando o registro do AWS CloudTrail.

  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, 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 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

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

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