Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Kueri statistik sesi data agregat menggunakan AWS CLI
<a name="query-session-data"></a>

Untuk melacak biaya, menganalisis penggunaan sumber daya, atau mengidentifikasi pengguna mana yang paling banyak menggunakan sumber daya, Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk menanyakan statistik sesi agregat untuk farm AWS Deadline Cloud (Deadline Cloud) Anda. API statistik sesi menyediakan data tentang biaya, runtime, dan penggunaan yang dapat Anda kelompokkan berdasarkan berbagai dimensi seperti antrian, armada, jenis instans, atau pengguna.

Kueri statistik sesi adalah proses asinkron. Pertama, Anda memulai permintaan agregasi, lalu Anda mengambil hasilnya menggunakan ID agregasi.

## Memulai permintaan agregasi
<a name="query-session-data-start-aggregation"></a>

Untuk memulai permintaan agregasi, jalankan `start-sessions-statistics-aggregation` perintah. Contoh berikut mengelompokkan statistik berdasarkan ID pengguna untuk antrian tertentu. Ganti {{placeholder}} teks dengan informasi Anda.

```
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}}
```

Anda dapat mengelompokkan statistik berdasarkan dimensi lain seperti`QUEUE_ID`,`FLEET_ID`,`JOB_ID`,`INSTANCE_TYPE`, atau`LICENSE_PRODUCT`. Untuk informasi selengkapnya tentang semua parameter yang tersedia, lihat [start-sessions-statistics-aggregation](https://docs.aws.amazon.com/cli/latest/reference/deadline/start-sessions-statistics-aggregation.html)di Referensi AWS CLI Perintah.

Respons berisi ID agregasi:

```
{
    "aggregationId": "92b35143f2d04641979bc9b777232f38"
}
```

## Mengambil hasil
<a name="query-session-data-get-results"></a>

Jalankan `get-sessions-statistics-aggregation` perintah dengan ID agregasi untuk mengambil hasilnya. Ganti {{placeholder}} teks dengan informasi Anda.

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

Contoh berikut menunjukkan respons saat Anda mengelompokkan statistik berdasarkan ID pengguna. `userId`Bidang berisi UUID yang harus Anda petakan ke nama pengguna untuk mengidentifikasi pengguna:

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

Untuk menemukan nama pengguna yang terkait dengan a`userId`, lihat[Mengambil metadata dan atribut pengguna menggunakan userId di toko identitas](query-session-data-map-userid.md).

Untuk informasi selengkapnya tentang API, lihat [Referensi API Cloud Deadline](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/Welcome.html).

**Topik**
+ [Mengambil metadata dan atribut pengguna menggunakan userId di toko identitas](query-session-data-map-userid.md)