CloudWatch 솔루션: Amazon EC2의 Tomcat 워크로드

이 솔루션을 사용하면 EC2 인스턴스에서 실행되는 Tomcat 서버용 CloudWatch 에이전트를 사용하여 즉시 사용 가능한 메트릭 컬렉션을 구성할 수 있습니다. 또한, 미리 구성된 CloudWatch 대시보드를 설정하는 데 도움이 됩니다. CloudWatch 관찰성 솔루션에서 모든 CloudWatch 관찰성 솔루션에 대한 일반 정보를 참조하세요.

요구 사항

이 솔루션 관련 조건은 다음과 같습니다.

이점

이 솔루션은 Tomcat 서버 모니터링을 제공함으로써 다음 사용 사례에 관한 유용한 인사이트를 제공합니다.

솔루션의 가장 중요한 장점으로는 다음과 같은 것들이 있습니다.

다음 이미지는 해당 솔루션의 대시보드 예시입니다.

비용

이 솔루션은 사용자 계정에 리소스를 생성하여 사용합니다. 표준 사용에 대한 요금이 부과되며, 다음 항목들이 포함됩니다.

CloudWatch 요금에 대한 자세한 내용은 Amazon CloudWatch 요금을 참조하세요.

요금 계산기는 이 솔루션 사용에 대한 대략적인 월별 비용을 추정하는 데 도움이 될 수 있습니다.

이 솔루션에 대한 CloudWatch 에이전트 구성

CloudWatch 에이전트는 서버와 컨테이너화된 환경에서 지속적이고 자율적으로 실행되는 소프트웨어입니다. 인프라와 애플리케이션에서 메트릭, 로그, 트레이스를 수집하여 CloudWatch와 X-Ray로 전송합니다.

CloudWatch에 대한 자세한 내용은 CloudWatch 에이전트를 사용하여 지표, 로그, 추적 수집을(를) 참조하세요.

이 솔루션의 에이전트 구성에서는 Tomcat, JVM, EC2의 기본 메트릭을 수집합니다. CloudWatch 에이전트는 대시보드가 기본적으로 표시하는 것보다 더 많은 JVM 메트릭을 수집하도록 구성할 수 있습니다. 수집할 수 있는 모든 Tomcat 지표 목록은 Tomcat 지표 수집 섹션을 참조하세요. 수집할 수 있는 모든 JVM 지표 목록은 JVM 지표 수집 섹션을 참조하세요. Amazon EC2 메트릭 목록은 Linux 및 macOS 인스턴스의 CloudWatch 에이전트가 수집하는 지표을(를) 참조하세요.

Tomcat 서버의 JMX 포트 노출

CloudWatch 에이전트는 JMX를 사용하여 Tomcat 서버와 JVM 프로세스 관련 메트릭을 수집합니다. 이 작업을 수행하려면 서버에서 JMX 포트를 노출해야 합니다. 모니터링 및 관리를 위해 JMX 포트를 활성화하려면 Tomcat 서버의 시스템 속성을 설정합니다. 환경 변수를 CATALINA_OPTS 을(를) 사용하여 Tomcat에 필요한 시스템 속성을 설정할 수 있습니다. 환경 변수를 설정하기에 가장 적합한 위치에서 Tomcat 서버의 시작 스크립트와 구성 파일을 검토합니다. 반드시 사용하지 않는 포트 번호를 지정해야 합니다. 변경 후에는 서버를 다시 시작해야 합니다.

export CATALINA_OPTS="-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=<<port-number>> -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false"

이 예제에서는 인증되지 않은 JMX를 설정합니다. 보안 정책/요건에 따라 암호 인증으로 JMX를 활성화하거나 원격 액세스용 SSL을 활성화해야 하는 경우 JMX 설명서를 참조하여 필요한 속성을 설정합니다.

JMX 포트를 확인하려면 ps aux | grep jmxremote.port을(를) 실행합니다. 실행 결과를 통해 JMX 포트가 JVM 프로세스에 설정되었다고 표시되어야 합니다.

Tomcat 솔루션의 에이전트 구성

에이전트가 수집한 메트릭은 에이전트 구성에 정의되어 있습니다. 이 솔루션은 솔루션 대시보드에 적합한 차원에 권장 메트릭을 수집하는 에이전트 구성을 제공합니다.

