Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Scalabilità degli accessi AWS 2 PEZZI

I log di scalabilità forniscono una registrazione del modo in cui AWS Parallel Computing Service ridimensiona i gruppi di nodi di calcolo nel cluster. Ogni voce di registro registra una transizione di stato per un nodo di calcolo: ad esempio, l'avvio di un'istanza, la registrazione di un nodo, un ridimensionamento o un errore di avvio con il relativo motivo. È possibile utilizzare i log di ridimensionamento per rispondere a domande come il motivo per cui un gruppo di nodi non ha raggiunto la dimensione desiderata, quali avvii non sono riusciti per motivi di capacità e quando un nodo specifico è stato avviato o interrotto.

Puoi inviare log di scalabilità ad Amazon CloudWatch, Amazon Simple Storage Service (Amazon S3) e Amazon Data Firehose. Per ogni transizione, AWS PCS registra i seguenti dati:

AWS PCS fornisce log di scalabilità in base al tipo di PCS_SCALING_LOGS registro. La distribuzione scalabile dei log è facoltativa. AWS PCS non fornisce log di scalabilità per un cluster finché non si configura una distribuzione per esso.

Prerequisiti

Il responsabile IAM che gestisce il cluster AWS PCS deve consentire l'pcs:AllowVendedLogDeliveryForResourceazione.

Il seguente esempio di policy IAM concede le autorizzazioni richieste.

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

Configura i log di scalabilità

È possibile impostare i log di scalabilità per il cluster AWS PCS con o. Console di gestione AWS AWS CLI

Console di gestione AWS

Per configurare i log di scalabilità con la console

1. Aprire la console AWS PCS.

2. Nel pannello di navigazione scegliere Cluster.

3. Scegli il cluster in cui desideri aggiungere i log di ridimensionamento.

4. Nella pagina dei dettagli del cluster, scegli la scheda Logs.

5. In Scaling Logs, scegli Aggiungi per aggiungere fino a 3 destinazioni di distribuzione dei CloudWatch log tra Logs, Amazon S3 e Firehose.

6. Scegli Aggiorna le consegne dei log.

AWS CLI

Per configurare la scalabilità dei log con AWS CLI

1. Crea una destinazione di consegna dei log:

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

   Sostituire:

   • region— La Regione AWS posizione in cui desideri creare la destinazione, ad esempio us-east-1

   • pcs-logs-destination— Un nome per la destinazione

   • resource-arn— L'Amazon Resource Name (ARN) di un gruppo di CloudWatch log Logs, di un bucket S3 o di un flusso di consegna Firehose.

   Per ulteriori informazioni, consulta Amazon CloudWatch Logs PutDeliveryDestination API Reference.

2. Imposta il cluster PCS come fonte di distribuzione dei log:

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

   Sostituire:

   • region— Il Regione AWS nome del tuo cluster, ad esempio us-east-1

   • cluster-logs-source-name— Un nome per la fonte

   • cluster-arn— l'ARN del tuo cluster AWS PCS

   Per ulteriori informazioni, consulta PutDeliverySource la sezione Amazon CloudWatch Logs API Reference.

3. Collega l'origine di consegna alla destinazione di consegna:

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

   Sostituire:

   • region— Il Regione AWS, ad esempio us-east-1

   • cluster-logs-source— Il nome della fonte di consegna

   • destination-arn— L'ARN della destinazione di consegna

   Per ulteriori informazioni, consulta CreateDelivery la sezione Amazon CloudWatch Logs API Reference.

Individuazione dei log di scalabilità

Puoi configurare le destinazioni dei CloudWatch log in Logs e Amazon S3. AWS PCS utilizza i seguenti nomi di percorso strutturati e nomi di file.

CloudWatch Registri

AWS PCS utilizza il seguente formato di nome per il flusso di CloudWatch log:

AWSLogs/PCS/cluster-id/node_lifecycle.log

Ad esempio, AWSLogs/PCS/pcs_abc123de45/node_lifecycle.log

Simple Storage Service (Amazon S3)

AWS PCS utilizza il seguente formato di nome per il percorso S3:

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

Ad esempio, AWSLogs/111122223333/PCS/us-east-1/pcs_abc123de45/node_lifecycle/2026/09/03/11/

AWS PCS utilizza il seguente formato di nome per i file di registro:

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

Ad esempio, PCS_pcs_abc123de45_node_lifecycle_2026-09-03-11_04be080b.log.gz

Ridimensionamento dei campi di registro

AWS PCS scrive i dati di registro di ridimensionamento come oggetti JSON. Ogni voce di registro contiene campi di metadati di primo livello e un oggetto. details I campi di primo livello identificano il cluster, l'ora dell'evento e gli ID del gruppo di nodi di calcolo e dei nodi dello scheduler. L'detailsoggetto contiene i dettagli della transizione.

La tabella seguente descrive i campi di primo livello in ogni voce di registro.

La tabella seguente descrive le chiavi che possono apparire all'interno dell'detailsoggetto.

Codici di stato e codici motivazionali

Il status_code campo indica lo stato immesso dal nodo. Il reason_code campo indica il motivo. Ad esempio, uno LAUNCH_FAILED stato con un INSUFFICIENT_CAPACITY motivo indica che Amazon EC2 non è in grado di fornire capacità per il tipo di istanza richiesto nella sottorete di destinazione. A LIMIT_EXCEEDED significa che una quota Amazon EC2 ha bloccato il lancio.

Esempi di log di ridimensionamento

L'esempio seguente mostra un avvio riuscito dell'istanza:

{
    "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'esempio seguente mostra un errore di avvio causato da una capacità EC2 insufficiente. No instance_id è presente perché non è stata avviata alcuna istanza.

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