

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

# 상태 확인 로그
<a name="load-balancer-health-check-logs"></a>

Elastic Load Balancing은 상태 확인 실패 시 실패 이유를 포함하여 등록된 대상의 상태 확인 상태에 대한 자세한 정보를 캡처하는 상태 확인 로그를 제공합니다. 상태 확인 로그는 EC2 인스턴스, IP 주소 및 Lambda 함수 대상에 대해 지원됩니다. 각 로그 항목에는 상태 확인 요청 유형 또는 연결, 타임스탬프, 대상 주소, 대상 그룹 ID, 상태 및 사유 코드와 같은 정보가 포함됩니다. 이러한 상태 확인 로그를 사용하여 대상 상태 패턴을 분석하고, 상태 전환을 모니터링하고, 문제를 해결할 수 있습니다.

상태 확인 로그는 기본적으로 비활성화된 선택적 기능입니다. 로드 밸런서에 대해 상태 확인 로그를 활성화하면 Elastic Load Balancing은 로그를 캡처하여 지정한 Amazon S3 버킷에 압축 파일로 저장합니다. 상태 확인 로그는 언제든지 비활성화할 수 있습니다.

Amazon S3의 스토리지 비용은 청구되지만, Amazon S3로 로그 파일을 전송하기 위해 Elastic Load Balancing에서 사용하는 대역폭에 대해서는 요금이 부과되지 않습니다. 스토리지 비용에 대한 자세한 내용은 [Amazon S3 요금](https://aws.amazon.com/s3/pricing/)을 참조하세요.

**Topics**
+ [상태 확인 로그 파일](#health-check-log-file-format)
+ [상태 확인 로그 항목](#health-check-log-entry-format)
+ [로그 항목 예제](#health-check-log-file-entries)
+ [로그 전송 알림 구성](#health-check-log-event-notifications)
+ [상태 확인 로그 파일 처리](#health-check-log-processing-tools)
+ [Application Load Balancer에 대한 상태 확인 로그 활성화](enable-health-check-logging.md)
+ [Application Load Balancer에 대한 상태 확인 로그 비활성화](disable-health-check-logging.md)

## 상태 확인 로그 파일
<a name="health-check-log-file-format"></a>

Elastic Load Balancing은 5분마다 각 로드 밸런서 노드에 대한 로그 파일을 게시합니다. 로드 밸런서는 많은 수의 대상이 로드 밸런서에 연결되거나 작은 상태 확인 간격이 구성된 경우(예: 5초마다) 동일한 기간 동안 여러 로그를 전송할 수 있습니다.

상태 확인 로그의 파일 이름은 다음 형식을 사용합니다.

```
bucket[/prefix]/AWSLogs/aws-account-id/elasticloadbalancing/region/yyyy/mm/dd/health_check_log_aws-account-id_elasticloadbalancing_region_app.load-balancer-id_end-time_ip-address_random-string.log.gz
```

*버킷*  
S3 버킷의 이름.

*접두사*  
(선택 사항) 버킷의 접두사(논리적 계층 구조)입니다. 지정하는 접두사에는 문자열 `AWSLogs`가 포함되지 않아야 합니다. 자세한 내용은 [접두사를 사용한 객체 구성](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html)을 참조하세요.

`AWSLogs`  
`AWSLogs`로 시작하는 파일 이름의 일부가 지정하는 버킷 이름과 선택적 접두사 뒤에 추가됩니다.

*aws-account-id*  
소유자의 AWS 계정 ID입니다.

*리전*.  
로드 밸런서 및 S3 버킷을 위한 리전입니다.

*yyyy*/*mm*/*dd*  
로그가 전달된 날짜입니다.

*load-balancer-id*  
로드 밸런서의 리소스 ID입니다. 리소스 ID에 포함되어 있는 슬래시(/)가 마침표(.)로 대체됩니다.

*end-time*  
로깅 간격이 끝나는 날짜와 시간입니다. 예를 들어 종료 시간이 20140215T2340Z이면 UTC 또는 Zulu 시간으로 23:35과 23:40 사이의 요청에 대한 항목이 포함됩니다.

*ip-address*  
요청을 처리한 로드 밸런서 노드의 IP 주소입니다. 내부 로드 밸런서의 경우 프라이빗 IP 주소가 됩니다.

*random-string*  
시스템에서 생성된 임의 문자열입니다.

다음은 접두사가 있는 로그 파일 이름의 예입니다.

```
s3://amzn-s3-demo-logging-bucket/logging-prefix/AWSLogs/123456789012/elasticloadbalancing/us-east-2/2022/05/01/health_check_log_123456789012_elasticloadbalancing_us-east-2_app.my-loadbalancer.1234567890abcdef_20220215T2340Z_172.160.001.192_20sg8hgm.log.gz
```

다음은 접두사가 없는 로그 파일 이름의 예입니다.

```
s3://amzn-s3-demo-logging-bucket/AWSLogs/123456789012/elasticloadbalancing/us-east-2/2022/05/01/health_check_log_123456789012_elasticloadbalancing_us-east-2_app.my-loadbalancer.1234567890abcdef_20220215T2340Z_172.160.001.192_20sg8hgm.log.gz
```

원하는 기간만큼 버킷에 로그 파일을 저장할 수 있습니다. 그러나 Amazon S3 수명 주기 규칙을 정의하여 자동으로 로그 파일을 보관하거나 삭제할 수도 있습니다. 자세한 내용을 알아보려면 *Amazon S3 사용 설명서*의 [객체 수명 주기 관리](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html)를 참조하세요.

## 상태 확인 로그 항목
<a name="health-check-log-entry-format"></a>

Elastic Load Balancing은 해당 로드 밸런서에 등록된 모든 대상에 대한 실패 이유를 포함하여 대상 상태 확인 결과를 로깅합니다. 각 로그 항목에는 등록된 대상에 대한 단일 상태 확인 결과의 세부 정보가 포함됩니다.

**Topics**
+ [구문](#health-check-log-entry-syntax)
+ [오류 이유 코드](#health-check-error-reason-codes)

### 구문
<a name="health-check-log-entry-syntax"></a>

다음 표에서는 상태 확인 로그 항목의 필드를 순서대로 설명합니다. 모든 필드는 공백으로 구분됩니다. 새 필드를 추가할 때는 로그 항목의 끝에 추가합니다. 새 필드를 릴리스할 준비를 하는 동안 해당 필드가 릴리스되기 전에 끝에 “-”가 하나 더 표시될 수 있습니다. 로그 구문 분석이 마지막으로 문서화된 필드에서 중단되도록 구성하고 새 필드를 릴리스한 후에는 로그 구문 분석 구성을 업데이트해야 합니다.


| 필드(위치) | 설명 | 
| --- | --- | 
|  type (1)  |  상태 확인 요청 또는 연결의 유형입니다. 사용 가능한 값은 다음과 같습니다(기타 값은 모두 무시). [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/elasticloadbalancing/latest/application/load-balancer-health-check-logs.html)  | 
|  time (2)  |  ISO 8601 형식의 대상에서 상태 확인이 시작되는 시점의 타임스탬프입니다.  | 
|  지연 시간(3)  |  현재 상태 확인을 완료하는 데 경과된 총 시간 (초)입니다.  | 
|  target\$1addr(4)  |  IP:Port 형식의 대상 IP 주소 및 포트입니다. 대상이 Lambda 함수인 경우 Lambda의 ARN입니다.  | 
|  target\$1group\$1id(5)  |  대상이 연결된 대상 그룹의 이름입니다.  | 
|  상태(6)  |  상태 확인의 상태입니다. 상태 확인이 성공하면이 값은 입니다 `PASS` . 실패한 상태 확인에서 값은 입니다. `FAIL`  | 
|  status\$1code(7)  |  상태 확인 요청에 대해 대상에서 받은 응답 코드입니다.  | 
|  reason\$1code(8)  |  상태 확인이 실패할 경우 실패 이유입니다. [오류 이유 코드](#health-check-error-reason-codes) 섹션을 참조하세요  | 

### 오류 이유 코드
<a name="health-check-error-reason-codes"></a>

대상 상태 확인이 실패하면 로드 밸런서는 상태 확인 로그에 다음 사유 코드 중 하나를 기록합니다.


| 코드 | 설명 | 
| --- | --- | 
|  `RequestTimedOut`  |  응답을 기다리는 동안 상태 확인 요청이 시간 초과됨  | 
|  `ConnectionTimedOut`  |  TCP 연결 시도 시간이 초과되어 상태 확인에 실패했습니다.  | 
|  `ConnectionReset`  |  연결 재설정으로 인한 상태 확인 실패  | 
|  `ResponseCodeMismatch`  |  상태 확인 요청에 대한 대상 응답의 HTTP 상태 코드가 구성된 상태 코드와 일치하지 않음  | 
|  `ResponseStringMismatch`  |  대상에서 반환한 응답 본문에 대상 그룹 상태 확인 구성에 구성된 문자열이 포함되어 있지 않음  | 
|  `InternalError`  |  내부 로드 밸런서 오류  | 
|  `TargetError`  |  대상은 상태 확인 요청에 대한 응답으로 5xx 오류 코드를 반환합니다.  | 
|  `GRPCStatusHeaderEmpty`  |  GRPC 대상 응답에 값이 없는 grpc 상태 헤더가 있음  | 
|  `GRPCUnexpectedStatus`  |  GRPC 대상이 예기치 않은 grpc-status로 응답함  | 

## 로그 항목 예제
<a name="health-check-log-file-entries"></a>

다음은 상태 확인 로그 항목의 예입니다. 보다 읽기 쉽도록 예제 텍스트가 여러 줄에 나타납니다.

다음은 성공적인 상태 확인을 위한 로그 항목의 예입니다.

```
http 2025-10-31T12:44:59.875678Z 0.019584011 172.31.20.97:80 HCLogsTestIPs PASS 200 -
```

다음은 실패한 상태 확인에 대한 로그 항목의 예입니다.

```
http 2025-10-31T12:44:58.901409Z 1.121980746 172.31.31.9:80 HCLogsTestIPs FAIL 502 TargetError
```

## 로그 전송 알림 구성
<a name="health-check-log-event-notifications"></a>

Elastic Load Balancing이 로그를 S3 버킷으로 전송할 때 알림을 받으려면 Amazon S3 이벤트 알림을 사용합니다. Elastic Load Balancing은 [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html), [CreateMultipartUpload](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html) 및 [POST Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html)를 사용하여 Amazon S3에 로그를 전송합니다. 모든 로그 전송 알림을 수신하려면 구성에 이러한 객체 생성 이벤트를 모두 포함해야 합니다.

자세한 내용은 *Amazon Simple Storage Service 사용 설명서*의 [Amazon S3 이벤트 알림](https://docs.aws.amazon.com/AmazonS3/latest/userguide/EventNotifications.html)을 참조하세요.

## 상태 확인 로그 파일 처리
<a name="health-check-log-processing-tools"></a>

상태 확인 로그 파일이 압축됩니다. 파일을 다운로드하는 경우에는 압축을 해제해야 정보를 볼 수 있습니다.

웹 사이트에서 요청이 많은 경우에는 로드 밸런서가 수 기가바이트의 데이터로 로그 파일을 생성할 수 있습니다. 라인별 처리로는 이렇게 대량의 데이터를 처리할 수 없습니다. 따라서 병렬 처리 솔루션을 제공하는 분석 도구를 사용해야 할 수 있습니다. 예를 들어 다음 분석 도구를 사용하여 상태 확인 로그를 분석하고 처리할 수 있습니다.
+ Amazon Athena는 표준 SQL을 사용해 Amazon S3에 저장된 데이터를 간편하게 분석할 수 있는 대화식 쿼리 서비스입니다.
+ [Loggly](https://documentation.solarwinds.com/en/success_center/loggly/content/admin/s3-ingestion-auto.htm)
+ [Splunk](https://splunk.github.io/splunk-add-on-for-amazon-web-services/)
+ [Sumo Logic](https://www.sumologic.com/application/elb/)

# Application Load Balancer에 대한 상태 확인 로그 활성화
<a name="enable-health-check-logging"></a>

로드 밸런서에 대해 상태 확인 로그를 활성화할 때는 로드 밸런서가 로그를 저장할 S3 버킷의 이름을 지정해야 합니다. 버킷에 액세스 로그를 쓰는 Elastic Load Balancing 권한을 부여하는 버킷 정책이 이 버킷에 있어야 합니다.

**Topics**
+ [1단계: S3 버킷 생성](#health-check-log-create-bucket)
+ [2단계: S3 버킷에 정책 연결](#attach-bucket-policy-health-check)
+ [3단계: 상태 확인 로그 구성](#enable-health-check-logs)
+ [4단계: 버킷 권한 확인](#verify-bucket-permissions-health-check)
+ [문제 해결](#bucket-permissions-troubleshooting-health-check)

## 1단계: S3 버킷 생성
<a name="health-check-log-create-bucket"></a>

상태 확인 로그를 활성화할 때는 상태 확인 로그에 대한 S3 버킷을 지정해야 합니다. 기존 버킷을 사용하거나 상태 확인 로그 전용 버킷을 생성할 수 있습니다. 버킷은 다음 요구 사항을 충족해야 합니다.

**요구 사항**
+ 버킷은 로드 밸런서와 같은 리전에 있어야 합니다. 서로 다른 계정에서 버킷과 로드 밸런서를 소유할 수 있습니다.
+ 지원되는 유일한 서버 측 암호화 옵션은 Amazon S3 관리형 키(SSE-S3)입니다. 자세한 내용을 [Amazon S3 관리형 암호화 키(SSE-S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingServerSideEncryption.html) 섹션을 참조하세요.

**Amazon S3 콘솔을 사용하여 S3 버킷에 폴더를 생성하려면**

1. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 Amazon S3 콘솔을 엽니다.

1. **버킷 만들기**를 선택합니다.

1. [**Create a bucket**] 페이지에서 다음과 같이 실행합니다.

   1. [**Bucket Name**]에서 버킷 이름을 입력합니다. 선택한 이름은 Amazon S3에 있는 어떤 기존 버킷 이름과도 중복되지 않아야 합니다. 일부 리전에서는 버킷 이름에 대한 추가 제한이 있을 수 있습니다. 자세한 내용은 *Amazon S3 사용 설명서*의 [버킷 규제 및 제한](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html)을 참조하세요.

   1. **AWS 리전**의 경우 로드 밸런서를 생성한 리전을 선택합니다.

   1. **기본 암호화**에서 **Amazon S3 관리형 키(SSE-S3)**를 선택합니다.

   1. **버킷 생성**을 선택합니다.

## 2단계: S3 버킷에 정책 연결
<a name="attach-bucket-policy-health-check"></a>

S3 버킷에는 버킷에 상태 확인 로그를 쓸 수 있는 Elastic Load Balancing 권한을 부여하는 버킷 정책이 있어야 합니다. 버킷 정책은 버킷에 대한 액세스 권한을 정의하기 위해 액세스 정책 언어로 작성된 JSON 문의 집합입니다. 각 문에는 단일 권한에 대한 정보와 일련의 요소들이 포함되어 있습니다.

이미 정책이 연결된 기존 버킷을 사용하는 경우 Elastic Load Balancing 상태 확인 로그에 대한 문을 정책에 추가할 수 있습니다. 이렇게 하면 결과 권한 세트를 평가하여 상태 확인 로그를 위해 버킷에 액세스해야 하는 사용자에게 적합한지 확인하는 것이 좋습니다.

### 버킷 정책
<a name="bucket-policy-logdelivery-health-check"></a>

이 정책은 지정된 로그 전송 서비스에 권한을 부여합니다.

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "logdelivery.elasticloadbalancing.amazonaws.com"
      },
      "Action": "s3:PutObject",
      "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/AWSLogs/123456789012/*"
    }
  ]
}
```

`Resource`에는 예제 정책에 표시된 형식을 사용하여 액세스 로그 위치의 ARN을 입력합니다. 항상 S3 버킷 ARN의 리소스 경로에는 로드 밸런서를 보유한 계정의 계정 ID를 포함해야 합니다. 이렇게 하면 지정된 계정의 로드 밸런서만 해당 S3 버킷에 액세스 로그를 기록할 수 있습니다.

지정하는 ARN은 [3단계](enable-access-logging.md#enable-access-logs)에서 액세스 로그를 활성화할 때 접두사를 포함할 계획인지 여부에 따라 다릅니다.

**접두사가 있는 S3 버킷 ARN 예제**  
S3 버킷 이름은 amzn-s3-demo-logging-bucket이고 접두사는 logging-prefix입니다.

```
arn:aws:s3:::amzn-s3-demo-logging-bucket/logging-prefix/AWSLogs/123456789012/*
```

**AWS GovCloud (US)** – 다음 예제에서는 AWS GovCloud (US) Regions에 대한 ARN 구문을 사용합니다.

```
arn:aws-us-gov:s3:::amzn-s3-demo-logging-bucket/logging-prefix/AWSLogs/123456789012/*
```

**접두사가 없는 S3 버킷 ARN 예제**  
S3 버킷 이름은 amzn-s3-demo-logging-bucket입니다. S3 버킷 ARN에는 접두사 부분이 없습니다.

```
arn:aws:s3:::amzn-s3-demo-logging-bucket/AWSLogs/123456789012/*
```

**AWS GovCloud (US)** – 다음 예제에서는 AWS GovCloud (US) Regions에 대한 ARN 구문을 사용합니다.

```
arn:aws-us-gov:s3:::amzn-s3-demo-logging-bucket/AWSLogs/123456789012/*
```

### 레거시 버킷 정책
<a name="legacy-bucket-policy"></a>

2022년 8월 이전에 제공되던 리전의 경우, 리전별 Elastic Load Balancing 계정에 권한을 부여하는 정책이 필요했습니다. 이 레거시 정책은 여전히 지원되지만, 위에 소개된 최신 정책으로 대체할 것을 권장합니다. 표시되어 있지 않지만 레거시 정책을 계속 사용하려는 경우 그대로 사용할 수 있습니다.

 참고로 레거시 정책 `Principal`에서 지정해야 하는 Elastic Load Balancing 계정 ID는 다음과 같습니다. 이 목록에 없는 리전은 레거시 정책을 지원하지 않는다는 점에 유의하세요.
+ 미국 동부(버지니아 북부) – 127311923021
+ 미국 동부(오하이오) – 033677994240
+ 미국 서부(캘리포니아 북부) – 027434742980
+ 미국 서부(오레곤) – 797873946194
+ 아프리카(케이프타운) – 098369216593
+ 아시아 태평양(홍콩) – 754344448648
+ 아시아 태평양(자카르타) – 589379963580
+ 아시아 태평양(뭄바이) – 718504428378
+ 아시아 태평양(오사카) – 383597477331
+ 아시아 태평양(서울) – 600734575887
+ 아시아 태평양(싱가포르) – 114774131450
+ 아시아 태평양(시드니) – 783225319266
+ 아시아 태평양(도쿄) – 582318560864
+ 캐나다(중부) – 985666609251
+ 유럽(프랑크푸르트) – 054676820928
+ 유럽(아일랜드) – 156460612806
+ 유럽(런던) – 652711504416
+ 유럽(밀라노) – 635631232127
+ 유럽(파리) – 009996457667
+ 유럽(스톡홀름) – 897822967062
+ 중동(바레인) – 076674570225
+ 남아메리카(상파울루) – 507241528517
+ AWS GovCloud(미국 동부) – 190560391635
+ AWS GovCloud(미국 서부) – 048591011584

### Outposts 영역
<a name="bucket-policy-outposts"></a>

다음 정책은 지정된 로그 전송 서비스에 권한을 부여합니다. Outposts 영역의 로드 밸런서에 이 정책을 사용하세요.

```
{
    "Effect": "Allow",
    "Principal": {
        "Service": "logdelivery.elb.amazonaws.com"
    },
    "Action": "s3:PutObject",
    "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/AWSLogs/123456789012/*"
    "Condition": {
        "StringEquals": {
            "s3:x-amz-acl": "bucket-owner-full-control"
        }
    }
}
```

`Resource`에는 액세스 로그 위치의 ARN을 입력합니다. 항상 S3 버킷 ARN의 리소스 경로에는 로드 밸런서를 보유한 계정의 계정 ID를 포함해야 합니다. 이렇게 하면 지정된 계정의 로드 밸런서만 해당 S3 버킷에 액세스 로그를 기록할 수 있습니다.

지정하는 ARN은 [3단계](enable-access-logging.md#enable-access-logs)에서 액세스 로그를 활성화할 때 접두사를 포함할 계획인지 여부에 따라 다릅니다.

**접두사가 있는 S3 버킷 ARN 예제**  
S3 버킷 이름은 amzn-s3-demo-logging-bucket이고 접두사는 logging-prefix입니다.

```
arn:aws:s3:::amzn-s3-demo-logging-bucket/logging-prefix/AWSLogs/123456789012/*
```

**접두사가 없는 S3 버킷 ARN 예제**  
S3 버킷 이름은 amzn-s3-demo-logging-bucket입니다. S3 버킷 ARN에는 접두사 부분이 없습니다.

```
arn:aws:s3:::amzn-s3-demo-logging-bucket/AWSLogs/123456789012/*
```

### 보안 모범 사례
<a name="bucket-policy-security-best-practices"></a>

보안을 강화하려면 정확한 S3 버킷 ARN을 사용합니다.
+ S3 버킷 ARN뿐만 아니라 전체 리소스 경로를 사용합니다.
+ S3 버킷 ARN의 계정 ID 부분을 포함합니다.
+ S3 버킷 ARN의 계정 ID 부분에 와일드카드(\$1)를 사용하지 마세요.

버킷 정책을 생성한 후 Amazon S3 콘솔 또는 AWS CLI 명령과 같은 Amazon S3 인터페이스를 사용하여 버킷 정책을 S3 버킷에 연결합니다.

------
#### [ Console ]

**버킷 정책을 S3 버킷에 연결하려면**

1. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 Amazon S3 콘솔을 엽니다.

1. 버킷 이름을 선택하여 세부 정보 페이지를 엽니다.

1. **권한**을 선택한 다음에 **버킷 정책**, **편집**을 선택합니다.

1. 버킷 정책을 업데이트하여 필수 권한을 부여합니다.

1. **변경 사항 저장**을 선택합니다.

------
#### [ AWS CLI ]

**버킷 정책을 S3 버킷에 연결하려면**  
[put-bucket-policy](https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-policy.html) 명령을 사용합니다. 이 예제에서는 버킷 정책이 지정된 .json 파일에 저장되었습니다.

```
aws s3api put-bucket-policy \
    --bucket amzn-s3-demo-bucket \
    --policy file://access-log-policy.json
```

------

## 3단계: 상태 확인 로그 구성
<a name="enable-health-check-logs"></a>

다음 절차에 따라 S3 버킷에 로그 파일을 캡처하고 전송하도록 상태 확인 로그를 구성합니다.

**요구 사항**  
버킷은 [1단계](#health-check-log-create-bucket)에 설명된 요구 사항을 충족해야 하며 [2단계](#attach-bucket-policy-health-check)의 설명에 따라 버킷 정책을 연결해야 합니다. 접두사를 지정하는 경우 접두사에 'AWSLogs' 문자열이 포함되지 않아야 합니다.

**상태 확인 로그의 S3 버킷을 관리하려면**  
상태 확인 로그에 대해 구성한 버킷을 삭제하기 전에 상태 확인 로그를 비활성화해야 합니다. 그렇지 않으면 이름과 필수 버킷 정책이 동일하지만 소유하지 않은에서 AWS 계정 생성된 새 버킷이 있는 경우 Elastic Load Balancing은 로드 밸런서에 대한 상태 확인 로그를이 새 버킷에 쓸 수 있습니다.

------
#### [ Console ]

**상태 확인 로그를 활성화하려면**

1. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)에서 Amazon EC2 콘솔을 엽니다.

1. 탐색 창에서 **로드 밸런서**를 클릭합니다.

1. 로드 밸런서 이름을 선택하여 세부 정보 페이지를 엽니다.

1. **속성** 탭에서 **편집**을 선택합니다.

1. **모니터링**에서 **상태 확인 로그**를 켭니다.

1. **S3 URI**로 로그 파일의 S3 URI를 입력합니다. 지정하는 URI는 접두사 사용 여부에 따라 달라집니다.
   + 접두사가 있는 URI: `s3://bucket-name/prefix`
   + 접두사가 없는 URI: `s3://bucket-name`

1. **변경 사항 저장**을 선택합니다.

------
#### [ AWS CLI ]

**상태 확인 로그를 활성화하려면**  
관련 속성과 함께 [modify-load-balancer-attributes](https://docs.aws.amazon.com/cli/latest/reference/elbv2/modify-load-balancer-attributes.html) 명령을 사용합니다.

```
aws elbv2 modify-load-balancer-attributes \
    --load-balancer-arn load-balancer-arn \
    --attributes \
        Key=health_check_logs.s3.enabled,Value=true \
        Key=health_check_logs.s3.bucket,Value=amzn-s3-demo-logging-bucket \
        Key=health_check_logs.s3.prefix,Value=logging-prefix
```

------
#### [ CloudFormation ]

**상태 확인 로그를 활성화하려면**  
관련 속성을 포함하도록 [AWS::ElasticLoadBalancingV2::LoadBalancer](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-elasticloadbalancingv2-loadbalancer.html) 리소스를 업데이트합니다.

```
Resources:
  myLoadBalancer:
    Type: 'AWS::ElasticLoadBalancingV2::LoadBalancer'
    Properties:
      Name: my-alb
      Type: application
      Scheme: internal
      Subnets: 
        - !Ref subnet-AZ1
        - !Ref subnet-AZ2
      SecurityGroups: 
        - !Ref mySecurityGroup
      LoadBalancerAttributes: 
        - Key: "health_check_logs.s3.enabled"
          Value: "true"
        - Key: "health_check_logs.s3.bucket"
          Value: "amzn-s3-demo-logging-bucket"
        - Key: "health_check_logs.s3.prefix"
          Value: "logging-prefix"
```

------

## 4단계: 버킷 권한 확인
<a name="verify-bucket-permissions-health-check"></a>

로드 밸런서에 대해 상태 확인 로그가 활성화되면 Elastic Load Balancing은 S3 버킷을 검증하고 테스트 파일을 생성하여 버킷 정책이 필요한 권한을 지정하는지 확인합니다. Amazon S3 콘솔을 사용하여 테스트 파일이 생성되었는지 확인할 수 있습니다. 테스트 파일은 실제 상태 확인 로그 파일이 아니며 예제 레코드를 포함하지 않습니다.

**S3 버킷에서 Elastic Load Balancing이 테스트 파일을 생성했는지 확인하려면**

1. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 Amazon S3 콘솔을 엽니다.

1. 상태 확인 로그에 지정한 버킷의 이름을 선택합니다.

1. 테스트 파일인 `ELBHealthCheckLogTestFile`로 이동합니다. 위치는 접두사 사용 여부에 따라 달라집니다.
   + 접두사가 있는 위치: *amzn-s3-demo-logging-bucket*/*prefix*/AWSLogs/*123456789012*/ELBHealthCheckLogTestFile
   + 접두사가 없는 위치: *amzn-s3-demo-logging-bucket*/AWSLogs/*123456789012*/ELBHealthCheckLogTestFile

## 문제 해결
<a name="bucket-permissions-troubleshooting-health-check"></a>

액세스 거부 오류가 발생한 경우, 가능한 원인은 다음과 같습니다.
+ 버킷 정책은 버킷에 상태 확인 로그를 쓸 수 있는 권한을 Elastic Load Balancing에 부여하지 않습니다. 리전에 올바른 버킷 정책을 사용하고 있는지 확인합니다. 리소스 ARN이 상태 확인 로그를 활성화할 때 지정한 것과 동일한 버킷 이름을 사용하는지 확인합니다. 상태 확인 로그를 활성화할 때 접두사를 지정하지 않은 경우 리소스 ARN에 접두사가 포함되어 있지 않은지 확인합니다.
+ 버킷이 지원되지 않는 서버 측 암호화 옵션을 사용합니다. 버킷이 Amazon S3 관리형 키(SSE-S3)를 사용해야 합니다.

# Application Load Balancer에 대한 상태 확인 로그 비활성화
<a name="disable-health-check-logging"></a>

언제든지 로드 밸런서에 대한 상태 확인 로그를 비활성화할 수 있습니다. 상태 확인 로그를 비활성화하면 상태 확인 로그는 삭제할 때까지 S3 버킷에 남아 있습니다. 자세한 내용은 *Amazon S3 사용 설명서*의 [버킷 생성, 구성 및 사용](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html)을 참조하세요.

------
#### [ Console ]

**상태 확인 로그를 비활성화하려면**

1. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)에서 Amazon EC2 콘솔을 엽니다.

1. 탐색 창에서 **로드 밸런서**를 클릭합니다.

1. 로드 밸런서 이름을 선택하여 세부 정보 페이지를 엽니다.

1. **속성** 탭에서 **편집**을 선택합니다.

1. **모니터링**에서 **상태 확인 로그**를 끕니다.

1. **변경 사항 저장**을 선택합니다.

------
#### [ AWS CLI ]

**상태 확인 로그를 비활성화하려면**  
[modify-load-balancer-attributes](https://docs.aws.amazon.com/cli/latest/reference/elbv2/modify-load-balancer-attributes.html) 명령을 사용합니다.

```
aws elbv2 modify-load-balancer-attributes \
    --load-balancer-arn load-balancer-arn \
    --attributes Key=health_check_logs.s3.enabled,Value=false
```

------