솔루션 배포 단계는 뒷부분의 솔루션 에이전트 배포에 설명되어 있습니다. 다음 정보는 환경에 맞게 에이전트 구성을 사용자 지정하는 방법을 이해하는 데 도움이 됩니다.

환경에 맞게 다음 에이전트 구성의 일부를 사용자 지정해야 합니다.

예를 들어, 동일 AWS 계정에 Tomcat 애플리케이션이 두 개(하나는 billing-system 애플리케이션용, 나머지는 order-system 애플리케이션용) 실행 중인 경우라면 개별 인스턴스의 에이전트 구성에서 이에 따라 AppName 차원과 ProcessGroupName 차원을 설정할 수 있습니다.

이러한 지침을 따르면 솔루션이 AppName 차원과 ProcessGroupName 차원에 따라 메트릭을 자동으로 그룹화합니다. 대시보드에는 특정 Tomcat 애플리케이션의 메트릭을 선택하고 볼 수 있는 드롭다운 옵션이 포함되어 있으므로 개별 애플리케이션의 성능을 각각 모니터링할 수 있습니다.

Tomcat 호스트의 에이전트 구성

Tomcat 애플리케이션이 배포된 EC2 인스턴스에 다음 CloudWatch 에이전트 구성을 사용합니다. 구성은 뒷부분의 2단계: Systems Manager Parameter Store에 권장 에이전트 구성 파일을 저장에 설명된 대로 SSM의 Parameter Store에 파라미터로 저장됩니다.

AppName을 인스턴스가 속한 Tomcat 애플리케이션임을 알 수 있는 이름으로 바꿉니다. 포트 번호를 Tomcat 서버의 JMX 포트 번호로 바꾸세요. JMX가 암호 인증 또는 원격 액세스용 SSL을 통해 활성화된 경우, 필요에 따라 에이전트 구성에서 TLS 또는 권한 부여를 설정하는 방법에 대한 자세한 내용을 보려면 Java Management Extensions(JMX) 지표 수집 섹션을 참조하세요.

이 구성(JMX 블록 외부에 표시된 구성)에 표시된 EC2 메트릭은는 Linux 및 macOS 인스턴스에서만 작동합니다. Windows 인스턴스를 사용하는 경우 구성에서 이러한 메트릭을 생략하도록 선택할 수 있습니다. Windows 인스턴스에서 수집한 메트릭에 관해서는 Windows Server 인스턴스의 CloudWatch 에이전트가 수집하는 지표에서 자세한 내용을 참조하세요.

{
  "metrics": {
    "namespace": "CWAgent",
    "append_dimensions": {
      "InstanceId": "${aws:InstanceId}"
    },
    "metrics_collected": {
      "jmx": [
        {
          "endpoint": "localhost:port-number",
          "tomcat": {
            "measurement": [
              "tomcat.sessions",
              "tomcat.errors",
              "tomcat.processing_time",
              "tomcat.traffic",
              "tomcat.max_time",
              "tomcat.request_count",
              "tomcat.threads"
            ]
          },
          "append_dimensions": {
            "AppName": "AppName"
          }
        },
        {
          "endpoint": "localhost:port-number",
          "jvm": {
            "measurement": [
              "jvm.classes.loaded",
              "jvm.gc.collections.count",
              "jvm.gc.collections.elapsed",
              "jvm.memory.heap.committed",
              "jvm.memory.heap.max",
              "jvm.memory.heap.used",
              "jvm.memory.nonheap.committed",
              "jvm.memory.nonheap.max",
              "jvm.memory.nonheap.used",
              "jvm.threads.count"
            ]
          },
          "append_dimensions": {
            "ProcessGroupName": "AppName"
          }
        }
      ],
      "disk": {
        "measurement": [
          "used_percent"
        ]
      },
      "mem": {
        "measurement": [
          "used_percent"
        ]
      },
      "swap": {
        "measurement": [
          "used_percent"
        ]
      },
      "netstat": {
        "measurement": [
          "tcp_established",
          "tcp_time_wait"
        ]
      }
    }
  }
}

솔루션 에이전트 배포

