Journalisation des appels d'API AWS Device Farm avecAWS CloudTrail

AWS Device Farm est intégré àAWS CloudTrail, un service qui fournit un enregistrement des actions entreprises par un utilisateur, un rôle ou unAWSservice dans AWS Device Farm. CloudTrailcapture tous les appels d'API pour AWS Device Farm sous forme d'événements. Les appels capturés incluent des appels provenant de la console AWS Device Farm et des appels de code vers les opérations de l'API AWS Device Farm. Si vous créez un suivi, vous pouvez activer la diffusion continue deCloudTrailévénements relatifs à un compartiment Amazon S3, y compris des événements pour AWS Device Farm. Si vous ne configurez pas de journal d'activité, vous pouvez toujours afficher les événements les plus récents dans la console CloudTrail dans Historique des événements. En utilisant les informations collectées parCloudTrail, vous pouvez déterminer la demande envoyée à AWS Device Farm, l'adresse IP à partir de laquelle la demande a été effectuée, l'auteur de la demande, la date à laquelle elle a été faite, ainsi que des informations supplémentaires.

Pour en savoir plus sur CloudTrail, veuillez consulter le Guide de l'utilisateur AWS CloudTrail.

Informations sur AWS Device Farm dansCloudTrail

CloudTrail est activé sur votre compte AWS lorsque vous créez le compte. Lorsqu'une activité a lieu dans AWS Device Farm, elle est enregistrée dans unCloudTrailévénement avec d'autresAWSévénements de service àHistorique de l'événement. Vous pouvez afficher, rechercher et télécharger les événements récents dans votre compte AWS. Pour plus d'informations, consultez Affichage des événements avec l'historique des événements CloudTrail.

Pour un enregistrement continu des événements survenus dans votreAWScompte, y compris les événements pour AWS Device Farm, créez un parcours. UNsentierpermetCloudTrailpour envoyer des fichiers journaux dans un compartiment Amazon S3. Par défaut, lorsque vous créez un journal d'activité dans la console, il s'applique à toutes les régions AWS. Le journal d'activité consigne les événements de toutes les régions dans la partition AWS et livre les fichiers journaux dans le compartiment Amazon S3 de votre choix. En outre, vous pouvez configurer d'autres services AWS pour analyser plus en profondeur les données d'événement collectées dans les journaux CloudTrail et agir sur celles-ci. Pour en savoir plus, consultez les ressources suivantes :

• Présentation de la création d'un journal d'activité

• Intégrations et services supportés par CloudTrail

• Configuration des Notifications de Amazon SNS pour CloudTrail

• Réception de fichiers journaux CloudTrail de plusieurs régions et Réception de fichiers journaux CloudTrail de plusieurs comptes

QuandCloudTrailla journalisation est activée dans votreAWScompte, les appels d'API effectués aux actions de Device Farm sont suivis dans des fichiers journaux. Les enregistrements de Device Farm sont écrits avec d'autresAWSles enregistrements de service dans un fichier journal. CloudTrail détermine quand créer un fichier et écrire dedans en fonction d'une période et d'une taille de fichier.

Toutes les actions de Device Farm sont enregistrées et documentées dans leRéférence AWS CLIet leAutomatiser un parc d'appareils. Par exemple, les appels visant à créer un nouveau projet ou à exécuter dans Device Farm génèrent des entrées dansCloudTrailfichiers journaux.

Chaque événement ou entrée de journal contient des informations sur la personne ayant initié la demande. Les informations relatives à l'identité permettent de déterminer les éléments suivants :

• Si la demande a été effectuée avec les informations d'identification utilisateur racine ou AWS Identity and Access Management (IAM).

• Si la demande a été effectuée avec les informations d'identification de sécurité temporaires d'un rôle ou d'un utilisateur fédéré.

• Si la requête a été effectuée par un autre service AWS.

Pour plus d'informations, consultez la section Élément userIdentity CloudTrail.

Comprendre les entrées du fichier journal d'AWS Device Farm

Un journal d'activité est une configuration qui permet d'envoyer des événements sous forme de fichiers journaux à un compartiment Simple Storage Service (Amazon S3) que vous spécifiez. Les fichiers journaux CloudTrail contiennent une ou plusieurs entrées de journal. Un événement représente une demande unique provenant de n'importe quelle source et comprend des informations sur l'action demandée, la date et l'heure de l'action, les paramètres de la requête, etc. Les fichiers journaux CloudTrail ne constituent pas une série ordonnée retraçant les appels d'API publics. Ils ne suivent aucun ordre précis.

L'exemple suivant montre unCloudTrailentrée de journal illustrant le parc de périphériquesListRunsaction :

{
  "Records": [
    {
      "eventVersion": "1.03",
      "userIdentity": {
        "type": "Root",
        "principalId": "AKIAI44QH8DHBEXAMPLE",
        "arn": "arn:aws:iam::123456789012:root",
        "accountId": "123456789012",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "sessionContext": {
          "attributes": {
            "mfaAuthenticated": "false",
            "creationDate": "2015-07-08T21:13:35Z"
          }
        }
      },
      "eventTime":"2015-07-09T00:51:22Z",
      "eventSource": "devicefarm.amazonaws.com",
      "eventName":"ListRuns",
      "awsRegion":"us-west-2",
      "sourceIPAddress":"203.0.113.11",
      "userAgent":"example-user-agent-string",
      "requestParameters": {
        "arn":"arn:aws:devicefarm:us-west-2:123456789012:project:a9129b8c-df6b-4cdd-8009-40a25EXAMPLE"},
        "responseElements": { 
          "runs": [
            {
              "created": "Jul 8, 2015 11:26:12 PM",
              "name": "example.apk",
              "completedJobs": 2,
              "arn": "arn:aws:devicefarm:us-west-2:123456789012:run:a9129b8c-df6b-4cdd-8009-40a256aEXAMPLE/1452d105-e354-4e53-99d8-6c993EXAMPLE",
              "counters": {
                "stopped": 0,
                "warned": 0,
                "failed": 0,
                "passed": 4,
                "skipped": 0,
                "total": 4,
                "errored": 0
              },
              "type": "BUILTIN_FUZZ",
              "status": "RUNNING",
              "totalJobs": 3,
              "platform": "ANDROID_APP",
              "result": "PENDING"
            },
            ... additional entries ...
          ]
        }
      }
    }
  ]
}