Journalisation des appels d'API Amazon SageMaker AI à l'aide de AWS CloudTrail

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.

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.

Amazon SageMaker AI est intégré à AWS CloudTrailun service qui fournit un enregistrement des actions entreprises par un utilisateur, un rôle ou un Service AWS. CloudTrail capture tous les appels d'API pour Amazon SageMaker AI sous forme d'événements. Les appels capturés incluent des appels provenant de la console Amazon SageMaker AI et des appels de code vers les opérations de l'API Amazon SageMaker AI. À l'aide des informations collectées par CloudTrail, vous pouvez déterminer la demande envoyée à Amazon SageMaker AI, 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 :

CloudTrail est actif dans votre compte Compte AWS lorsque vous créez le compte et vous avez automatiquement accès à l'historique des CloudTrail événements. L'historique des CloudTrail événements 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, consultez la section Utilisation de l'historique des CloudTrail événements dans le guide de AWS CloudTrail l'utilisateur. La consultation de CloudTrail l'historique des événements est gratuite.

Pour un enregistrement continu des événements de vos 90 Compte AWS derniers jours, créez un magasin de données sur les événements de Trail ou CloudTrailLake.

Pour des raisons de sécurité, vous pouvez surveiller CloudTrail les journaux pour identifier les activités anormales des utilisateurs. Pour plus d'informations sur les journaux de surveillance, consultezJournalisation et surveillance.

Événements liés aux données Amazon SageMaker AI 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, lecture ou écriture de données dans un objet Amazon S3). 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 CloudTrail Tarification.

Vous pouvez enregistrer des événements de données pour différents types de ressources Amazon SageMaker AI à l'aide de la CloudTrail console ou des opérations CloudTrail d'API. AWS CLI 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 AWS Management Console 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 SageMaker AI pour lesquels vous pouvez enregistrer des événements de données. La colonne Type de ressource (console) indique la valeur à choisir dans la liste des types de ressources 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 du ou. AWS CLI CloudTrail APIs La CloudTrail colonne Données APIs enregistrées indique les appels d'API enregistrés CloudTrail pour le type de ressource.

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, voir AdvancedFieldSelector dans la Référence d'API AWS CloudTrail

L'exemple suivant vous montre comment enregistrer des événements de données pour un point de SageMaker terminaison Amazon. Dans cet exemple, vous utilisez la put-event-selectors AWS CLI commande pour ajouter des sélecteurs d'événements avancés qui capturent les événements de données de votre point de terminaison. Vous devez avoir un CloudTrail sentier existant. Avant d'exécuter la commande, vous pouvez également enregistrer l'objet JSON des sélecteurs d'événements avancés dans un fichier tel que celui-ci :

[
  {
    "FieldSelectors": [
      {
        "Field": "eventCategory",
        "Equals": ["Data"]
      },
      {
        "Field": "resources.ARN",
        "Equals": ["arn:aws:sagemaker:us-east-1:111122223333:endpoint/your-inference-endpoint-arn"]
      },
      {
        "Field": "resources.type",
        "Equals": ["AWS::SageMaker::Endpoint"]
      }
    ]
  }
]

Vous pouvez ensuite exécuter la commande suivante pour commencer à enregistrer les événements de données à partir du point de terminaison.

aws cloudtrail put-event-selectors
      --trail-name your-trail-name
      --advanced-event-selectors=file://advanced-event-selectors.json # specify your previously created JSON file

Événements de gestion Amazon SageMaker AI dans CloudTrail

Les événements de gestion fournissent 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 SageMaker AI enregistre toutes les opérations du plan de contrôle Amazon SageMaker AI en tant qu'événements de gestion. Pour obtenir la liste des opérations du plan de contrôle Amazon SageMaker AI auxquelles Amazon SageMaker AI se connecte CloudTrail, consultez le manuel Amazon SageMaker AI API Reference.

Opérations effectuées par le réglage de modèle automatique