사용 사례에 따라 CloudWatch 에이전트를 설치하는 방법에는 여러 가지가 있습니다. 이 솔루션에는 Systems Manager를 사용하는 것이 좋습니다. Systems Manager는 콘솔 환경을 제공하며 단일 AWS 계정 내에 관리형 서버 플릿을 더 쉽게 관리할 수 있습니다. 이 섹션의 내용은 Systems Manager를 사용하며, 기존 구성으로 CloudWatch 에이전트를 실행하지 않는 경우에 적용할 수 있습니다. CloudWatch 에이전트가 실행 중인지 확인에 나열된 단계에 따라 CloudWatch 에이전트가 실행 중인지 확인할 수 있습니다.

JVM 애플리케이션이 배포된 EC2 호스트에서 이미 CloudWatch 에이전트를 실행 중이며 에이전트 구성을 관리 중이라면 이 섹션의 내용을 건너뛰어 기존 배포 메커니즘에 따라 구성을 업데이트할 수 있습니다. JVM의 에이전트 구성을 기존 에이전트 구성과 병합한 다음에 병합된 구성을 배포해야 합니다. Systems Manager를 사용하여 CloudWatch 에이전트의 구성을 저장하고 관리하는 경우, 해당 구성을 기존 파라미터 값에 병합할 수 있습니다. 자세한 내용은 CloudWatch 에이전트 구성 파일 관리를 참조하세요.

이 배포 프로세스는 다음 단계를 통해 이루어집니다.

1단계: 대상 EC2 인스턴스에 필요한 IAM 권한이 있는지 확인

Systems Manager가 CloudWatch 에이전트를 설치하고 구성할 수 있도록 권한을 부여해야 합니다. 또한, CloudWatch 에이전트가 EC2 인스턴스에서 CloudWatch로 원격 측정을 게시할 수 있는 권한을 부여해야 합니다. 인스턴스에 연결된 IAM 역할에 CloudWatchAgentServerPolicy와 AmazonSSMManagedInstanceCore IAM 정책이 연결되어 있는지 확인합니다.

2단계: Systems Manager Parameter Store에 권장 에이전트 구성 파일을 저장

Parameter Store는 구성 파라미터를 안전하게 저장하고 관리하여 EC2 인스턴스에 CloudWatch 에이전트 설치하는 작업을 간소화하므로 하드 코딩 값이 필요 없습니다. 이를 통해 보다 안전하고 유연한 배포 프로세스를 보장하며 중앙 집중식 관리를 가능하게 하는 동시에 다양한 인스턴스에서 구성을 더 쉽게 업데이트할 수 있습니다.

다음 단계에 따라 권장 CloudWatch 에이전트 구성 파일을 Parameter Store에 파라미터로 저장합니다.

3단계: CloudWatch 에이전트를 설치하고 AWS CloudFormation 템플릿을 사용하여 구성을 적용

AWS CloudFormation을(를) 사용하여 에이전트를 설치하고 이를 이전 단계에서 생성한 CloudWatch 에이전트 구성을 사용하도록 구성할 수 있습니다.

템플릿 파일을 먼저 편집하여 사용자 지정하려면 스택 생성 마법사에서 템플릿 파일 업로드 옵션을 선택하여 편집된 템플릿을 업로드합니다. 자세한 내용은 AWS CloudFormation 콘솔에서 스택 생성 단원을 참조하세요. https://aws-observability-solutions.s3.amazonaws.com/CloudWatchAgent/CFN/v1.0.0/cw-agent-installation-template-1.0.0.json 링크를 사용하여 템플릿을 다운로드할 수 있습니다.

4단계: 에이전트 설정이 올바르게 구성되었는지 확인

CloudWatch 에이전트가 실행 중인지 확인에 나열된 단계에 따라 CloudWatch 에이전트가 설치되었는지 확인할 수 있습니다. CloudWatch 에이전트가 설치되어 실행되지 않는 경우 모든 항목을 올바르게 설정했는지 확인합니다.

모든 것이 올바르게 설정된 경우 CloudWatch에 게시되는 Tomcat 메트릭이 표시됩니다. CloudWatch 콘솔을 확인하여 게시되고 있는지 확인할 수 있습니다.

Tomcat 솔루션 대시보드 생성

이 대시보드에는 새로 생성된 메트릭이 표시되며 Tomcat 애플리케이션 서버와 기본 JVM을 모두 보여줍니다. 이 대시보드는 Tomcat 워크로드의 상태에 대한 상위 기여자 보기를 제공합니다. 상위 기여자 보기에는 메트릭당 상위 10개의 위젯이 표시됩니다. 이를 통해 이상치를 한눈에 식별할 수 있습니다. 또한 대시보드에는 모든 인스턴스에서 메트릭을 집계하고 제시하여 클러스터의 개요를 포함하여 클러스터의 전반적인 상태 및 운영 상태에 대한 개략적인 요약을 제공합니다.

