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.

Escalando los inicios de sesión AWS PC

Los registros de escalado proporcionan un registro de cómo AWS Parallel Computing Service escala los grupos de nodos de procesamiento de su clúster. Cada entrada de registro registra una transición de estado para un nodo de procesamiento: por ejemplo, el lanzamiento de una instancia, el registro de un nodo, una reducción de escala o un error de lanzamiento con el motivo. Puedes usar los registros de escalado para responder a preguntas como por qué un grupo de nodos no alcanzó su tamaño objetivo, qué lanzamientos fallaron por motivos de capacidad y cuándo se inició o detuvo un nodo específico.

Puede enviar registros de escalado a Amazon CloudWatch, Amazon Simple Storage Service (Amazon S3) y Amazon Data Firehose. Para cada transición, AWS PCS registra los siguientes datos:

AWS PCS proporciona registros de escalado según el tipo de PCS_SCALING_LOGS registro. La entrega de registros de escalado es opcional. AWS PCS no entrega registros de escalado para un clúster hasta que usted configure una entrega para él.

Requisitos previos

El director de IAM que administra el clúster de AWS PCS debe permitir la pcs:AllowVendedLogDeliveryForResource acción.

El siguiente ejemplo de política de IAM otorga los permisos necesarios.

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

Configura los registros de escalado

Puede configurar los registros de escalado para su clúster AWS PCS con la tecla Consola de administración de AWS o AWS CLI.

Consola de administración de AWS

Para configurar los registros de escalado con la consola

1. Abra la consola AWS PCS.

2. En el panel de navegación, seleccione Clusters (Clústeres).

3. Elija el clúster en el que desea agregar los registros de escalado.

4. En la página de detalles del clúster, selecciona la pestaña Registros.

5. En Registros de escalado, elija Agregar para agregar hasta 3 destinos de entrega de CloudWatch registros de entre Logs, Amazon S3 y Firehose.

6. Seleccione Actualizar las entregas de registros.

AWS CLI

Para configurar el escalado de los registros con AWS CLI

1. Cree un destino de entrega de registros:

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

   Reemplace:

   • region— El Región de AWS lugar en el que desea crear el destino, como us-east-1

   • pcs-logs-destination— Un nombre para el destino

   • resource-arn— El nombre de recurso de Amazon (ARN) de un grupo de CloudWatch registros de Logs, un bucket de S3 o una secuencia de entrega de Firehose.

   Para obtener más información, consulte la referencia de PutDeliveryDestination la API de Amazon CloudWatch Logs.

2. Configure el clúster PCS como fuente de entrega de registros:

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

   Reemplace:

   • region— El Región de AWS de su clúster, como us-east-1

   • cluster-logs-source-name— Un nombre para la fuente

   • cluster-arn— el ARN de su clúster de AWS PCS

   Para obtener más información, consulte la referencia PutDeliverySource de la API de Amazon CloudWatch Logs.

3. Conecta la fuente de entrega con el destino de entrega:

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

   Reemplace:

   • region— Los Región de AWS, como us-east-1

   • cluster-logs-source— El nombre de su fuente de entrega

   • destination-arn— El ARN de tu destino de entrega

   Para obtener más información, consulte la referencia CreateDelivery de la API de Amazon CloudWatch Logs.

Búsqueda de registros de escalado

Puede configurar los destinos de los CloudWatch registros en Logs y Amazon S3. AWS PCS usa los siguientes nombres de ruta y archivos estructurados.

CloudWatch Registros

AWS PCS usa el siguiente formato de nombre para la transmisión de CloudWatch registros:

AWSLogs/PCS/cluster-id/node_lifecycle.log

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

Amazon S3

AWS PCS usa el siguiente formato de nombre para la ruta S3:

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

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

AWS PCS utiliza el siguiente formato de nombre para los archivos de registro:

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

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

Escalar los campos de registro

AWS PCS escribe los datos de registro de escalado como objetos JSON. Cada entrada de registro contiene campos de metadatos de nivel superior y un details objeto. Los campos de nivel superior identifican el clúster, la hora del evento y los ID del grupo de nodos de cálculo y del nodo planificador. El details objeto contiene los detalles de la transición.

En la tabla siguiente se describen los campos de nivel superior de cada entrada de registro.

En la tabla siguiente se describen las claves que pueden aparecer dentro del details objeto.

Códigos de estado y códigos de motivo

El status_code campo indica el estado en el que ha entrado el nodo. El reason_code campo indica el motivo. Por ejemplo, un LAUNCH_FAILED estado con un INSUFFICIENT_CAPACITY motivo significa que Amazon EC2 no pudo proporcionar capacidad para el tipo de instancia solicitado en la subred de destino. A LIMIT_EXCEEDED significa que una cuota de Amazon EC2 bloqueó el lanzamiento.

Ejemplos de registros de escalado

El siguiente ejemplo muestra el lanzamiento exitoso de una instancia:

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

El siguiente ejemplo muestra un error de lanzamiento provocado por una capacidad insuficiente de EC2. No instance_id está presente porque no se lanzó ninguna instancia.

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