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

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

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 dimensionesQUEUE_ID, como FLEET_IDJOB_ID,INSTANCE_TYPE, oLICENSE_PRODUCT. Para obtener más información sobre todos los parámetros disponibles, consulte start-sessions-statistics-aggregationla Referencia de AWS CLI comandos.

La respuesta contiene un identificador de agregación:

{
    "aggregationId": "92b35143f2d04641979bc9b777232f38"
}

Recuperación de resultados

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 auserId, consulteRecuperación de metadatos y atributos de usuario mediante el ID de usuario de un almacén de identidades.

Para obtener más información sobre la API, consulta la referencia de la API de Deadline Cloud.