Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Consulta de datos agregados de estadísticas de sesión mediante el AWS CLI
<a name="query-session-data"></a>

Para realizar un seguimiento de los costes, analizar el uso de los recursos o identificar qué usuarios consumen más recursos, puedes utilizar AWS Command Line Interface (AWS CLI) para consultar las estadísticas de sesión agregadas de tus granjas de AWS Deadline Cloud (Deadline Cloud). La API de estadísticas de sesión proporciona datos sobre los costes, el tiempo de ejecución y el uso que puedes agrupar por diversas dimensiones, como cola, flota, tipo de instancia o usuario.

La consulta de las estadísticas de la sesión es un proceso asíncrono. En primer lugar, se inicia una solicitud de agregación y, a continuación, se recuperan los resultados mediante el ID de agregación.

## Iniciar una solicitud de agregación
<a name="query-session-data-start-aggregation"></a>

Para iniciar una solicitud de agregación, ejecute el `start-sessions-statistics-aggregation` comando. En el siguiente ejemplo, se agrupan las estadísticas por ID de usuario para una cola específica. Sustituya el {{placeholder}} texto por su información.

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

Puede agrupar las estadísticas por otras dimensiones`QUEUE_ID`, como `FLEET_ID``JOB_ID`,`INSTANCE_TYPE`, o`LICENSE_PRODUCT`. Para obtener más información sobre todos los parámetros disponibles, consulte [start-sessions-statistics-aggregation](https://docs.aws.amazon.com/cli/latest/reference/deadline/start-sessions-statistics-aggregation.html)la Referencia de AWS CLI comandos.

La respuesta contiene un identificador de agregación:

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

## Recuperación de resultados
<a name="query-session-data-get-results"></a>

Ejecute el `get-sessions-statistics-aggregation` comando con el ID de agregación para recuperar los resultados. Sustituya el {{placeholder}} texto por su información.

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

En el siguiente ejemplo, se muestra una respuesta al agrupar las estadísticas por ID de usuario. El `userId` campo contiene un UUID que debe asignar a un nombre de usuario para identificar al usuario:

```
{
    "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 el nombre de usuario asociado a a`userId`, consulte[Recuperación de metadatos y atributos de usuario mediante el ID de usuario de un almacén de identidades](query-session-data-map-userid.md).

Para obtener más información sobre la API, consulta la [referencia de la API de Deadline Cloud](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/Welcome.html).

**Temas**
+ [Recuperación de metadatos y atributos de usuario mediante el ID de usuario de un almacén de identidades](query-session-data-map-userid.md)