As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Consultando dados agregados de estatísticas de sessão usando o AWS CLI
<a name="query-session-data"></a>

Para monitorar custos, analisar o uso de recursos ou identificar quais usuários estão consumindo mais recursos, você pode usar o AWS Command Line Interface (AWS CLI) para consultar estatísticas de sessão agregadas para suas fazendas do AWS Deadline Cloud (Deadline Cloud). A API de estatísticas de sessão fornece dados sobre custos, tempo de execução e uso que você pode agrupar por várias dimensões, como fila, frota, tipo de instância ou usuário.

A consulta das estatísticas da sessão é um processo assíncrono. Primeiro, você inicia uma solicitação de agregação e, em seguida, recupera os resultados usando o ID de agregação.

## Iniciando uma solicitação de agregação
<a name="query-session-data-start-aggregation"></a>

Para iniciar uma solicitação de agregação, execute o `start-sessions-statistics-aggregation` comando. O exemplo a seguir agrupa estatísticas por ID de usuário para uma fila específica. Substitua o {{placeholder}} texto por suas informações.

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

Você pode agrupar estatísticas por outras dimensões`QUEUE_ID`, como`FLEET_ID`,`JOB_ID`,`INSTANCE_TYPE`, ou`LICENSE_PRODUCT`. Para obter mais informações sobre todos os parâmetros disponíveis, consulte [start-sessions-statistics-aggregation](https://docs.aws.amazon.com/cli/latest/reference/deadline/start-sessions-statistics-aggregation.html)na Referência de AWS CLI Comandos.

A resposta contém uma ID de agregação:

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

## Recuperando resultados
<a name="query-session-data-get-results"></a>

Execute o `get-sessions-statistics-aggregation` comando com o ID de agregação para recuperar os resultados. Substitua o {{placeholder}} texto por suas informações.

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

O exemplo a seguir mostra uma resposta quando você agrupa estatísticas por ID de usuário. O `userId` campo contém um UUID que você deve mapear para um nome de usuário para identificar o usuário:

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

Para encontrar o nome de usuário associado a um`userId`, consulte[Recuperação de metadados e atributos do usuário usando UserID em um repositório de identidades](query-session-data-map-userid.md).

Para mais informações sobre a API, consulte a [Referência da API Deadline Cloud](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/Welcome.html).

**Tópicos**
+ [Recuperação de metadados e atributos do usuário usando UserID em um repositório de identidades](query-session-data-map-userid.md)