E1. OPENMARU APM 개요
Diátaxis: Explanation(이해) · 대상: 운영자 / 관리자 (처음 사용하는 분 포함) ← 목차로
이 문서는 OPENMARU APM이 무엇이고, 무엇을 보여 주며, 왜 그렇게 구성되어 있는지를 설명합니다. 버튼을 누르는 방법 같은 조작은 다루지 않습니다 — 실제 사용은 T1. 5분 빠른 시작에서, 개념의 깊은 설명은 E2. 핵심 개념에서 이어집니다.
E1.1 OPENMARU APM이란
OPENMARU APM(Application Performance Monitoring, 애플리케이션 성능 모니터링)은 운영 중인 자바 애플리케이션과 그 주변 환경 — 웹서버·데이터베이스·서버 자원 — 을 한 화면에서 실시간으로 들여다보고, 문제가 생겼을 때 어디가 원인인지 빠르게 짚어 주는 모니터링 도구입니다.
참고 APM은 "애플리케이션이 지금 잘 돌고 있는가"를 숫자와 그래프로 보여 주는 모니터링 분야를 가리키는 일반 용어입니다. OPENMARU APM은 그 도구의 한 제품 이름입니다.
왜 APM이 필요한가
서버가 켜져 있다고 해서 서비스가 건강한 것은 아닙니다. 응답이 느려지거나, 특정 SQL이 점점 무거워지거나, 메모리가 조금씩 새어 나가는 일은 장애로 터지기 전까지 눈에 잘 띄지 않습니다. APM은 이런 변화를 평소에 수치로 쌓아 두었다가,
- 평소와 다른 패턴이 보이면 이벤트로 남겨 알려 주고,
- 느린 요청이 있으면 요청 한 건이 처리되는 전 과정(어느 SQL·어느 외부 호출에서 시간이 걸렸는지)을 되짚어 주고,
- 2026 리뉴얼부터는 AI 도우미(CogentAI) 가 그 수치의 의미와 가능한 원인을 함께 설명해 줍니다. (신규)
즉 OPENMARU APM의 목적은 한 문장으로 "지금 괜찮은지 보고, 문제가 생기면 원인을 빨리 찾는 것" 입니다. 이 매뉴얼 전체가 그 두 가지를 돕도록 짜여 있습니다.
E1.2 무엇을 모니터링하나
OPENMARU APM은 다섯 영역을 다룹니다. 이 다섯은 좌측 메뉴의 큰 분류와 그대로 대응하므로, 화면 구조를 외울 필요 없이 "무엇을 보고 싶은가"로 메뉴를 찾을 수 있습니다.
| 영역 | 좌측 메뉴 | 모니터링하는 것 | 관련 참조 |
|---|---|---|---|
| WAS (자바 애플리케이션) | WAS | 요청 처리량(TPS)·응답시간·APDEX·JVM 힙/GC·트랜잭션 흐름 | R2.1 |
| 웹서버 | 웹서버 | Apache·Nginx 등 웹 계층의 요청·워커·트래픽 | R2.2 |
| 데이터베이스 | 데이터베이스 | DBMS(MySQL·CUBRID 등) 연결·응답시간·클러스터 상태 | R2.3 |
| 서버(시스템) | 서버 | OS의 CPU·메모리·디스크·네트워크 | R2.4 |
| SLA | SLA 모니터링 | 서비스 가용성·목표 대비 달성 여부 | H17 |
이 다섯 영역은 서로 떨어진 정보가 아닙니다. 예를 들어 WAS 응답이 느려졌을 때 그 원인이 DB 쪽인지, 서버 자원 부족인지, 외부 호출 때문인지를 같은 시간축에서 비교하도록 설계되어 있습니다. 영역을 가로지르는 진단 방법은 H6. 느린 트랜잭션 원인 찾기에서 다룹니다.
환경에 따라 쿠버네티스(K8s), 분산 추적(Trace), 텔레메트리(OpenTelemetry) 메뉴가 추가로 보일 수 있습니다. 표시 여부는 관리자 설정에 따릅니다.
E1.3 화면은 왜 이렇게 구성되어 있나
로그인하면 기본으로 WAS 대시보드가 열립니다. 모든 화면은 아래 세 부분을 공유합니다 — 한 번 익히면 어느 메뉴로 가도 같은 구조라 길을 잃지 않습니다.
| 영역 | 역할 | 왜 여기에 있나 |
|---|---|---|
| 상단 헤더 | 검색·AI 진단·테마/언어·알림·설정·사용자 메뉴 | 어느 화면에서나 필요한 전역 기능이라 항상 같은 자리 |
| 좌측 메뉴 | 큰 분류 → 작은 분류 2단계 (신규) + 앱 그룹/인스턴스 선택기 | "무엇을 볼지"(메뉴)와 "누구를 볼지"(대상)를 한곳에서 정함 |
| 본문 영역 | 선택한 화면의 차트·표·카드 + 컨텍스트 셀렉터·기간 선택기 | "무엇을·언제 기준으로" 볼지 본문 상단에서 즉시 바꿈 |
이 구조의 핵심은 "무엇을 / 누구를 / 언제"가 항상 같은 위치에서 결정된다는 점입니다. 그래서 한 화면에서 다른 화면으로 옮겨도 보고 있던 대상·기간이 유지됩니다.
- 메뉴 전체 지도는 R1. 화면 지도
- 대상·기간을 고르는 공통 UI는 R4. 공통 UI 요소
E1.4 5.1.0-11.0 디자인 리뉴얼 — 무엇이, 왜 바뀌었나
디자인 리뉴얼은 단순한 외형 변경이 아니라, "문제를 더 빨리 찾는다" 는 목적에 맞춰 화면과 동작을 다시 설계한 것입니다. 핵심 변화와 그 의도는 다음과 같습니다.
| 변경 | 의도(왜) | 더 알아보기 |
|---|---|---|
| 메뉴 2단계 정리 | 한 줄로 길던 메뉴를 큰 분류 → 작은 분류로 — 원하는 화면까지 가는 단계 단축 | R1 |
| 실시간 화면 부드럽게 | 데이터가 몰려도 끊기지 않게 — 관제 화면을 오래 켜둬도 안정 | T1 |
| 트랜잭션 자동 진단 | 느린 SQL·외부 호출·오류를 워터폴 그림으로 — "어디가 느린지" 먼저 짚어 줌 | H6, H5 |
| 개요 탭 통합 | 흩어진 차트를 한 화면에 핵심만 — 여러 번 클릭하던 것을 한 번으로 | R2.1 |
| SLA 한눈에 | 위→아래 순서 정리 — "지금 SLA 괜찮은가"를 1초에 판단 | H17 |
| AI 도우미(CogentAI) | 차트·이벤트마다 AI 분석 — 지표의 의미와 원인을 바로 설명 | H14 |
| 똑똑한 알람 | 같은 알람 반복 → 시작·복구 1회 + 정기 리마인더 — 메일함 폭주 방지 | H15, H16 |
| 안전한 운영 | 위험 작업 전 확인창 — 야간 대응 중 실수 방지 | R6 |
| 대규모 환경 안정성 | 알람 엔진 경량화·인스턴스 변경 빠른 반영 — 같은 서버로 더 많은 인스턴스 수용 | R6 |
| PromQL 지원 | APM 메트릭을 Prometheus 표준 쿼리로 노출 — AI·외부 도구 직결 | R7 |
리뉴얼 이전을 써 본 분이라면, 기능이 사라진 것이 아니라 더 짧은 동선과 더 분명한 색·간격으로 재배치되었다고 보면 됩니다.
E1.5 권장 사용 환경
OPENMARU APM 웹 콘솔은 별도 설치 없이 브라우저로 접속합니다.
- 브라우저: 최신 버전의 모던 브라우저(Chrome·Edge·Safari)를 권장합니다.
- 화면 크기: 데스크톱 모니터 기준으로 설계되었습니다. 가로 폭이 넓을수록 차트를 더 여유 있게 볼 수 있으며, 상황실·관제용 대형 모니터에 적합합니다. (사양이 낮은 노트북·태블릿에서도 동작하도록 실시간 화면이 최적화되어 있습니다.)
- 계정: 관리자에게서 발급받은 사용자 ID/비밀번호. 권한에 따라 보이는 메뉴가 다릅니다.
주의 일부 관리 기능(이 매뉴얼에서 (관리자 전용) 로 표시)은 관리자 권한이 있어야 보입니다. 메뉴가 보이지 않는다면 권한 때문일 수 있으니 관리자에게 문의하세요.
에이전트 설치와 APM 서버 구축은 이 사용자 매뉴얼의 범위가 아니며, 별도 설치 가이드에서 다룹니다.
다음으로 읽을 것
- 개념을 더 깊이 — E2. 핵심 개념과 데이터 흐름 (애플리케이션 그룹·인스턴스·에이전트, 트랜잭션, 데이터가 화면에 오기까지)
- 지표의 의미 — E3. 지표의 의미 (TPS·APDEX·힙·GC 등)
- 바로 써 보기 — T1. 5분 빠른 시작