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 Amazon GameLift Streams à l'aide de AWS CloudTrail
Amazon GameLift Streams est intégré à AWS CloudTrail un 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 GameLift Streams sous forme d'événements. Les appels capturés incluent les appels depuis la console Amazon GameLift Streams et les appels de code vers les opérations de l'API Amazon GameLift Streams. À l'aide des informations collectées par CloudTrail, vous pouvez déterminer la demande qui a été faite à Amazon GameLift Streams, 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 Compte AWS lorsque vous créez votre 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 survenus au cours de vos 90 Compte AWS derniers jours, créez un sentier ou une banque de données sur les événements CloudTrail Lake.
- CloudTrail sentiers
-
Un journal permet CloudTrail de 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 historique multirégional, car vous pouvez enregistrer l'activité dans l'ensemble Régions AWS de 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 un historique, mais des frais de stockage Amazon S3 sont facturés. Pour plus d'informations sur la CloudTrail tarification, consultez la section 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 Lake vous permet de lancer SQL-based des requêtes sur vos événements. CloudTrail Lake convertit les événements existants au format JSON basé sur les lignes au format Apache
ORC. 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 Lake, consultez la section Utilisation de AWS CloudTrail Lake dans le Guide de AWS CloudTrail 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 la CloudTrail tarification, consultez la section AWS CloudTrail Tarification
.
Événements de données Amazon GameLift Streams 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, le démarrage d'une session de diffusion dans un groupe de flux). 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 à fort volume. 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 les événements de données pour les types de ressources Amazon GameLift Streams à 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 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 GameLift Streams pour lesquels vous pouvez enregistrer les événements liés aux 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 des API or. AWS CLI CloudTrail La CloudTrail colonne API de données enregistrées dans affiche les appels d'API enregistrés CloudTrail pour le type de ressource.
| Type de ressource (console) | valeur resources.type | API de données connectées CloudTrail |
|---|---|---|
| GameLift Application Streams |
AWS::GameLiftStreams::Application
|
|
| GameLift Groupe de flux Streams |
AWS::GameLiftStreams::StreamGroup
|
CloudTrail enregistre les opérations de l'API d'URL de flux (CreateStreamUrl, GetStreamUrlListStreamUrls, etRevokeStreamUrl) en tant qu'événements de données, de la même manière qu'il enregistre les autres opérations de session de flux. Lorsqu'un utilisateur final active une URL de flux pour démarrer une session de streaming, Amazon GameLift Streams gère cette activation pour le compte de l'utilisateur final afin de ne pas enregistrer l'activation en tant qu'appel d'API client. Votre enregistrement vérifiable de l'activité de l'URL du flux est l'CreateStreamUrlappel qui a créé l'URL du flux et l'RevokeStreamUrlappel qui l'a révoquée. Pour voir les sessions démarrées à partir d'une URL de diffusion, utilisezGetStreamUrl.
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 .
Événements de gestion Amazon GameLift Streams 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 GameLift Streams enregistre les opérations suivantes du plan de contrôle Amazon GameLift Streams en CloudTrail tant qu'événements de gestion.
Exemples d'événements Amazon GameLift Streams
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 événement CloudTrail de gestion qui illustre l'CreateApplicationopération.
{ "eventVersion": "1.09", "userIdentity": { "type": "AssumedRole", "principalId": "AROA123456789EXAMPLE:assume-temporary-gameliftstreams-access-role", "arn": "arn:aws:sts::111122223333:assumed-role/GameLiftStreamsTestRole/assume-temporary-gameliftstreams-access-role", "accountId": "111122223333", "accessKeyId": "ASIAIOSFODNN7EXAMPLE", "sessionContext": { "sessionIssuer": { "type": "Role", "principalId": "AROA123456789EXAMPLE", "arn": "arn:aws:iam::111122223333:role/GameLiftStreamsTestRole", "accountId": "111122223333", "userName": "GameLiftStreamsTestRole" }, "webIdFederationData": {}, "attributes": { "creationDate": "2025-07-23T21:18:19Z", "mfaAuthenticated": "false" } } }, "eventTime": "2025-07-23T21:58:54Z", "eventSource": "gameliftstreams.amazonaws.com", "eventName": "CreateApplication", "awsRegion": "us-west-2", "sourceIPAddress": "203.0.113.0", "userAgent": "aws-sdk-javascript/2.0.0 Linux/4.14.291-218.527.amzn2.x86_64 OpenJDK_64-Bit_Server_VM/11.0.17+9-LTS Java/11.0.17 vendor/Amazon.com_Inc. exec-env/AWS_ECS_FARGATE io/sync http/Apache cfg/retry-mode/legacy", "requestParameters": { "ApplicationSourceUri": "s3://amzn-s3-demo-bucket/MyGame", "Description": "MyGame canary - Proton 8", "RuntimeEnvironment": { "Type": "PROTON", "Version": "20230704" }, "ClientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "ExecutablePath": "MyGame100.exe" }, "responseElements": { "Status": "INITIALIZED", "ApplicationSourceUri": "s3://amzn-s3-demo-bucket/MyGame", "Description": "MyGame canary - Proton 8", "RuntimeEnvironment": { "Type": "PROTON", "Version": "20230704" }, "LastUpdatedAt": 1753307934.293, "CreatedAt": 1753307934.293, "Id": "a-9ZY8X7Wv6", "Arn": "arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6", "ExecutablePath": "MyGame100.exe" }, "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLEbbbbb", "readOnly": false, "eventType": "AwsApiCall", "managementEvent": true, "recipientAccountId": "111122223333", "eventCategory": "Management" }
L'exemple suivant montre un événement de CloudTrail données provenant d'un journal de suivi qui illustre l'StartStreamSessionopération.
{ "Records": [ { "eventVersion": "1.09", "userIdentity": { "type": "AssumedRole", "principalId": "AROA123456789EXAMPLE:assume-temporary-gameliftstreams-access-role", "arn": "arn:aws:sts::111122223333:assumed-role/GameLiftStreamsTestRole/assume-temporary-gameliftstreams-access-role", "accountId": "111122223333", "accessKeyId": "ASIAIOSFODNN7EXAMPLE", "sessionContext": { "sessionIssuer": { "type": "Role", "principalId": "AROA123456789EXAMPLE", "arn": "arn:aws:iam::111122223333:role/GameLiftStreamsTestRole", "accountId": "111122223333", "userName": "GameLiftStreamsTestRole" }, "attributes": { "creationDate": "2025-07-23T21:18:19Z", "mfaAuthenticated": "false" } } }, "eventTime": "2025-07-23T23:43:46Z", "eventSource": "gameliftstreams.amazonaws.com", "eventName": "StartStreamSession", "awsRegion": "us-east-2", "sourceIPAddress": "203.0.113.0", "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36", "requestParameters": { "Identifier": "sg-1AB2C3De4", "Description": "StreamGroup sg-1AB2C3De4 Application a-9ZY8X7Wv6 Console stream", "AdditionalLaunchArgs": [], "UserId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "Locations": [ "us-east-2" ], "SignalRequest": "***", "Protocol": "WebRTC", "ApplicationIdentifier": "a-9ZY8X7Wv6", "ClientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "ConnectionTimeoutSeconds": 100, "AdditionalEnvironmentVariables": {} }, "responseElements": { "Status": "ACTIVATING", "ApplicationArn": "arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6", "Description": "StreamGroup sg-1AB2C3De4 Application a-9ZY8X7Wv6 Console stream", "LastUpdatedAt": 1.753314225925E9, "CreatedAt": 1.753314225925E9, "AdditionalEnvironmentVariables": {}, "ConnectionTimeoutSeconds": 100, "AdditionalLaunchArgs": [], "StreamGroupId": "sg-1AB2C3De4", "UserId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "SessionLengthSeconds": 43200, "SignalRequest": "***", "Arn": "arn:aws:gameliftstreams:us-west-2:111122223333:streamsession/sg-1AB2C3De4/ABC123def4567", "Protocol": "WebRTC", "WebSdkProtocolUrl": "https://123456789012.cloudfront.net/e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855.js" }, "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa", "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLEbbbbb", "readOnly": false, "resources": [ { "accountId": "111122223333", "type": "AWS::GameLiftStreams::StreamGroup", "ARN": "arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4" }, { "accountId": "111122223333", "type": "AWS::GameLiftStreams::Application", "ARN": "arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6" } ], "eventType": "AwsApiCall", "managementEvent": false, "recipientAccountId": "111122223333", "eventCategory": "Data" } ] }
Pour plus d'informations sur le contenu des CloudTrail enregistrements, reportez-vous à la section Contenu des CloudTrail enregistrements dans le Guide de AWS CloudTrail l'utilisateur.
