Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Scaling se connecte AWS PIÈCES

Les journaux de dimensionnement vous permettent d'enregistrer la manière dont AWS Parallel Computing Service adapte les groupes de nœuds de calcul de votre cluster. Chaque entrée de journal enregistre une transition d'état pour un nœud de calcul : par exemple, le lancement d'une instance, l'enregistrement d'un nœud, une réduction d'échelle ou un échec de lancement avec sa raison. Vous pouvez utiliser les journaux de dimensionnement pour répondre à des questions telles que pourquoi un groupe de nœuds n'a pas atteint sa taille cible, quels lancements ont échoué pour des raisons de capacité et quand un nœud spécifique a démarré ou s'est arrêté.

Vous pouvez envoyer des journaux de dimensionnement à Amazon CloudWatch, Amazon Simple Storage Service (Amazon S3) et Amazon Data Firehose. Pour chaque transition, AWS PCS enregistre les données suivantes :

AWS PCS fournit des journaux de dimensionnement via le type de PCS_SCALING_LOGS journal. La mise à l'échelle de la livraison des journaux est optionnelle. AWS PCS ne fournit pas de journaux de dimensionnement pour un cluster tant que vous n'avez pas configuré une livraison pour celui-ci.

Conditions préalables

Le principal IAM qui gère le cluster AWS PCS doit autoriser l'pcs:AllowVendedLogDeliveryForResourceaction.

L'exemple de politique IAM suivant accorde les autorisations requises.

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

Configurer des journaux de dimensionnement

Vous pouvez configurer des journaux de dimensionnement pour votre cluster AWS PCS à l'aide du Console de gestion AWS ou AWS CLI.

Console de gestion AWS

Pour configurer les journaux de dimensionnement à l'aide de la console

1. Ouvrez la console AWS PCS.

2. Dans le panneau de navigation, choisissez Clusters.

3. Choisissez le cluster dans lequel vous souhaitez ajouter des journaux de dimensionnement.

4. Sur la page des détails du cluster, choisissez l'onglet Journaux.

5. Dans Scaling Logs, choisissez Ajouter pour ajouter jusqu'à 3 destinations de livraison des CloudWatch journaux parmi Logs, Amazon S3 et Firehose.

6. Choisissez Mettre à jour les livraisons de journaux.

AWS CLI

Pour configurer des journaux de dimensionnement avec AWS CLI

1. Créez une destination de livraison des journaux :

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

   Remplacez :

   • region— L' Région AWS endroit où vous souhaitez créer la destination, par exemple us-east-1

   • pcs-logs-destination— Un nom pour la destination

   • resource-arn— Le nom de ressource Amazon (ARN) d'un groupe de CloudWatch journaux Logs, d'un bucket S3 ou d'un flux de diffusion Firehose.

   Pour plus d'informations, consultez PutDeliveryDestination le manuel Amazon CloudWatch Logs API Reference.

2. Définissez le cluster PCS comme source de livraison de journaux :

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

   Remplacez :

   • region— Le Région AWS de votre cluster, tel que us-east-1

   • cluster-logs-source-name— Un nom pour la source

   • cluster-arn— l'ARN de votre cluster AWS PCS

   Pour plus d'informations, consultez PutDeliverySource le manuel Amazon CloudWatch Logs API Reference.

3. Connectez la source de livraison à la destination de livraison :

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

   Remplacez :

   • region— Les Région AWS, tels que us-east-1

   • cluster-logs-source— Le nom de votre source de livraison

   • destination-arn— L'ARN de votre destination de livraison

   Pour plus d'informations, consultez CreateDelivery le manuel Amazon CloudWatch Logs API Reference.

Recherche de journaux de dimensionnement

Vous pouvez configurer les destinations des CloudWatch journaux dans Logs et Amazon S3. AWS PCS utilise les noms de chemin et de fichier structurés suivants.

CloudWatch Journaux

AWS PCS utilise le format de nom suivant pour le flux CloudWatch Logs :

AWSLogs/PCS/cluster-id/node_lifecycle.log

Par exemple : AWSLogs/PCS/pcs_abc123de45/node_lifecycle.log

Amazon S3

AWS PCS utilise le format de nom suivant pour le chemin S3 :

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

Par exemple : AWSLogs/111122223333/PCS/us-east-1/pcs_abc123de45/node_lifecycle/2026/09/03/11/

AWS PCS utilise le format de nom suivant pour les fichiers journaux :

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

Par exemple : PCS_pcs_abc123de45_node_lifecycle_2026-09-03-11_04be080b.log.gz

Dimensionnement des champs de journal

AWS PCS écrit les données du journal de dimensionnement sous forme d'objets JSON. Chaque entrée de journal contient des champs de métadonnées de niveau supérieur et un details objet. Les champs de niveau supérieur identifient le cluster, l'heure de l'événement et les identifiants du groupe de nœuds de calcul et des nœuds du planificateur. L'detailsobjet contient les détails de la transition.

Le tableau suivant décrit les champs de niveau supérieur de chaque entrée de journal.

Le tableau suivant décrit les touches qui peuvent apparaître à l'intérieur de l'detailsobjet.

Codes de statut et codes de motif

Le status_code champ indique l'état saisi par le nœud. Le reason_code champ vous explique pourquoi. Par exemple, un LAUNCH_FAILED statut avec une INSUFFICIENT_CAPACITY raison signifie qu'Amazon EC2 n'a pas pu fournir de capacité pour le type d'instance demandé dans le sous-réseau ciblé. A LIMIT_EXCEEDED signifie qu'un quota Amazon EC2 a bloqué le lancement.

Exemples de journaux de dimensionnement

L'exemple suivant montre un lancement d'instance réussi :

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

L'exemple suivant montre un échec de lancement dû à une capacité EC2 insuffisante. Non instance_id est présent car aucune instance n'a été lancée.

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