Apache Tomcat 성능 카운터 및 이벤트 처리 규칙 가이드

개요

성능 카운터는 시스템 활동과 성능(메트릭)을 측정합니다. 애플리케이션은 미리 정의된 간격으로 현재 값을 조회합니다. 프로빙과 데이터 수집의 목적은 수집된 데이터를 분석하여 성능 그래프나 차트로 시각화하는 것입니다. 카운터는 수동으로 정의하거나 템플릿에서 불러올 수 있습니다. 템플릿은 특정 장치에 대한 프로빙 매개변수를 미리 정의하여 카운터 생성 속도와 정확성을 높입니다.

카운터 템플릿의 주요 정보:

• 이름 및 설명 - 고유 식별자와 선택적 설명
• 장치 유형 - 모니터링 대상 장치의 유형
• 프로토콜 유형 - 사용되는 프로토콜
• 프로빙 간격 - 프로빙 사이의 대기 시간

중요: 템플릿을 사용할 때는 대상 Tomcat 버전과 JMX 엔드포인트 구성을 확인하세요. 템플릿이 JMX 이름 또는 경로를 가정하는 경우가 있습니다.

Tomcat용 성능 카운터 추가

아래 절차는 GUI 기반 관리 콘솔을 기준으로 합니다. 화면이나 메뉴 명칭은 사용 중인 제품 버전과 로캘에 따라 다를 수 있습니다.

1. Home 뷰에서 측정하려는 장치를 측면 트리에서 선택합니다.
2. Monitors 탭을 선택한 뒤 오른쪽 상단의 Counter list 링크를 클릭해 카운터 목록으로 전환합니다. 카운터 목록이 표시됩니다.
3. 전역 작업 메뉴에서 Create counter를 선택하고 Go를 클릭합니다.

4. 생성하려는 카운터(템플릿)를 선택하고 Next를 클릭합니다.
5. 데이터가 로드되면 편집 창이 표시됩니다. 여기서 모든 카운터 속성을 입력합니다.

6. 나머지 카운터 매개변수(알람, 임계값 등)를 지정한 뒤 Finish를 클릭합니다.
7. 새 카운터가 생성되어 카운터 목록에 표시됩니다.

중요: 프로빙 간격은 짧게 설정하면 실시간성은 좋아지지만 시스템 부하가 증가합니다. 기본값을 사용해 안정성을 확인한 다음 점진적으로 줄이는 방식을 권장합니다.

맞춤 이벤트 처리 규칙 만들기

이 섹션에서는 알람 생성, 이벤트 드롭/포워딩, 심각도 할당과 같은 기본 이벤트 처리 규칙을 설정하는 방법을 설명합니다.

1. 대상 호스트를 선택한 뒤 Events 탭으로 이동합니다.
2. 이벤트를 선택하고 Assign processing rules를 선택한 다음 Go를 클릭합니다.
3. 규칙 할당 대화창이 표시됩니다.

4. 규칙 카테고리를 선택하고 Add new rule을 클릭합니다.
5. 새로 만든 이벤트 처리 규칙은 즉시 활성화되어 별도의 로그아웃 없이 동작합니다.

팁: 이벤트 처리 규칙을 만들 때는 우선순위(심각도), 경보 발생 기준(연속 발생 횟수 또는 기간), 그리고 알림 대상(메일, 웹훅, 티켓 시스템)을 명확히 정의하세요.

Tomcat 플러그인 개요

Tomcat 플러그인은 다음 네 가지 뷰를 제공합니다. 각 뷰는 모니터링에 필요한 핵심 메트릭과 관련 차트를 포함합니다.

• 일반 정보 뷰 - Tomcat 버전, 운영체제 이름/버전, JVM 공급사 및 버전, JVM 정보, 제어 포트, 평균 응답 시간(대시보드에는 응답 요약과 스레드 가용성 차트 포함).
• 애플리케이션 뷰 - 애플리케이션 상태(현재 세션, 피크 세션), 서블릿과 페이지 성능(요청 URL과 평균 응답 시간).
• 요청 프로세서 뷰 - 요청 프로세서와 전역 요청 프로세서 정보(URI, 워커, 요청/오류 수, 송수신 바이트, 처리 시간) 및 커넥터별 응답 요약 차트.
• 커넥터 및 스레드 풀 뷰 - 커넥터 매개변수(포트, 프로토콜, secure, redirect port, max post size), 스레드 풀(name, 현재 바쁜 스레드, 현재 스레드 수, max spare threads) 및 스레드 가용성 차트.

이 가이드의 모든 단계를 완료했다면 이제 Apache Tomcat 애플리케이션을 모니터링할 준비가 되었습니다.

