기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
환경에 대한 Amazon CloudWatch 사용자 지정 측정치 게시
AWS Elastic Beanstalk Amazon CloudWatch에 고급 상태 보고를 통해 수집된 데이터를 사용자 지정 지표로 게시할 수 있습니다. 측정치를 CloudWatch에 게시하면 시간 경과에 따른 애플리케이션 성능의 변경 사항을 모니터링하고 리소스 사용량 및 요청 지연 시간이 로드와 조정되는 방식을 추적하여 잠재적 문재를 식별할 수 있습니다.
측정치를 CloudWatch에 게시하면 모니터링 그래프 및 경보에도 해당 측정치를 사용할 수 있습니다. 무료 측정치인 EnvironmentHealth는 확장 상태 보고를 사용할 때 자동으로 활성화됩니다. EnvironmentHealth를 제외한 다른 사용자 지정 측정치에 대해서는 표준 CloudWatch 요금
환경에 대한 CloudWatch 사용자 지정 측정치를 게시하려면 먼저 환경에서 확장 상태 보고를 활성화해야 합니다. 자세한 내용은 Elastic Beanstalk 확장 상태 보고 활성화 섹션을 참조하세요.
주제
향상된 상태 보고 지표
환경에서 확장 상태 보고를 활성화한 경우 확장 상태 보고 시스템에서 CloudWatch 사용자 지정 측정치인 EnvironmentHealth 하나가 자동으로 게시됩니다. 추가 측정치를 CloudWatch에 게시하려면 Elastic Beanstalk 콘솔, EB CLI 또는 .ebextensions를 사용하여 해당 측정치로 환경을 구성합니다.
해당 환경의 다음과 같은 확장 상태 측정치를 CloudWatch에 게시할 수 있습니다.
사용 가능한 측정치 - 모든 플랫폼
EnvironmentHealth
-
환경만 해당됩니다. 이 항목은 추가 측정치를 구성하지 않는 한 확장 상태 보고 시스템은 CloudWatch 측정치만 게시합니다. 환경 상태는 7개의 상태 중 하나로 표시됩니다. CloudWatch 콘솔에서 이러한 상태는 다음 값에 매핑됩니다.
-
0 - 정상(OK)
-
1 - 정보(Info)
-
5 - 알 수 없음(Unknown)
-
10 - 데이터 없음(No data)
-
15 - 경고(Warning)
-
20 - 성능 저하됨(Degraded)
-
25 - 심각(Severe)
-
InstancesSevere
InstancesDegraded
InstancesWarning
InstancesInfo
InstancesOk
InstancesPending
InstancesUnknown
InstancesNoData
-
환경만 해당됩니다. 이 측정치는 환경에 있는 각 상태의 인스턴스 수를 표시합니다.
InstancesNoData
는 데이터를 수신할 수 없는 인스턴스 수를 나타냅니다. ApplicationRequestsTotal
ApplicationRequests5xx
ApplicationRequests4xx
ApplicationRequests3xx
ApplicationRequests2xx
-
인스턴스와 환경이 해당됩니다. 인스턴스 또는 환경에서 완료된 총 요청 수와 각 상태 코드 범주에서 완료된 요청 수를 나타냅니다.
ApplicationLatencyP10
ApplicationLatencyP50
ApplicationLatencyP75
ApplicationLatencyP85
ApplicationLatencyP90
ApplicationLatencyP95
ApplicationLatencyP99
ApplicationLatencyP99.9
-
인스턴스와 환경이 해당됩니다. 요청의 가장 빠른 x%를 완료하는 데 걸리는 평균 시간(초)을 나타냅니다.
InstanceHealth
-
인스턴스만 해당됩니다. 인스턴스의 현재 상태를 나타냅니다. 인스턴스 상태는 7개의 상태 중 하나로 표시됩니다. CloudWatch 콘솔에서 이러한 상태는 다음 값에 매핑됩니다.
-
0 - 정상(OK)
-
1 - 정보(Info)
-
5 - 알 수 없음(Unknown)
-
10 - 데이터 없음(No data)
-
15 - 경고(Warning)
-
20 - 성능 저하됨(Degraded)
-
25 - 심각(Severe)
-
사용 가능한 측정치 - Linux
CPUIrq
CPUIdle
CPUUser
CPUSystem
CPUSoftirq
CPUIowait
CPUNice
-
인스턴스만 해당됩니다. 마지막 1분 동안 각 상태에서 CPU가 소비한 시간의 비율을 나타냅니다.
LoadAverage1min
-
인스턴스만 해당됩니다. 마지막 1분 동안 인스턴스의 평균 CPU 부하입니다.
RootFilesystemUtil
-
인스턴스만 해당됩니다. 사용 중인 디스크 공간의 비율을 나타냅니다.
사용 가능한 측정치 - Windows
CPUIdle
CPUUser
CPUPrivileged
-
인스턴스만 해당됩니다. 마지막 1분 동안 각 상태에서 CPU가 소비한 시간의 비율을 나타냅니다.
Elastic Beanstalk 콘솔을 사용하여 CloudWatch 측정치 구성
Elastic Beanstalk 콘솔을 사용하여 확장 상태 보고 측정치를 CloudWatch에 게시하고 모니터링 그래프 및 경보에 측정치를 사용할 수 있도록 환경을 구성할 수 있습니다.
Elastic Beanstalk 콘솔에서 CloudWatch 사용자 지정 측정치를 구성하려면
Elastic Beanstalk 콘솔
을 열고 리전 목록에서를 선택합니다 AWS 리전. -
탐색 창에서 환경을 선택한 다음 목록에서 환경의 이름을 선택합니다.
참고
여러개의 환경을 보유한 경우 검색 창을 통해 환경 목록을 필터링합니다.
탐색 창에서 구성을 선택합니다.
-
[모니터링] 구성 범주에서 [편집]을 선택합니다.
-
상태 보고에서 CloudWatch에 게시할 인스턴스 및 환경 측정치를 선택합니다. 여러 측정치를 선택하려면 Ctrl 키를 누른 채 선택합니다.
-
변경 사항을 저장하려면 페이지 하단에서 적용을 선택합니다.
CloudWatch 사용자 지정 측정치를 활성화하면 해당 측정치가 모니터링(Monitoring) 페이지에서 사용 가능한 측정치 목록에 추가됩니다.
EB CLI를 사용하여 CloudWatch 사용자 지정 측정치 구성
EB CLI에서 환경 구성을 로컬로 저장하고, 게시할 측정치를 정의하는 항목을 추가한 다음 구성을 Elastic Beanstalk에 업로드하여 사용자 지정 측정치를 구성할 수 있습니다. 생성 중 또는 생성 후 저장된 구성을 환경에 적용할 수 있습니다.
EB CLI 및 저장된 구성을 사용하여 CloudWatch 사용자 지정 측정치를 구성하려면
-
eb init를 사용하여 프로젝트 폴더를 초기화합니다.
-
eb create 명령을 실행하여 환경을 생성합니다.
-
eb config save 명령을 실행하여 구성 템플릿을 로컬로 저장합니다. 다음 예제에서는
--cfg
옵션을 사용하여 구성의 이름을 지정합니다.$
eb config save --cfg
Configuration saved at: ~/project/.elasticbeanstalk/saved_configs/01-base-state.cfg.yml01-base-state
-
텍스트 편집기에서 저장된 구성 파일을 엽니다.
-
OptionSettings
>aws:elasticbeanstalk:healthreporting:system:
아래에ConfigDocument
키를 추가하여 원하는 각 CloudWatch 측정치를 활성화합니다. 예를 들어, 다음ConfigDocument
는 환경 레벨에서ApplicationRequests5xx
및ApplicationRequests4xx
측정치를 게시하고 인스턴스 레벨에서ApplicationRequestsTotal
측정치를 게시합니다.OptionSettings: ... aws:elasticbeanstalk:healthreporting:system:
ConfigDocument: CloudWatchMetrics: Environment: ApplicationRequests5xx: 60 ApplicationRequests4xx: 60 Instance: ApplicationRequestsTotal: 60 Version: 1
SystemType: enhanced ...예제에서 60은 측정 간의 시간(초)를 나타냅니다. 현재 이 값은 지원되는 유일한 값입니다.
참고
CloudWatchMetrics
와Rules
를 동일한ConfigDocument
옵션 설정에 결합할 수 있습니다.Rules
는 환경에 대해 향상된 상태 규칙 구성를 참조하세요.이전에
Rules
를 사용하여 강화된 상태 규칙을 구성한 경우 eb config save 명령을 사용하여 검색하는 구성 파일에 이미ConfigDocument
섹션을 포함하는Rules
키가 있습니다. 이것을 삭제하지 마세요. 동일한ConfigDocument
옵션 값에CloudWatchMetrics
섹션을 추가합니다. -
구성 파일을 저장하고 텍스트 편집기를 닫습니다. 이 예에서 업데이트된 구성 파일은 다운로드된 구성 파일과 다른 이름(
02-cloudwatch-enabled.cfg.yml
)으로 저장됩니다. 그러면 파일을 업로드할 때 별도의 저장된 구성이 생성됩니다. 새로운 구성을 생성하지 않고 다운로드한 파일과 동일한 이름을 사용하여 기존 구성을 덮어쓸 수 있습니다. -
eb config put 명령을 사용하여 업데이트된 구성 파일을 Elastic Beanstalk에 업로드합니다.
$
eb config put
02-cloudwatch-enabled
저장된 구성과 함께 eb config
get
및put
명령을 사용할 때 파일 확장명을 포함하지 마십시오. -
저장된 구성을 실행 중인 환경에 적용합니다.
$
eb config --cfg
02-cloudwatch-enabled
--cfg
옵션은 환경에 적용되는 명명된 구성 파일을 지정합니다. 구성 파일을 로컬에 또는 Elastic Beanstalk에 저장할 수 있습니다. 지정된 이름의 구성 파일이 두 위치에 모두 있으면 EB CLI는 로컬 파일을 사용합니다.
사용자 지정 지표 구성 문서 제공
Amazon CloudWatch의 사용자 지정 측정치에 대한 구성(config) 문서는 환경 및 인스턴스 수준에서 게시할 측정치를 나열하는 JSON 문서입니다. 다음 예에서는 Linux에서 사용 가능한 모든 사용자 지정 측정치를 활성화하는 구성 문서를 보여줍니다.
{
"CloudWatchMetrics": {
"Environment": {
"ApplicationLatencyP99.9": 60,
"InstancesSevere": 60,
"ApplicationLatencyP90": 60,
"ApplicationLatencyP99": 60,
"ApplicationLatencyP95": 60,
"InstancesUnknown": 60,
"ApplicationLatencyP85": 60,
"InstancesInfo": 60,
"ApplicationRequests2xx": 60,
"InstancesDegraded": 60,
"InstancesWarning": 60,
"ApplicationLatencyP50": 60,
"ApplicationRequestsTotal": 60,
"InstancesNoData": 60,
"InstancesPending": 60,
"ApplicationLatencyP10": 60,
"ApplicationRequests5xx": 60,
"ApplicationLatencyP75": 60,
"InstancesOk": 60,
"ApplicationRequests3xx": 60,
"ApplicationRequests4xx": 60
},
"Instance": {
"ApplicationLatencyP99.9": 60,
"ApplicationLatencyP90": 60,
"ApplicationLatencyP99": 60,
"ApplicationLatencyP95": 60,
"ApplicationLatencyP85": 60,
"CPUUser": 60,
"ApplicationRequests2xx": 60,
"CPUIdle": 60,
"ApplicationLatencyP50": 60,
"ApplicationRequestsTotal": 60,
"RootFilesystemUtil": 60,
"LoadAverage1min": 60,
"CPUIrq": 60,
"CPUNice": 60,
"CPUIowait": 60,
"ApplicationLatencyP10": 60,
"LoadAverage5min": 60,
"ApplicationRequests5xx": 60,
"ApplicationLatencyP75": 60,
"CPUSystem": 60,
"ApplicationRequests3xx": 60,
"ApplicationRequests4xx": 60,
"InstanceHealth": 60,
"CPUSoftirq": 60
}
},
"Version": 1
}
의 경우 문서를 JSON 객체인 옵션 설정 인수의 Value
키 값으로 AWS CLI전달합니다. 이 경우 포함된 문서에서 따옴표를 이스케이프 처리해야 합니다.
$ aws elasticbeanstalk validate-configuration-settings --application-name my-app --environment-name my-env --option-settings '[
{
"Namespace": "aws:elasticbeanstalk:healthreporting:system",
"OptionName": "ConfigDocument",
"Value": "{\"CloudWatchMetrics\": {\"Environment\": {\"ApplicationLatencyP99.9\": 60,\"InstancesSevere\": 60,\"ApplicationLatencyP90\": 60,\"ApplicationLatencyP99\": 60,\"ApplicationLatencyP95\": 60,\"InstancesUnknown\": 60,\"ApplicationLatencyP85\": 60,\"InstancesInfo\": 60,\"ApplicationRequests2xx\": 60,\"InstancesDegraded\": 60,\"InstancesWarning\": 60,\"ApplicationLatencyP50\": 60,\"ApplicationRequestsTotal\": 60,\"InstancesNoData\": 60,\"InstancesPending\": 60,\"ApplicationLatencyP10\": 60,\"ApplicationRequests5xx\": 60,\"ApplicationLatencyP75\": 60,\"InstancesOk\": 60,\"ApplicationRequests3xx\": 60,\"ApplicationRequests4xx\": 60},\"Instance\": {\"ApplicationLatencyP99.9\": 60,\"ApplicationLatencyP90\": 60,\"ApplicationLatencyP99\": 60,\"ApplicationLatencyP95\": 60,\"ApplicationLatencyP85\": 60,\"CPUUser\": 60,\"ApplicationRequests2xx\": 60,\"CPUIdle\": 60,\"ApplicationLatencyP50\": 60,\"ApplicationRequestsTotal\": 60,\"RootFilesystemUtil\": 60,\"LoadAverage1min\": 60,\"CPUIrq\": 60,\"CPUNice\": 60,\"CPUIowait\": 60,\"ApplicationLatencyP10\": 60,\"LoadAverage5min\": 60,\"ApplicationRequests5xx\": 60,\"ApplicationLatencyP75\": 60,\"CPUSystem\": 60,\"ApplicationRequests3xx\": 60,\"ApplicationRequests4xx\": 60,\"InstanceHealth\": 60,\"CPUSoftirq\": 60}},\"Version\": 1}"
}
]'
YAML로 작성된 .ebextensions
구성 파일의 경우 JSON 문서를 있는 그대로 제공할 수 있습니다.
option_settings:
- namespace: aws:elasticbeanstalk:healthreporting:system
option_name: ConfigDocument
value: {
"CloudWatchMetrics": {
"Environment": {
"ApplicationLatencyP99.9": 60,
"InstancesSevere": 60,
"ApplicationLatencyP90": 60,
"ApplicationLatencyP99": 60,
"ApplicationLatencyP95": 60,
"InstancesUnknown": 60,
"ApplicationLatencyP85": 60,
"InstancesInfo": 60,
"ApplicationRequests2xx": 60,
"InstancesDegraded": 60,
"InstancesWarning": 60,
"ApplicationLatencyP50": 60,
"ApplicationRequestsTotal": 60,
"InstancesNoData": 60,
"InstancesPending": 60,
"ApplicationLatencyP10": 60,
"ApplicationRequests5xx": 60,
"ApplicationLatencyP75": 60,
"InstancesOk": 60,
"ApplicationRequests3xx": 60,
"ApplicationRequests4xx": 60
},
"Instance": {
"ApplicationLatencyP99.9": 60,
"ApplicationLatencyP90": 60,
"ApplicationLatencyP99": 60,
"ApplicationLatencyP95": 60,
"ApplicationLatencyP85": 60,
"CPUUser": 60,
"ApplicationRequests2xx": 60,
"CPUIdle": 60,
"ApplicationLatencyP50": 60,
"ApplicationRequestsTotal": 60,
"RootFilesystemUtil": 60,
"LoadAverage1min": 60,
"CPUIrq": 60,
"CPUNice": 60,
"CPUIowait": 60,
"ApplicationLatencyP10": 60,
"LoadAverage5min": 60,
"ApplicationRequests5xx": 60,
"ApplicationLatencyP75": 60,
"CPUSystem": 60,
"ApplicationRequests3xx": 60,
"ApplicationRequests4xx": 60,
"InstanceHealth": 60,
"CPUSoftirq": 60
}
},
"Version": 1
}