사용 매뉴얼
제니퍼 APM 앱은 JENNIFER APM이 모니터링하는 서비스의 성능을 로그프레소 소나 안에서 보고 분석하게 해 주는 앱입니다. 앱은 두 부분으로 되어 있습니다.
- 트랜잭션 수집 - 제니퍼 Open API 토큰으로 종료된 트랜잭션의 응답시간, CPU 시간, SQL 시간, 오류 유형을 주기적으로 수집해 테이블에 쌓습니다. 다른 로그와 엮어 검색하고 탐지 규칙을 걸 수 있습니다
- JENNIFER 콘솔 - 콘솔 계정으로 JENNIFER 웹 콘솔에 로그인해, 콘솔의 대시보드, 분석, 통계 화면을 소나 메뉴에서 엽니다. 같은 콘솔 데이터를 쿼리 명령어로도 읽을 수 있어, 화면에서 본 이상을 쿼리나 AI 에이전트로 끝까지 추적할 수 있습니다
콘솔 화면은 JENNIFER 5.7.0.1 콘솔과 배치, 사용법, 문구가 같으므로 JENNIFER를 써 본 운영자라면 익숙한 방식으로 쓸 수 있습니다.
사전 준비
쓰려는 부분에 따라 준비할 것이 다릅니다. 자세한 절차는 설치 매뉴얼에 있습니다.
- 트랜잭션 수집 - 제니퍼 Open API 토큰,
JENNIFER APM유형 접속 프로파일, 수집기 - 콘솔 화면과 콘솔 쿼리 명령어 - 앱 1.1.2610.0 이상, JENNIFER 콘솔 계정,
JENNIFER 콘솔유형 접속 프로파일 - AI 에이전트 원인 분석 - 위의 콘솔 준비에 더해 AI 에이전트 앱(에이전틱 SOC 또는 AI 어시스턴트)
기본 흐름
기본 흐름은 대시보드로 감시 → X-View에서 트랜잭션 고르기 → 트랜잭션 상세 → 분석·통계로 넓혀 보기입니다.
- 대시보드에서 TPS, 응답시간, 액티브 서비스, X-View를 실시간으로 지켜봅니다
- X-View 차트에서 튀어 오른 점들을 마우스로 드래그하면 X-View 트랜잭션 창이 열리고, 고른 트랜잭션이 목록으로 나옵니다
- 목록에서 트랜잭션을 클릭하면 타임라인, 콜 트리 같은 트랜잭션 상세에서 어느 SQL, 외부 호출, 메서드가 시간을 썼는지 봅니다
- 지난 시간대를 다시 보거나 범위를 넓힐 때는 분석의 X-View, SFR과 통계의 일일·월별 시스템 성능을 씁니다
화면으로 하기 어려운 일, 예를 들어 하루치 지표를 기준선과 비교하거나 이상 구간과 정상 구간의 애플리케이션을 나란히 놓는 일은 쿼리 명령어로 합니다. 이 순서(대상 → 감지 → 판정 → 범위 → 증거 → 원인)를 AI 에이전트에게 맡기면 질문 하나로 원인 분석 보고서를 받을 수 있습니다.
메뉴 구성
콘솔 메뉴는 좌측 메뉴의 제니퍼 APM 아래에 있습니다.
| 메뉴 | 화면 | 설명 | 매뉴얼 |
|---|---|---|---|
| 대시보드 | 시스템 관리자 | 도메인의 처리량, 응답시간, 액티브 서비스, X-View, 이벤트를 한 화면에서 실시간으로 봅니다 | 대시보드 |
| 대시보드 | 애플리케이션 인사이트 | 애플리케이션 맵, 액티브 애플리케이션, 문제·스택트레이스 히트맵, X-View로 애플리케이션 중심의 상태를 봅니다 | 대시보드 |
| 대시보드 | 메모리 | 힙·Non-힙 메모리, GC 시간과 GC Activity, CPU와 메모리 사용률을 인스턴스별로 봅니다 | 대시보드 |
| 대시보드 | 시스템 리소스 | 시스템과 프로세스의 CPU, 메모리 사용률과 사용량을 봅니다 | 대시보드 |
| 분석 | X-View | 지난 시간대의 트랜잭션을 X-View 차트로 검색하고 응답시간, 애플리케이션 같은 조건으로 거릅니다 | 분석 |
| 분석 | Stacktrace Flight Recorder (SFR) | 수집된 스택트레이스 샘플로 애플리케이션과 메서드가 어디서 시간을 쓰는지 봅니다 | 분석 |
| 통계 | 일일 시스템 성능 | 하루 동안의 도메인·인스턴스 성능과 Peak time, 이벤트, 에러를 표와 차트로 봅니다 | 통계 |
| 통계 | 월별 시스템 성능 | 한 달 동안의 도메인·인스턴스 성능과 Peak day를 봅니다 | 통계 |
| (창) | X-View 트랜잭션 | X-View 차트를 드래그하면 열리는 창입니다. 트랜잭션 목록과 상세를 봅니다 | X-View 트랜잭션 |
화면에는 사용 권한을 받은 JENNIFER 콘솔 프로파일만 나타납니다. 그런 프로파일이 둘 이상이면 화면을 처음 열 때 프로파일을 고릅니다. 고른 프로파일은 주소의 ?profile=에 남아 다른 화면으로 옮겨도 유지됩니다.
Caution
화면의 요청은 모두 접속 프로파일의 콘솔 계정으로 실행됩니다. GC 실행, 이벤트 복구 처리, 메서드 프로파일 설정, 토크 공유처럼 JENNIFER의 상태를 바꾸는 버튼은 계정에 권한이 있을 때 나타나고, 누르면 실제로 반영됩니다. 목록은 설치 매뉴얼의 콘솔 계정 준비에 있습니다.
매뉴얼 구성
| 페이지 | 내용 |
|---|---|
| 시작하기 | 대시보드에서 X-View를 드래그해 트랜잭션 상세까지 가는 한 번의 흐름 |
| 대시보드 | 시스템 관리자, 애플리케이션 인사이트, 메모리, 시스템 리소스 화면 |
| 분석 | X-View 분석과 Stacktrace Flight Recorder |
| X-View 트랜잭션 | 트랜잭션 목록, 필터, 애플리케이션 맵, 트랜잭션 상세 |
| 통계 | 일일·월별 시스템 성능 통계 |
| 쿼리 명령어 | 콘솔 데이터를 쿼리로 읽고 원인을 좁히는 법 |
| AI 에이전트 원인 분석 | 템플릿을 설치하고 질문 하나로 원인 분석을 받는 법 |
처음이라면 시작하기부터 보세요.