솔루션 대시보드에는 EC2 메트릭이 표시되지 않습니다. EC2 메트릭을 보려면 EC2 자동 대시보드를 사용하여 EC2 벤딩 메트릭을 확인하고 EC2 콘솔 대시보드를 사용하여 CloudWatch 에이전트에서 수집한 EC2 메트릭을 확인해야 합니다. AWS 서비스의 자동 대시보드에 대한 자세한 내용은 단일 AWS 서비스에 대한 CloudWatch 대시보드 보기을(를) 참조하세요.

대시보드를 생성하기 위해 사용할 수 있는 옵션은 다음과 같습니다.

CloudWatch 콘솔을 사용하여 대시보드를 생성하면 실제 생성 및 청구 전에 대시보드를 미리 볼 수 있습니다.

템플릿 파일을 편집하여 범용으로 사용자 지정하려면 스택 생성 마법사의 템플릿 파일 업로드 옵션을 사용하여 편집된 템플릿을 업로드하면 됩니다. 자세한 내용은 AWS CloudFormation 콘솔에서 스택 생성 단원을 참조하세요. https://aws-observability-solutions.s3.amazonaws.com/Tomcat_EC2/CloudWatch/CFN/v1.0.0/dashboard-template-1.0.0.json 링크를 사용하여 템플릿을 다운로드할 수 있습니다.

Tomcat 모니터링 대시보드 시작하기

새 Tomcat 대시보드로 시도해 볼 수 있는 작업들 가운데는 다음과 같은 것이 있습니다. 이들 작업을 통해 대시보드가 올바르게 작동하는지 확인하고 이를 사용하여 Tomcat 애플리케이션 모니터링과 관련된 몇 가지 실습 경험을 제공할 수 있습니다. 이들 작업을 직접 실행해 보면 대시보드 탐색 및 시각화된 메트릭 해석에 익숙해질 수 있습니다.

드롭다운 목록 사용

대시보드는 모니터링할 특정 Tomcat 애플리케이션을 필터링하고 선택하는 데 사용할 수 있는 드롭다운 목록을 상단에 제공합니다. 특정 Tomcat 애플리케이션에 대한 메트릭을 표시하려면 Tomcat 앱 드롭다운 목록에서 해당 애플리케이션 이름을 선택합니다.

애플리케이션 상태 확인

앱 개요 섹션에서 요청 위젯, 오류 위젯, 오류율 위젯을 찾습니다. 이들 위젯에서는 애플리케이션의 요청 처리 성능에 대한 상위 수준 요약을 제공합니다. 조사가 필요한 문제임을 나타낼 수 있는 비정상적으로 오류 수나 비율이 높은 부분을 찾습니다.

요청 처리 모니터링

요청 처리 시간 섹션에서 최대 시간 위젯과 전체 요청 처리 총시간 위젯을 찾습니다. 이들 메트릭에서는 요청 처리 시 잠재적인 성능 병목 현상을 식별하는 데 도움을 줍니다. 다른 서버에 비해 최대 처리 시간이 훨씬 더 긴 서버를 찾습니다.

네트워크 트래픽 분석

네트워크 트래픽 섹션에서 전송된 트래픽 위젯과 수신된 트래픽 위젯을 찾습니다. 이들 위젯에서는 네트워크를 통해 애플리케이션에서 송수신하는 데이터의 양을 보여줍니다. 트래픽 수준이 예상 밖으로 높으면 네트워크 포화가 있거나 비효율적인 데이터 전송과 관련된 문제가 있다는 의미일 수 있습니다.

스레드 사용량 조사

세션 및 스레드 섹션에서 사용 중인 스레드 수 위젯, 스레드 수 위젯, 세션 위젯을 찾습니다. 이들 메트릭에서는 애플리케이션의 스레드 관리 및 활성 사용자 세션에 대한 인사이트를 제공합니다. 사용 중인 스레드 수나 세션 수가 비정상적으로 많아 잠재적으로 리소스 제약이 있을 수 있는 서버를 찾습니다.