を使用したセッション統計の集計データのクエリ AWS CLI

コストを追跡したり、リソースの使用状況を分析したり、どのユーザーが最も多くリソースを消費しているかを特定したりするには、 AWS Command Line Interface (AWS CLI) を使用して AWS Deadline Cloud (Deadline Cloud) ファームの集約セッション統計をクエリできます。セッション統計 API は、キュー、フリート、インスタンスタイプ、ユーザーなどのさまざまなディメンション別にグループ化できるコスト、ランタイム、使用状況に関するデータを提供します。

セッション統計のクエリは非同期プロセスです。まず集約リクエストを開始し、次に集約 ID を使用して結果を取得します。

集約リクエストの開始

集約リクエストを開始するには、 start-sessions-statistics-aggregation コマンドを実行します。次の の例では、特定のキューのユーザー ID で統計をグループ化します。プレースホルダーテキストを自分の情報に置き換えます。

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

統計は、、QUEUE_ID、FLEET_ID、JOB_IDINSTANCE_TYPE、 などの他のディメンションでグループ化できますLICENSE_PRODUCT。使用可能なすべてのパラメータの詳細については、 AWS CLI 「 コマンドリファレンス」のstart-sessions-statistics-aggregation」を参照してください。

レスポンスには集約 ID が含まれます。

{
    "aggregationId": "92b35143f2d04641979bc9b777232f38"
}

結果を取得する

集計 ID を使用して get-sessions-statistics-aggregation コマンドを実行して、結果を取得します。プレースホルダーテキストを自分の情報に置き換えます。

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

次の例は、統計をユーザー ID でグループ化する場合のレスポンスを示しています。userId フィールドには、ユーザーを識別するためにユーザー名にマッピングする必要がある UUID が含まれています。

{
    "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"
}

に関連付けられているユーザー名を確認するにはuserId、「」を参照してくださいID ストアで userID を使用してユーザーメタデータと属性を取得する。

API の詳細については、「Deadline Cloud API リファレンス」を参照してください。

トピック

• ID ストアで userID を使用してユーザーメタデータと属性を取得する