Acessando eventos registrados usando o registro de eventos - Amazon 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á.

Acessando eventos registrados usando o registro de eventos

Quando os usuários realizam ações na Amazon CodeCatalyst, essas ações são registradas como eventos. Você pode usar o AWS CLI para visualizar registros de eventos em um espaço em um período de tempo 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 CodeCatalyst espaço são registrados na CloudTrail conta de cobrança conectada. Para obter mais informações sobre eventos de CodeCatalyst gerenciamento registrados por CloudTrail, consulteCodeCatalyst informações em CloudTrail.

Para visualizar um registro de eventos de um espaço, você deve ter instalado e configurado o AWS CLI com um perfil para CodeCatalyst e ter a função de administrador do espaço. Para obter mais informações, consulte Configurando para usar o AWS CLI com CodeCatalyst e Função de administrador de espaço.

nota

Para visualizar o registro de eventos que ocorrem em nome de CodeCatalyst in connected Contas da AWS ou para visualizar o registro de eventos de espaço ou recursos do projeto na conta de faturamento conectada, você pode usar AWS CloudTrail. Para ter mais informações, consulte Monitoramento de chamadas de API Contas da AWS usando o AWS CloudTrail registro.

  1. Abra um terminal ou linha de comando e execute o aws codecatalyst list-event-logs comando, especificando:

    • O nome do espaço com a --space-name opção.

    • 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 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 --max-results opção. Se o número de resultados for maior que o número especificado, a resposta incluirá um nextToken elemento 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 --event-name opção.

    Este exemplo retorna eventos registrados no espaço nomeado ExampleCorpdo 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 os eventos ocorreram nesse período, o comando retornará resultados semelhantes aos seguintes:

    {
    "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 list-event-logs comando novamente com a --next-token opção e o valor do token retornado para recuperar o próximo conjunto de eventos registrados que correspondam à solicitação.