View a markdown version of this page

Interrogation de données agrégées sur les statistiques de session à l'aide du AWS CLI - Deadline Cloud
Lancer une demande d'agrégationRécupération des résultats

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.

Interrogation de données agrégées sur les statistiques de session à l'aide du AWS CLI

Pour suivre les coûts, analyser l'utilisation des ressources ou identifier les utilisateurs qui consomment le plus de ressources, vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour consulter les statistiques de session agrégées de vos fermes AWS Deadline Cloud (Deadline Cloud). L'API de statistiques de session fournit des données sur les coûts, le temps d'exécution et l'utilisation que vous pouvez regrouper selon différentes dimensions telles que la file d'attente, le parc, le type d'instance ou l'utilisateur.

L'interrogation des statistiques de session est un processus asynchrone. Tout d'abord, vous lancez une demande d'agrégation, puis vous récupérez les résultats à l'aide de l'ID d'agrégation.

Lancer une demande d'agrégation

Pour démarrer une demande d'agrégation, exécutez la start-sessions-statistics-aggregation commande. L'exemple suivant regroupe les statistiques par ID utilisateur pour une file d'attente spécifique. Remplacez le placeholder texte par vos informations.

aws deadline start-sessions-statistics-aggregation \
    --farm-id farm-id \
    --resource-ids '{"queueIds":["queue-id"]}' \
    --start-time 2025-11-24T10:00:00Z \
    --end-time 2025-11-25T18:00:00Z \
    --group-by '["USER_ID"]' \
    --period HOURLY \
    --statistics '["SUM"]' \
    --timezone UTC-08:00 \
    --region region-name

Vous pouvez regrouper les statistiques selon d'autres dimensions telles que QUEUE_IDFLEET_ID,JOB_ID,INSTANCE_TYPE, ouLICENSE_PRODUCT. Pour plus d'informations sur tous les paramètres disponibles, consultez start-sessions-statistics-aggregationla référence des AWS CLI commandes.

La réponse contient un identifiant d'agrégation :

{
    "aggregationId": "92b35143f2d04641979bc9b777232f38"
}

Récupération des résultats

Exécutez la get-sessions-statistics-aggregation commande avec l'ID d'agrégation pour récupérer les résultats. Remplacez le placeholder texte par vos informations.

aws deadline get-sessions-statistics-aggregation \
    --farm-id farm-id \
    --aggregation-id aggregation-id \
    --region region-name

L'exemple suivant montre une réponse lorsque vous regroupez les statistiques par ID utilisateur. Le userId champ contient un UUID que vous devez associer à un nom d'utilisateur pour identifier l'utilisateur :

{
    "statistics": [
        {
            "userId": "f9c1f3f0-1031-70dc-4d25-30d7225b04a0",
            "count": 1,
            "costInUsd": {
                "sum": 0.0
            },
            "runtimeInSeconds": {
                "sum": 53.773
            },
            "aggregationStartTime": "2025-11-24T22:00:00Z",
            "aggregationEndTime": "2025-11-24T23:00:00Z"
        }
    ],
    "status": "COMPLETED"
}

Pour trouver le nom d'utilisateur associé à unuserId, consultezRécupération des métadonnées et des attributs utilisateur à l'aide de l'ID utilisateur dans un magasin d'identités.

Pour plus d'informations sur l'API, consultez le document de référence de l'API Deadline Cloud.

Rubriques