SageMaker L'IA prend en charge l'enregistrement des événements de service non liés à l'API dans vos fichiers CloudTrail journaux pour les tâches de réglage automatique des modèles. Ces événements sont liés à vos tâches de réglage mais ne sont pas le résultat direct d'une demande d'un client adressée à l' AWS API publique. Par exemple, lorsque vous créez une tâche de réglage d'hyperparamètres en appelant CreateHyperParameterTuningJob, l' SageMaker IA crée des tâches de formation pour évaluer différentes combinaisons d'hyperparamètres afin de trouver le meilleur résultat. De même, lorsque vous appelez StopHyperParameterTuningJobpour arrêter une tâche de réglage d'hyperparamètres, l' SageMaker IA peut arrêter l'une des tâches d'entraînement en cours associées. Les événements non liés à l'API liés à vos tâches de réglage sont enregistrés CloudTrail afin de vous aider à améliorer la gouvernance, la conformité, ainsi que l'audit des opérations et des risques de votre AWS compte.

Les entrées de journal générées par les événements de services non-API ont un eventType de AwsServiceEvent au lieu de AwsApiCall.

Exemples d'événements Amazon SageMaker AI

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 trace ordonnée des appels d'API publics. Les événements n'apparaissent donc pas dans un ordre spécifique.

L'exemple suivant montre un CloudTrail événement illustrant l'CreateEndpointopération.

{
    "eventVersion":"1.05",
    "userIdentity": {
        "type":"IAMUser",
        "principalId":"AIXDAYQEXAMPLEUMLYNGL",
        "arn":"arn:aws:iam::123456789012:user/intern",
        "accountId":"123456789012",
        "accessKeyId":"ASXIAGXEXAMPLEQULKNXV",
        "userName":"intern"
    },
    "eventTime":"2018-01-02T13:39:06Z",
    "eventSource":"sagemaker.amazonaws.com",
    "eventName":"CreateEndpoint",
    "awsRegion":"us-west-2",
    "sourceIPAddress":"127.0.0.1",
    "userAgent":"USER_AGENT",
    "requestParameters": {
        "endpointName":"ExampleEndpoint",
        "endpointConfigName":"ExampleEndpointConfig"
    },
    "responseElements": {
        "endpointArn":"arn:aws:sagemaker:us-west-2:123456789012:endpoint/exampleendpoint"
    },
    "requestID":"6b1b42b9-EXAMPLE",
    "eventID":"a6f85b21-EXAMPLE",
    "eventType":"AwsApiCall",
    "recipientAccountId":"444455556666"
}

L'exemple suivant montre un CloudTrail événement illustrant l'CreateModelopération.

{
    "eventVersion":"1.05",
    "userIdentity": {
        "type":"IAMUser",
        "principalId":"AIXDAYQEXAMPLEUMLYNGL",
        "arn":"arn:aws:iam::123456789012:user/intern",
        "accountId":"123456789012",
        "accessKeyId":"ASXIAGXEXAMPLEQULKNXV",
        "userName":"intern"
    },
    "eventTime":"2018-01-02T15:23:46Z",
    "eventSource":"sagemaker.amazonaws.com",
    "eventName":"CreateModel",
    "awsRegion":"us-west-2",
    "sourceIPAddress":"127.0.0.1",
    "userAgent":"USER_AGENT",
    "requestParameters": {
        "modelName":"ExampleModel",
        "primaryContainer": {
            "image":"174872318107.dkr.ecr.us-west-2.amazonaws.com/kmeans:latest"
        },
        "executionRoleArn":"arn:aws:iam::123456789012:role/EXAMPLEARN"
    },
    "responseElements": {
        "modelArn":"arn:aws:sagemaker:us-west-2:123456789012:model/barkinghappy2018-01-02t15-23-32-275z-ivrdog"
    },
    "requestID":"417b8dab-EXAMPLE",
    "eventID":"0f2b3e81-EXAMPLE",
    "eventType":"AwsApiCall",
    "recipientAccountId":"444455556666"
}

Pour plus d'informations sur le contenu des CloudTrail enregistrements, voir le contenu des CloudTrail enregistrements dans le Guide de AWS CloudTrail l'utilisateur.