Accès aux événements enregistrés à l'aide de la journalisation des événements

Lorsque les utilisateurs effectuent des actions sur Amazon CodeCatalyst, celles-ci sont enregistrées en tant qu'événements. Vous pouvez utiliser le AWS CLI pour consulter les journaux des événements survenus dans un espace au cours d'une période spécifiée. Vous pouvez consulter ces événements pour consulter les actions entreprises dans l'espace, notamment la date et l'heure des actions, le nom de l'utilisateur qui a effectué l'action et l'adresse IP à laquelle l'utilisateur a fait la demande.

Note

Les événements de gestion d'un CodeCatalyst espace sont enregistrés CloudTrail pour le compte de facturation connecté. Pour plus d'informations sur les événements de CodeCatalyst gestion enregistrés CloudTrail, consultezCodeCatalyst informations dans CloudTrail.

Pour consulter le journal des événements d'un espace, vous devez l'avoir installé et configuré AWS CLI avec un profil pour CodeCatalyst, et vous devez avoir le rôle d'administrateur de l'espace pour cet espace. Pour plus d’informations, consultez Configuration pour utiliser AWS CLI le CodeCatalyst et Rôle d'administrateur de l'espace.

Note

Pour consulter la journalisation des événements qui se produisent pour le compte de CodeCatalyst in connected Comptes AWS, ou pour consulter la journalisation des événements concernant l'espace ou les ressources du projet dans le compte de facturation connecté, vous pouvez utiliser AWS CloudTrail. Pour plus d’informations, consultez Surveillance des appels d'API à Comptes AWS l'aide de la AWS CloudTrail journalisation.

1. Ouvrez un terminal ou une ligne de commande et exécutez la aws codecatalyst list-event-logs commande en spécifiant :

   • Le nom de l'espace avec l'--space-nameoption.

   • Date et heure auxquelles vous souhaitez commencer à consulter les événements, au format d'horodatage en temps universel coordonné (UTC) tel que spécifié dans la RFC 3339, avec l'option. --start-time

   • La date et l'heure auxquelles vous souhaitez arrêter de consulter les événements, au format d'horodatage en temps universel coordonné (UTC) tel que spécifié dans la RFC 3339, avec l'option. --end-time

   • (Facultatif) Le nombre maximum de résultats à renvoyer dans une seule réponse, avec l'--max-resultsoption. Si le nombre de résultats est supérieur au nombre que vous spécifiez, la réponse comprendra un nextToken élément que vous pourrez utiliser pour renvoyer les résultats suivants.

   • (Facultatif) Limitez les résultats à un type d'événement spécifique que vous souhaitez renvoyer, avec l'--event-nameoption.

   Cet exemple renvoie les événements enregistrés dans l'espace nommé ExampleCorpentre le 30 novembre et le 1er décembre et indique qu'un maximum de 2 événements doivent être renvoyés dans la réponse.

   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. Si des événements se sont produits pendant cette période, la commande renvoie des résultats similaires aux suivants :

   {
       "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. Exécutez à nouveau la list-event-logs commande avec l'--next-tokenoption et la valeur du jeton renvoyé pour récupérer le prochain ensemble d'événements enregistrés correspondant à la demande.