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á.

Registros de escalabilidade AWS PEÇAS

Os registros de escalabilidade fornecem um registro de como o AWS Parallel Computing Service dimensiona os grupos de nós de computação em seu cluster. Cada entrada de registro registra uma transição de estado para um nó de computação: por exemplo, uma inicialização de instância, um registro de nó, uma redução de escala ou uma falha de inicialização com seu motivo. Você pode usar registros de escalabilidade para responder perguntas como por que um grupo de nós não atingiu o tamanho desejado, quais inicializações falharam por motivos de capacidade e quando um nó específico foi iniciado ou interrompido.

Você pode enviar logs de escalabilidade para a Amazon CloudWatch, Amazon Simple Storage Service (Amazon S3) e Amazon Data Firehose. Para cada transição, o AWS PCS registra os seguintes dados:

AWS O PCS fornece registros de escalabilidade por meio do tipo de PCS_SCALING_LOGS registro. O escalonamento da entrega de registros é opcional. AWS O PCS não entrega registros de escalabilidade para um cluster até que você configure uma entrega para ele.

Pré-requisitos

O principal do IAM que gerencia o cluster AWS PCS deve permitir a pcs:AllowVendedLogDeliveryForResource ação.

O exemplo de política do IAM a seguir concede as permissões necessárias.

{
    "Version": "2012-10-17",
    "Statement": [ 
        {
            "Sid": "PcsAllowVendedLogsDelivery",
            "Effect": "Allow",
            "Action": ["pcs:AllowVendedLogDeliveryForResource"],
            "Resource": [
                "arn:aws:pcs:*::cluster/*"
            ]
        }
    ]
}

Configurar registros de escalabilidade

Você pode configurar registros de escalabilidade para seu cluster AWS PCS com o Console de gerenciamento da AWS ou AWS CLI.

Console de gerenciamento da AWS

Para configurar registros de escalabilidade com o console

1. Abra o console AWS PCS.

2. No painel de navegação, escolha Clusters.

3. Escolha o cluster em que você deseja adicionar registros de escalabilidade.

4. Na página de detalhes do cluster, escolha a guia Logs.

5. Em Scaling Logs, escolha Adicionar para adicionar até 3 destinos de entrega de log entre CloudWatch Logs, Amazon S3 e Firehose.

6. Escolha Atualizar entregas de registros.

AWS CLI

Para configurar registros de escalabilidade com o AWS CLI

1. Crie um destino de entrega de registros:

   aws logs put-delivery-destination --region region \
     --name pcs-logs-destination \
     --delivery-destination-configuration \
     destinationResourceArn=resource-arn

   Substitua:

   • region— O Região da AWS local onde você deseja criar o destino, como us-east-1

   • pcs-logs-destination— Um nome para o destino

   • resource-arn— O nome de recurso da Amazon (ARN) de um grupo de CloudWatch logs do Logs, bucket do S3 ou stream de entrega do Firehose.

   Para obter mais informações, consulte PutDeliveryDestination a Referência da API Amazon CloudWatch Logs.

2. Defina o cluster PCS como uma fonte de entrega de log:

   aws logs put-delivery-source --region region \
     --name cluster-logs-source-name \
     --resource-arn cluster-arn \
     --log-type PCS_SCALING_LOGS

   Substitua:

   • region— O Região da AWS do seu cluster, como us-east-1

   • cluster-logs-source-name— Um nome para a fonte

   • cluster-arn— o ARN do seu cluster AWS PCS

   Para obter mais informações, consulte PutDeliverySource a Referência da API Amazon CloudWatch Logs.

3. Conecte a fonte de entrega ao destino da entrega:

   aws logs create-delivery --region region \
     --delivery-source-name cluster-logs-source \
     --delivery-destination-arn destination-arn

   Substitua:

   • region— O Região da AWS, como us-east-1

   • cluster-logs-source— O nome da sua fonte de entrega

   • destination-arn— O ARN do seu destino de entrega

   Para obter mais informações, consulte CreateDelivery a Referência da API Amazon CloudWatch Logs.

Encontrando registros de escalabilidade

Você pode configurar destinos de log no CloudWatch Logs e no Amazon S3. AWS O PCS usa os seguintes nomes de caminhos estruturados e nomes de arquivo.

CloudWatch Registros

AWS O PCS usa o seguinte formato de nome para o fluxo de CloudWatch registros:

AWSLogs/PCS/cluster-id/node_lifecycle.log

Por exemplo: AWSLogs/PCS/pcs_abc123de45/node_lifecycle.log

Amazon S3

AWS O PCS usa o seguinte formato de nome para o caminho S3:

AWSLogs/account-id/PCS/region/cluster-id/node_lifecycle/year/month/day/hour/

Por exemplo: AWSLogs/111122223333/PCS/us-east-1/pcs_abc123de45/node_lifecycle/2026/09/03/11/

AWS O PCS usa o seguinte formato de nome para os arquivos de log:

PCS_cluster-id_node_lifecycle_year-month-day-hour_random-id.log.gz

Por exemplo: PCS_pcs_abc123de45_node_lifecycle_2026-09-03-11_04be080b.log.gz

Campos de registro de escalabilidade

AWS O PCS grava dados de log de escalabilidade como objetos JSON. Cada entrada de registro contém campos de metadados de nível superior e um details objeto. Os campos de nível superior identificam o cluster, a hora do evento e os IDs do grupo de nós de computação e dos nós do agendador. O details objeto contém os detalhes da transição.

A tabela a seguir descreve os campos de nível superior em cada entrada de registro.

A tabela a seguir descreve as chaves que podem aparecer dentro do details objeto.

Códigos de status e códigos de motivo

O status_code campo informa o estado em que o nó entrou. O reason_code campo explica o porquê. Por exemplo, um LAUNCH_FAILED status com um INSUFFICIENT_CAPACITY motivo significa que o Amazon EC2 não pôde fornecer capacidade para o tipo de instância solicitado na sub-rede de destino. A LIMIT_EXCEEDED significa que uma cota do Amazon EC2 bloqueou o lançamento.

Exemplos de registros de escalabilidade

O exemplo a seguir mostra o lançamento bem-sucedido de uma instância:

{
    "resource_id": "pcs_abc123de45",
    "resource_type": "PCS_CLUSTER",
    "event_timestamp": 1789179816460,
    "compute_node_group_id": "pcs_abcdef01",
    "scheduler_node_id": "compute-1",
    "status_code": "LAUNCHED",
    "reason_code": "SCHEDULER_REQUESTED",
    "description": "Instance launched to satisfy a scheduler scale-up request.",
    "details": {
        "instance_id": "i-0abc12345def67890",
        "instance_type": "c6i.xlarge",
        "subnet_id": "subnet-0123456789abcdef0"
    }
}

O exemplo a seguir mostra uma falha de inicialização causada pela capacidade insuficiente do EC2. Não instance_id está presente porque nenhuma instância foi iniciada.

{
    "resource_id": "pcs_abc123de45",
    "resource_type": "PCS_CLUSTER",
    "event_timestamp": 1789179816460,
    "compute_node_group_id": "pcs_abcdef01",
    "scheduler_node_id": "compute-2",
    "status_code": "LAUNCH_FAILED",
    "reason_code": "INSUFFICIENT_CAPACITY",
    "description": "Node did not get an instance because there was not enough capacity available.",
    "details": {
        "ec2_error_code": "InsufficientInstanceCapacity"
    }
}