Consultando dados agregados de estatísticas de sessão usando o AWS CLI

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

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õesQUEUE_ID, comoFLEET_ID,JOB_ID,INSTANCE_TYPE, ouLICENSE_PRODUCT. Para obter mais informações sobre todos os parâmetros disponíveis, consulte start-sessions-statistics-aggregationna Referência de AWS CLI Comandos.

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

{
    "aggregationId": "92b35143f2d04641979bc9b777232f38"
}

Recuperando resultados

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 umuserId, consulteRecuperação de metadados e atributos do usuário usando UserID em um repositório de identidades.

Para mais informações sobre a API, consulte a Referência da API Deadline Cloud.

Tópicos

• Recuperação de metadados e atributos do usuário usando UserID em um repositório de identidades