향상된 상태 보고 지표 Elastic Beanstalk 콘솔을 사용하여 CloudWatch 측정치 구성 EB CLI를 사용하여 CloudWatch 사용자 지정 측정치 구성 사용자 지정 지표 구성 문서 제공

환경에 대한 Amazon CloudWatch 사용자 지정 측정치 게시

AWS Elastic Beanstalk 확장 상태 보고에서 수집된 데이터를 Amazon CloudWatch에 사용자 지정 지표로 게시할 수 있습니다. 측정치를 CloudWatch에 게시하면 시간 경과에 따른 애플리케이션 성능의 변경 사항을 모니터링하고 리소스 사용량 및 요청 지연 시간이 로드와 조정되는 방식을 추적하여 잠재적 문재를 식별할 수 있습니다.

측정치를 CloudWatch에 게시하면 모니터링 그래프 및 경보에도 해당 측정치를 사용할 수 있습니다. 무료 측정치인 EnvironmentHealth는 확장 상태 보고를 사용할 때 자동으로 활성화됩니다. EnvironmentHealth를 제외한 다른 사용자 지정 측정치에 대해서는 표준 CloudWatch 요금이 발생합니다.

환경에 대한 CloudWatch 사용자 지정 측정치를 게시하려면 먼저 환경에서 확장 상태 보고를 활성화해야 합니다. 자세한 내용은 Elastic Beanstalk 확장 상태 보고 활성화 섹션을 참조하세요.

주제

향상된 상태 보고 지표
Elastic Beanstalk 콘솔을 사용하여 CloudWatch 측정치 구성
EB CLI를 사용하여 CloudWatch 사용자 지정 측정치 구성
사용자 지정 지표 구성 문서 제공

향상된 상태 보고 지표

환경에서 확장 상태 보고를 활성화한 경우 확장 상태 보고 시스템에서 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
CPUPriveleged: 인스턴스만 해당됩니다. 마지막 1분 동안 각 상태에서 CPU가 소비한 시간의 비율을 나타냅니다.

Elastic Beanstalk 콘솔을 사용하여 CloudWatch 측정치 구성

Elastic Beanstalk 콘솔을 사용하여 확장 상태 보고 측정치를 CloudWatch에 게시하고 모니터링 그래프 및 경보에 측정치를 사용할 수 있도록 환경을 구성할 수 있습니다.

Elastic Beanstalk 콘솔에서 CloudWatch 사용자 지정 측정치를 구성하려면

Elastic Beanstalk 콘솔을 연 다음 리전(Regions) 목록에서 해당 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 01-base-state
Configuration saved at: ~/project/.elasticbeanstalk/saved_configs/01-base-state.cfg.yml
```
텍스트 편집기에서 저장된 구성 파일을 엽니다.
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
}

AWS CLI의 경우 그 자체로 JSON 객체인 옵션 설정 인수에서 Value 키에 대한 값으로 문서를 전달합니다. 이 경우 포함된 문서에서 따옴표를 이스케이프 처리해야 합니다.


$ 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
}

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

향상된 상태 규칙

API 사용자