Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menskalakan log masuk AWS PCS

Log penskalaan memberi Anda catatan tentang bagaimana Layanan Komputasi AWS Paralel menskalakan grup simpul komputasi di cluster Anda. Setiap entri log mencatat satu transisi status untuk satu node komputasi: misalnya, peluncuran instance, pendaftaran node, penurunan skala, atau kegagalan peluncuran dengan alasannya. Anda dapat menggunakan log penskalaan untuk menjawab pertanyaan seperti mengapa grup node tidak mencapai ukuran targetnya, peluncuran mana yang gagal karena alasan kapasitas, dan ketika node tertentu dimulai atau dihentikan.

Anda dapat mengirim log penskalaan ke Amazon CloudWatch, Amazon Simple Storage Service (Amazon S3), dan Amazon Data Firehose. Untuk setiap transisi, AWS PCS mencatat data berikut:

AWS PCS mengirimkan log penskalaan melalui jenis PCS_SCALING_LOGS log. Penskalaan pengiriman log adalah opt-in. AWS PCS tidak mengirimkan log penskalaan untuk cluster sampai Anda mengonfigurasi pengiriman untuk itu.

Prasyarat

Prinsip IAM yang mengelola cluster AWS PCS harus mengizinkan pcs:AllowVendedLogDeliveryForResource tindakan tersebut.

Contoh kebijakan IAM berikut memberikan izin yang diperlukan.

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

Menyiapkan log penskalaan

Anda dapat mengatur log penskalaan untuk cluster AWS PCS Anda dengan Konsol Manajemen AWS atau AWS CLI.

Konsol Manajemen AWS

Untuk mengatur log penskalaan dengan konsol

1. Buka konsol AWS PCS.

2. Pada panel navigasi, silakan pilih Klaster.

3. Pilih cluster tempat Anda ingin menambahkan log penskalaan.

4. Pada halaman detail cluster, pilih tab Log.

5. Di bawah Scaling Logs, pilih Tambah untuk menambahkan hingga 3 tujuan pengiriman log dari antara CloudWatch Logs, Amazon S3, dan Firehose.

6. Pilih Perbarui pengiriman log.

AWS CLI

Untuk mengatur log penskalaan dengan AWS CLI

1. Buat tujuan pengiriman log:

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

   Ganti:

   • region— Wilayah AWS Tempat Anda ingin membuat tujuan, seperti us-east-1

   • pcs-logs-destination— Nama untuk tujuan

   • resource-arn— Nama Sumber Daya Amazon (ARN) dari grup CloudWatch log Logs, bucket S3, atau aliran pengiriman Firehose.

   Untuk informasi selengkapnya, lihat PutDeliveryDestination Referensi API Amazon CloudWatch Logs.

2. Setel cluster PCS sebagai sumber pengiriman log:

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

   Ganti:

   • region— Cluster Anda, seperti Wilayah AWS us-east-1

   • cluster-logs-source-name— Nama untuk sumbernya

   • cluster-arn— ARN cluster AWS PCS Anda

   Untuk informasi selengkapnya, lihat PutDeliverySource Referensi API Amazon CloudWatch Logs.

3. Hubungkan sumber pengiriman ke tujuan pengiriman:

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

   Ganti:

   • region— Yang Wilayah AWS, seperti us-east-1

   • cluster-logs-source— Nama sumber pengiriman Anda

   • destination-arn— ARN tujuan pengiriman Anda

   Untuk informasi selengkapnya, lihat CreateDelivery Referensi API Amazon CloudWatch Logs.

Menemukan log penskalaan

Anda dapat mengonfigurasi tujuan CloudWatch log di Logs dan Amazon S3. AWS PCS menggunakan nama jalur terstruktur dan nama file berikut.

CloudWatch Log

AWS PCS menggunakan format nama berikut untuk aliran CloudWatch Logs:

AWSLogs/PCS/cluster-id/node_lifecycle.log

Misalnya: AWSLogs/PCS/pcs_abc123de45/node_lifecycle.log

Amazon S3

AWS PCS menggunakan format nama berikut untuk jalur S3:

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

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

AWS PCS menggunakan format nama berikut untuk file log:

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

Misalnya: PCS_pcs_abc123de45_node_lifecycle_2026-09-03-11_04be080b.log.gz

Bidang log penskalaan

AWS PCS menulis data log penskalaan sebagai objek JSON. Setiap entri log berisi bidang metadata tingkat atas dan details objek. Bidang tingkat atas mengidentifikasi cluster, waktu peristiwa, dan grup simpul komputasi dan id simpul penjadwal. Ob details jek menyimpan detail transisi.

Tabel berikut menjelaskan bidang tingkat atas di setiap entri log.

Tabel berikut menjelaskan kunci yang dapat muncul di dalam details objek.

Kode status dan kode alasan

Bid status_code ang memberi tahu Anda status node yang dimasukkan. Bid reason_code ang memberi tahu Anda mengapa. Misalnya, LAUNCH_FAILED status dengan INSUFFICIENT_CAPACITY alasan berarti Amazon EC2 tidak dapat menyediakan kapasitas untuk jenis instans yang diminta di subnet yang ditargetkan. A LIMIT_EXCEEDED berarti kuota Amazon EC2 memblokir peluncuran.

Contoh log penskalaan

Contoh berikut menunjukkan peluncuran instance yang berhasil:

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

Contoh berikut menunjukkan kegagalan peluncuran yang disebabkan oleh kapasitas EC2 yang tidak mencukupi. Tidak instance_id hadir karena tidak ada instance yang diluncurkan.

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