실무 적용을 위한 추가 내용

아래 항목들은 실제 운영 환경에서 유용한 체크리스트와 절차입니다. 필요에 따라 골라 적용하세요.

플레이북: 카운터 템플릿 적용 절차

1. 템플릿 사전검토: 템플릿이 대상 Tomcat 버전과 JMX 네임스페이스에 맞는지 확인.
2. 테스트 장비 적용: 프로덕션 이전에 스테이징 서버에 적용해 프로빙 부하와 데이터 유효성 확인.
3. 임계값 기본값 설정: CPU/메모리/응답시간에 대해 보수적인 알람 임계값을 설정.
4. 롤아웃: 장비 그룹별로 점진 적용(예: 10% → 50% → 전수).
5. 모니터링 검토: 24–72시간 동안 경보 빈도와 false positive를 분석해 임계값 조정.

역할별 체크리스트

운영자:

• 템플릿 적용 및 모니터링 주기 확인
• 로그 및 이벤트 알림 수신 설정

SRE/엔지니어:

• JMX/TLS 인증 설정 검토
• 대시보드와 SLI 정의

개발자:

• 애플리케이션 레벨 메트릭(응답 시간, 오류율) 확인
• 성능 문제가 발견되면 코드 프로파일링 수행

수락 기준

• 카운터가 설정된 장치에서 정상적으로 데이터를 1시간 이상 수집할 것
• 알람이 정책에 따라 적절히 생성되고, 지정한 대상에 전달될 것
• 프로빙으로 인한 시스템 부하가 허용 범위(예: 정상 운영시 CPU 사용률 5% 이하 상승)를 초과하지 않을 것(조직 정책에 맞게 정의)

테스트 케이스 예시

• 카운터 생성 후 5분 이내에 첫 데이터 포인트가 수집되는지 확인
• 이벤트 처리 규칙으로 심각도 변경이 즉시 반영되는지 확인
• 템플릿 삭제 후 롤백 테스트로 원상 복구 가능 여부 검증

문제 해결(런북)

문제: 카운터가 데이터 수집을 하지 않음

• 1단계: 대상 Tomcat이 실행 중인지 확인
• 2단계: JMX 포트/자격증명 확인
• 3단계: 방화벽/네트워크 문제 확인(포트 접근성)
• 4단계: 모니터링 에이전트 로그에서 에러 메시지 확인

문제: 이벤트가 규칙에 따라 처리되지 않음

• 규칙 우선순위와 적용 대상(호스트/태그)을 확인
• 규칙 작성 시 사용된 조건식(정규식 등) 검증
• 시스템 로그에서 이벤트 매칭 과정 추적

보안 및 개인정보 주의사항

• JMX 접속 시 인증과 TLS를 사용해 커뮤니케이션을 암호화하세요.
• 모니터링 데이터에 민감한 정보(PII)가 포함될 수 있으면 수집 정책을 제한하거나 마스킹하세요.
• 웹훅/알림 연동 시 외부 엔드포인트 인증을 적용하세요.

대체 접근법 및 호환성

• JMX 기반 모니터링 대신 Prometheus JMX Exporter나 Micrometer를 사용해 메트릭을 수집할 수 있습니다.
• Tomcat 버전에 따라 JMX MBean 네임스페이스가 달라질 수 있으므로 템플릿을 버전별로 관리하세요.

간단한 휴리스틱(정리)

• 프로빙 간격: 30초–5분 범위에서 시작. 실시간성이 필요하면 짧게, 안정성 중심이면 길게.
• 임계값 설정: 베이스라인을 수집한 뒤 95번째 백분위수 값을 기준으로 조정.
• 알람 정책: 노이즈를 줄이려면 동일 알람의 연속 발생 횟수 기반으로 알람 발생을 제어.

1라인 용어집

• 프로빙: 모니터링 에이전트가 메트릭을 주기적으로 조회하는 행위
• 템플릿: 미리 정의된 카운터 설정 모음
• JMX: Java Management Extensions, JVM 및 애플리케이션 관리를 위한 인터페이스

요약

• 템플릿을 활용하면 Tomcat용 카운터를 빠르게 생성할 수 있습니다.
• 이벤트 처리 규칙은 즉시 적용되어 실시간 알림과 포워딩을 제어합니다.
• 운영 시 보안(TLS/인증), 프로빙 부하, 버전 호환성에 유의해야 합니다.

중요: 이 문서는 GUI 중심의 일반적인 절차를 설명합니다. 사용 중인 모니터링 제품의 메뉴명과 동작 방식이 다르면 해당 제품 설명서를 우선 확인하세요.