기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 를 사용하여 세션 통계 집계 데이터 쿼리 AWS CLI
<a name="query-session-data"></a>

비용을 추적하거나, 리소스 사용량을 분석하거나, 리소스를 가장 많이 사용하는 사용자를 식별하려면 AWS Command Line Interface (AWS CLI)를 사용하여 AWS Deadline Cloud(Deadline Cloud) 팜에 대한 집계된 세션 통계를 쿼리할 수 있습니다. 세션 통계 API는 대기열, 플릿, 인스턴스 유형 또는 사용자와 같은 다양한 차원별로 그룹화할 수 있는 비용, 런타임 및 사용량에 대한 데이터를 제공합니다.

세션 통계 쿼리는 비동기 프로세스입니다. 먼저 집계 요청을 시작한 다음 집계 ID를 사용하여 결과를 검색합니다.

## 집계 요청 시작
<a name="query-session-data-start-aggregation"></a>

집계 요청을 시작하려면 `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_ID` `INSTANCE_TYPE`또는와 같은 다른 차원별로 통계를 그룹화할 수 있습니다`LICENSE_PRODUCT`. 사용 가능한 모든 파라미터에 대한 자세한 내용은 AWS CLI 명령 참조의 [start-sessions-statistics-aggregation](https://docs.aws.amazon.com/cli/latest/reference/deadline/start-sessions-statistics-aggregation.html)을 참조하세요.

응답에는 집계 ID가 포함됩니다.

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

## 결과 검색
<a name="query-session-data-get-results"></a>

집계 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를 사용하여 사용자 메타데이터 및 속성 검색](query-session-data-map-userid.md).

API에 대한 자세한 내용은 [Deadline Cloud API 참조](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/Welcome.html)를 참조하세요.

**주제**
+ [ID 스토어에서 userID를 사용하여 사용자 메타데이터 및 속성 검색](query-session-data-map-userid.md)