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.
Enregistrez les appels d'API Amazon ECS à l'aide de AWS CloudTrail
Amazon Elastic Container Service est intégré à AWS CloudTrail, un service qui fournit un enregistrement des actions entreprises par un utilisateur, un rôle ou Service AWS. CloudTrail capture tous les appels d'API pour Amazon ECS sous forme d'événements. Les appels capturés comprennent les ceux provenant de la console Amazon ECS et les appels de code vers les opérations de l’API Amazon ECS. Utilisation des informations collectées par CloudTrail, vous pouvez déterminer la demande qui a été envoyée à Amazon ECS, l'adresse IP à partir de laquelle la demande a été faite, la date à laquelle elle a été faite et des informations supplémentaires.
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 :
-
Si la demande a été effectuée avec des informations d’identification d’utilisateur root ou d’utilisateur root.
-
Si la demande a été faite au nom d'un utilisateur du centre d'identité 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.
CloudTrail est actif dans votre Compte AWS lorsque vous créez le compte et que vous avez automatiquement accès au CloudTrail Historique de l'événement. Le CloudTrail Historique de l'événement fournit un enregistrement consultable, consultable, téléchargeable et immuable des 90 derniers jours des événements de gestion enregistrés dans un Région AWS. Pour plus d'informations, voir Travailler avec CloudTrail Historique de l'événement dans le AWS CloudTrail Guide de l'utilisateur. Il n'y a pas CloudTrail frais de visionnage du Historique de l'événement.
Pour un enregistrement continu des événements survenus dans votre Compte AWS au cours des 90 derniers jours, créez un parcours ou CloudTrail Lac magasin de données d'événements.
- CloudTrail sentiers
UNE sentier permet CloudTrail pour transmettre des fichiers journaux à un compartiment Amazon S3. Tous les sentiers créés à l'aide du Console de gestion AWS sont multirégionaux. Vous ne pouvez créer un journal de suivi en une ou plusieurs régions à l'aide de l' AWS CLI. Il est recommandé de créer un sentier multirégional car vous capturez l'activité dans tous les domaines Régions AWS dans votre compte. Si vous créez un journal de suivi pour une seule région, il convient de n'afficher que les événements enregistrés dans le journal de suivi pour une seule région Région AWS. Pour plus d'informations sur les journaux de suivi, consultez Créez un journal de suivi dans vos Compte AWS et Création d'un journal de suivi pour une organisation dans le AWS CloudTrail Guide de l'utilisateur.
Vous pouvez envoyer gratuitement une copie de vos événements de gestion en cours dans votre compartiment Amazon S3 à CloudTrail en créant une trace, cependant, des frais de stockage Amazon S3 s'appliquent. Pour plus d'informations sur CloudTrail tarification, voir AWS CloudTrail Tarification
. Pour obtenir des informations sur la tarification Amazon S3, consultez Tarification Amazon S3 . - CloudTrail Magasins de données sur les événements liés
CloudTrail Lac vous permet de courir SQL-based des questions sur vos événements. CloudTrail Lake convertit les événements existants au format JSON basé sur des lignes en ORC Apache
format. ORC est un format de stockage en colonnes qui est optimisé pour une récupération rapide des données. Les événements sont agrégés dans des magasins de données d’événement. Ceux-ci constituent des collections immuables d’événements basées sur des critères que vous sélectionnez en appliquant des sélecteurs d’événements avancés. Les sélecteurs que vous appliquez à un magasin de données d’événement contrôlent les événements qui persistent et que vous pouvez interroger. Pour plus d'informations sur CloudTrail Lac, voir Travailler avec AWS CloudTrail Lac dans le AWS CloudTrail Guide de l'utilisateur. CloudTrail Les stockages et les requêtes de données sur les événements liés aux lacs entraînent des coûts. Lorsque vous créez un magasin de données d’événement, vous choisissez l’option de tarification que vous voulez utiliser pour le magasin de données d’événement. L’option de tarification détermine le coût d’ingestion et de stockage des événements, ainsi que les périodes de conservation par défaut et maximale pour le magasin de données d’événement. Pour plus d'informations sur CloudTrail tarification, voir AWS CloudTrail Tarification
.
Événements de gestion Amazon ECS dans CloudTrail
Événements de gestion fournir des informations sur les opérations de gestion effectué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.
Amazon Elastic Container Service journalise toutes les opérations du plan de contrôle Amazon ECS en tant qu’événements de gestion. Par exemple, les appels au CreateService, RunTask et DeleteCluster les sections génèrent des entrées dans CloudTrail fichiers journaux. Pour obtenir la liste des opérations du plan de contrôle Amazon Elastic Container Service auxquelles Amazon ECS se connecte CloudTrail, consultez le Référence de l'API Amazon Elastic Container Service.
Événements liés aux données Amazon ECS dans CloudTrail
Événements liés aux données fournir des informations sur les opérations de ressources effectuées sur ou dans une ressource. Par défaut, CloudTrail n'enregistre pas les événements liés aux données. Le CloudTrail Historique de l'événement 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 CloudTrail tarification, voir AWS CloudTrail Tarification
Vous pouvez enregistrer les événements de données pour les types de ressources Amazon ECS à l'aide du CloudTrail console, AWS CLI, ou CloudTrail Opérations d'API. Pour plus d’informations sur la façon de journaliser les événements de données, consultez Journalisation des événements de données avec la Console de gestion AWS et Journalisation des événements de données avec l’ AWS Command Line Interface dans le Guide de l’utilisateur AWS CloudTrail .
Le tableau suivant répertorie les types de ressources Amazon ECS pour lesquels vous pouvez enregistrer les événements liés aux données. Le Type d'événement de données (console) la colonne indique la valeur à choisir parmi Type d'événement de données liste sur le CloudTrail console. Le valeur resources.type la colonne affiche resources.type valeur, que vous devez spécifier lors de la configuration de sélecteurs d'événements avancés à l'aide du AWS CLI ou CloudTrail API. Le API de données connectées à CloudTrail la colonne affiche les appels d'API enregistrés dans CloudTrail pour le type de ressource.
| Type d’événement de données (console) | valeur resources.type | API de données connectées à CloudTrail |
|---|---|---|
| AwsApiCall |
AWS::ECS::ContainerInstance
|
|
Vous pouvez configurer des sélecteurs d’événements avancés pour filtrer les champs eventName, readOnly et resources.ARN afin de ne journaliser que les événements importants pour vous. Pour plus d’informations sur ces champs, consultez AdvancedFieldSelector dans la Référence des API AWS CloudTrail .
Exemples d’événements Amazon ECS
Un événement représente une demande unique provenant de n'importe quelle source et inclut des informations sur l'opération d'API demandée, la date et l'heure de l'opération, les paramètres de la demande, etc. CloudTrail les fichiers journaux ne constituent pas une pile ordonnée des appels d'API publics, de sorte que les événements n'apparaissent pas dans un ordre spécifique.
L'exemple suivant montre un CloudTrail événement qui démontre CreateService action.
Cet exemple a été mis en forme pour faciliter sa lecture. Dans un CloudTrail fichier journal, toutes les entrées et tous les événements sont concaténés sur une seule ligne. En outre, cet exemple se limite à une seule entrée Amazon ECS. Dans un vrai CloudTrail fichier journal, vous voyez les entrées et les événements de plusieurs AWS services.
{ "eventVersion": "1.04", "userIdentity": { "type": "AssumedRole", "principalId": "AIDACKCEVSQ6C2EXAMPLE:account_name", "arn": "arn:aws:sts::123456789012:user/Mary_Major", "accountId": "123456789012", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2018-06-20T18:32:25Z" }, "sessionIssuer": { "type": "Role", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::123456789012:role/Admin", "accountId": "123456789012", "userName": "Mary_Major" } } }, "eventTime": "2018-06-20T19:04:36Z", "eventSource": "ecs.amazonaws.com", "eventName": "CreateCluster", "awsRegion": "us-east-1", "sourceIPAddress": "203.0.113.12", "userAgent": "console.amazonaws.com", "requestParameters": { "clusterName": "default" }, "responseElements": { "cluster": { "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/default", "pendingTasksCount": 0, "registeredContainerInstancesCount": 0, "status": "ACTIVE", "runningTasksCount": 0, "statistics": [], "clusterName": "default", "activeServicesCount": 0 } }, "requestID": "cb8c167e-EXAMPLE", "eventID": "e3c6f4ce-EXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "123456789012" }
Pour plus d'informations sur CloudTrail contenu de l'enregistrement, voir CloudTrail contenu de l'enregistrement dans le AWS CloudTrail Guide de l'utilisateur.