Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Journalisation des appels d'API AWS AppConfig avec AWS CloudTrail
AWS AppConfigest intégré à AWS CloudTrail un service qui fournit un enregistrement des actions entreprises par un utilisateur, un rôle ou un AWS service dansAWS AppConfig. CloudTrail capture tous les appels d'API AWS AppConfig sous forme d'événements. Les appels capturés incluent des appels de la console AWS AppConfig et les appels de code vers les opérations d'API AWS AppConfig. Si vous créez un suivi, vous pouvez activer la diffusion continue d' CloudTrailévénements vers un compartiment Amazon S3, y compris les événements pourAWS AppConfig. Si vous ne configurez pas de suivi, vous pouvez toujours consulter les événements les plus récents dans la CloudTrail console dans Historique des événements. À l'aide des informations collectées par CloudTrail, vous pouvez déterminer la demande qui a été faiteAWS AppConfig, l'adresse IP à partir de laquelle la demande a été faite, qui a fait la demande, quand elle a été faite et des détails supplémentaires.
Pour en savoir plus CloudTrail, consultez le guide de AWS CloudTrail l'utilisateur.
AWS AppConfiginformations dans CloudTrail
CloudTrail est activé sur votre compte Compte AWS lorsque vous créez le compte. Lorsqu'une activité se produit dansAWS AppConfig, cette activité est enregistrée dans un CloudTrail événement avec d'autres événements de AWS service dans l'historique des événements. Vous pouvez afficher, rechercher et télécharger les événements récents dans votre Compte AWS. Pour plus d'informations, consultez la section Affichage des événements à l'aide de l'historique des CloudTrail événements.
Pour un enregistrement continu des événements dans votre Compte AWS, y compris les événements pour AWS AppConfig, créez un journal d'activité. Un suivi permet CloudTrail de fournir des fichiers journaux à 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 Régions AWS. Le journal de suivi 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 AWS services pour analyser plus en détail les données d'événements collectées dans les CloudTrail journaux et agir en conséquence. Pour en savoir plus, consultez les ressources suivantes :
Toutes les AWS AppConfig actions sont enregistrées CloudTrail et documentées dans la référence de l'AWS AppConfigAPI. Par exemple, les appels auCreateApplication
, GetApplication
et les ListApplications
actions génèrent des entrées dans les fichiers CloudTrail 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 demande a été effectuée par un autre service AWS.
Pour de plus amples informations, veuillez consulter l'élément userIdentity CloudTrail .
AWS AppConfigévénements de données dans CloudTrail
Les événements de données fournissent des informations sur les opérations de ressources effectuées sur ou dans une ressource (par exemple, récupération de la dernière configuration déployée en appelant GetLatestConfiguration). Ils sont également connus sous le nom opérations de plans de données. Les événements de données sont souvent des activités dont le volume est élevé. Par défaut, CloudTrail n'enregistre pas les événements liés aux données. L'historique des CloudTrail événements n'enregistre pas les événements liés aux données.
Des frais supplémentaires s’appliquent pour les événements de données. Pour plus d'informations sur la CloudTrail tarification, consultez la section AWS CloudTrailTarification
Vous pouvez enregistrer les événements de données pour les types de AWS AppConfig ressources à l'aide de la CloudTrail console ou AWS CLI des opérations de CloudTrail l'API. Le tableau de cette section indique les types de ressources disponibles pourAWS AppConfig.
-
Pour enregistrer les événements de données à l'aide de la CloudTrail console, créez un magasin de données de suivi ou d'événement pour enregistrer les événements, ou mettez à jour un magasin de données de suivi ou d'événement existant pour enregistrer les événements de données.
-
Choisissez Data events pour enregistrer les événements liés aux données.
-
Dans la liste des types d'événements de données, sélectionnez AWS AppConfig.
-
Choisissez le modèle de sélecteur de journal que vous souhaitez utiliser. Vous pouvez enregistrer tous les événements de données pour le type de ressource, consigner tous les
readOnly
événements, consigner tous leswriteOnly
événements ou créer un modèle de sélecteur de journal personnalisé pour filtrer lesresources.ARN
champsreadOnly
eventName
, et. -
Dans Nom du sélecteur, entrez AppConfigDataEvents. Pour plus d'informations sur l'activation d'Amazon CloudWatch Logs pour le suivi de vos événements liés aux données, consultezMesures de journalisation pour les appels du plan de AWS AppConfig données.
-
-
Pour enregistrer des événements de données à l'aide deAWS CLI, configurez le
--advanced-event-selectors
paramètre pour définir leeventCategory
champ égal à la valeur du type de ressourceData
et leresources.type
champ égal à la valeur du type de ressource (voir le tableau). Vous pouvez ajouter des conditions pour filtrer les valeurs desresources.ARN
champsreadOnly
eventName
, et.-
Pour configurer un suivi afin de consigner les événements liés aux données, exécutez la put-event-selectorscommande. Pour plus d'informations, consultez la section Enregistrement des événements de données pour les sentiers avec le AWS CLI.
-
Pour configurer un magasin de données d'événements afin de consigner les événements, exécutez la create-event-data-storecommande pour créer un nouveau magasin de données d'événements pour enregistrer les événements ou exécutez la update-event-data-storecommande pour mettre à jour un magasin de données d'événements existant. Pour plus d'informations, consultez la section Enregistrement des événements de données pour les magasins de données d'événements avec le AWS CLI.
-
Le tableau suivant répertorie les types de ressources AWS AppConfig. La colonne Type d'événement de données (console) indique la valeur à choisir dans la liste des types d'événements de données de la CloudTrail console. La colonne de valeur resources.type indique la resources.type
valeur que vous devez spécifier lors de la configuration de sélecteurs d'événements avancés à l'aide des API or. AWS CLI CloudTrail La CloudTrail colonne Data APIs logged to indique les appels d'API enregistrés CloudTrail pour le type de ressource.
Type d’événement de données (console) | valeur resources.type | API de données connectées à CloudTrail * |
---|---|---|
AWS AppConfig |
AWS::AppConfig::Configuration
|
*Vous pouvez configurer des sélecteurs d'événements avancés pour filtrer les eventName
readOnly
, et des resources.ARN
champs pour enregistrer uniquement les événements qui sont importants pour vous. Pour plus d’informations sur ces champs, consultez AdvancedFieldSelector.
AWS AppConfigévénements de gestion dans CloudTrail
Les événements de gestion fournissent des informations sur les opérations de gestion exécutées sur les ressources de votre compte AWS. Ils sont également connus sous le nom opérations de plan de contrôle. Par défaut, CloudTrail enregistre les événements de gestion.
AWS AppConfigenregistre toutes les opérations AWS AppConfig du plan de contrôle en tant qu'événements de gestion. Pour obtenir la liste des opérations du plan de AWS AppConfig contrôle auxquelles il est AWS AppConfig possible de se connecter CloudTrail, consultez la référence de l'AWS AppConfigAPI.
Présentation des entrées des fichiers journaux AWS AppConfig
Un suivi est une configuration qui permet de transmettre des événements sous forme de fichiers journaux à un compartiment Amazon S3 que vous spécifiez. CloudTrail les fichiers journaux contiennent une ou plusieurs entrées de journal. Un événement représente une demande unique provenant de n'importe quelle source et inclut des informations sur l'action demandée, la date et l'heure de l'action, les paramètres de la demande, etc. CloudTrail les fichiers journaux ne constituent pas une trace ordonnée des appels d'API publics, ils n'apparaissent donc pas dans un ordre spécifique.
L'exemple suivant montre une entrée de CloudTrail journal illustrant l'StartConfigurationSessionaction.
{ "eventVersion": "1.09", "userIdentity": { "type": "IAMUser", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::123456789012:user/Administrator", "accountId": "123456789012", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "sessionContext": { "sessionIssuer": {}, "attributes": { "creationDate": "2024-01-11T14:37:02Z", "mfaAuthenticated": "false" } } }, "eventTime": "2024-01-11T14:45:15Z", "eventSource": "appconfig.amazonaws.com", "eventName": "StartConfigurationSession", "awsRegion": "us-east-1", "sourceIPAddress": "203.0.113.0", "userAgent": "Boto3/1.34.11 md/Botocore#1.34.11 ua/2.0 os/macos#22.6.0 md/arch#x86_64 lang/python#3.11.4 md/pyimpl#CPython cfg/retry-mode#legacy Botocore/1.34.11", "requestParameters": { "applicationIdentifier": "rrfexample", "environmentIdentifier": "mexampleqe0", "configurationProfileIdentifier": "3eexampleu1" }, "responseElements": null, "requestID": "a1b2c3d4-5678-90ab-cdef-aaaaaEXAMPLE", "eventID": "a1b2c3d4-5678-90ab-cdef-bbbbbEXAMPLE", "readOnly": false, "resources": [ { "accountId": "123456789012", "type": "AWS::AppConfig::Configuration", "ARN": "arn:aws:appconfig:us-east-1:123456789012:application/rrfexample/environment/mexampleqe0/configuration/3eexampleu1" } ], "eventType": "AwsApiCall", "managementEvent": false, "recipientAccountId": "123456789012", "eventCategory": "Data", "tlsDetails": { "tlsVersion": "TLSv1.3", "cipherSuite": "TLS_AES_128_GCM_SHA256", "clientProvidedHostHeader": "appconfigdata.us-east-1.amazonaws.com" } }