기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS PCS에서 로그 크기 조정

조정 로그는 AWS 병렬 컴퓨팅 서비스가 클러스터의 컴퓨팅 노드 그룹을 조정하는 방법에 대한 레코드를 제공합니다. 각 로그 항목은 인스턴스 시작, 노드 등록, 스케일 다운 또는 이유와 함께 시작 실패 등 하나의 컴퓨팅 노드에 대해 하나의 상태 전환을 기록합니다. 조정 로그를 사용하여 노드 그룹이 목표 크기에 도달하지 못한 이유, 용량상의 이유로 시작되지 않은 이유, 특정 노드가 시작되거나 중지된 시기와 같은 질문에 답할 수 있습니다.

조정 로그를 Amazon CloudWatch, Amazon Simple Storage Service(Amazon S3) 및 Amazon Data Firehose로 전송할 수 있습니다. 각 전환에 대해 AWS PCS는 다음 데이터를 기록합니다.

AWS PCS는 로그 유형을 통해 조정 PCS_SCALING_LOGS 로그를 전달합니다. 조정 로그 전송은 옵트인됩니다. AWS PCS는 클러스터에 대한 전송을 구성할 때까지 클러스터에 대한 조정 로그를 전송하지 않습니다.

사전 조건

AWS PCS 클러스터를 관리하는 IAM 보안 주체는 pcs:AllowVendedLogDeliveryForResource 작업을 허용해야 합니다.

다음 예제 IAM 정책은 필요한 권한을 부여합니다.

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

조정 로그 설정

AWS Management Console 또는를 사용하여 AWS PCS 클러스터에 대한 조정 로그를 설정할 수 있습니다 AWS CLI.

AWS Management Console

콘솔을 사용하여 조정 로그를 설정하려면

1. AWS PCS 콘솔을 엽니다.

2. 탐색 창에서 클러스터를 선택합니다.

3. 조정 로그를 추가할 클러스터를 선택합니다.

4. 클러스터 세부 정보 페이지에서 로그 탭을 선택합니다.

5. 조정 로그에서 추가를 선택하여 CloudWatch Logs, Amazon S3 및 Firehose 중에서 최대 3개의 로그 전송 대상을 추가합니다. CloudWatch

6. 로그 전송 업데이트를 선택합니다.

AWS CLI

를 사용하여 조정 로그를 설정하려면 AWS CLI

1. 로그 전송 대상 생성:

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

   다음과 같이 바꿉니다.

   • region -와 같이 대상을 생성하려는 AWS 리전 입니다. us-east-1

   • pcs-logs-destination - 대상의 이름

   • resource-arn - CloudWatch Logs 로그 그룹, S3 버킷 또는 Firehose 전송 스트림의 Amazon 리소스 이름(ARN)입니다.

   자세한 내용은 Amazon CloudWatch Logs API 참조에 나와 있는 PutDeliveryDestination을 참조하시기 바랍니다.

2. PCS 클러스터를 로그 전송 소스로 설정합니다.

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

   다음과 같이 바꿉니다.

   • region -와 같은 클러스터 AWS 리전 의 us-east-1

   • cluster-logs-source-name - 소스의 이름입니다.

   • cluster-arn - AWS PCS 클러스터의 ARN

   자세한 내용은 Amazon CloudWatch Logs API 참조의 PutDeliverySource를 참조하세요. Amazon CloudWatch

3. 전송 소스를 전송 대상에 연결합니다.

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

   다음과 같이 바꿉니다.

   • region - AWS 리전와 같은 us-east-1

   • cluster-logs-source - 전송 소스의 이름입니다.

   • destination-arn - 전송 대상의 ARN입니다.

   자세한 내용은 Amazon CloudWatch Logs API 참조의 CreateDelivery를 참조하세요. Amazon CloudWatch

조정 로그 찾기

CloudWatch Logs에서 로그 대상을 구성할 수 있으며 Amazon S3. AWS PCS는 다음과 같은 구조화된 경로 이름과 파일 이름을 사용합니다.

CloudWatch Logs

AWS PCS는 CloudWatch Logs 스트림에 다음 이름 형식을 사용합니다.

AWSLogs/PCS/cluster-id/node_lifecycle.log

예: AWSLogs/PCS/pcs_abc123de45/node_lifecycle.log.

Amazon S3

AWS PCS는 S3 경로에 다음 이름 형식을 사용합니다.

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

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

AWS PCS는 로그 파일에 다음 이름 형식을 사용합니다.

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

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

로그 필드 크기 조정

AWS PCS는 조정 로그 데이터를 JSON 객체로 기록합니다. 각 로그 항목에는 최상위 메타데이터 필드와 details 객체가 포함됩니다. 최상위 필드는 클러스터, 이벤트 시간, 컴퓨팅 노드 그룹 및 스케줄러 노드 ID를 식별합니다. details 객체에는 전환 세부 정보가 들어 있습니다.

다음 표에서는 각 로그 항목의 최상위 필드를 설명합니다.

다음 표에서는 details 객체 내에 나타날 수 있는 키를 설명합니다.

상태 코드 및 사유 코드

status_code 필드는 노드가 입력한 상태를 알려줍니다. reason_code 필드에 이유를 알려줍니다. 예를 들어INSUFFICIENT_CAPACITY, 이유가 인 LAUNCH_FAILED 상태는 Amazon EC2가 대상 서브넷에서 요청된 인스턴스 유형에 용량을 제공할 수 없음을 의미합니다. 는 Amazon EC2 할당량이 시작을 차단했음을 LIMIT_EXCEEDED 의미합니다.

로그 조정 예제

다음 예제에서는 성공적인 인스턴스 시작을 보여줍니다.

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

다음 예제에서는 EC2 용량 부족으로 인한 시작 실패를 보여줍니다. 시작된 인스턴스instance_id가 없기 때문에가 없습니다.

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