제니퍼 APM | 설치 매뉴얼 | 로그프레소 스토어

설치 매뉴얼

개요

제니퍼 APM 앱은 제니퍼 관리 API(Open API)를 주기적으로 호출해 종료된 트랜잭션의 성능 정보를 수집합니다. 응답시간·CPU 사용시간·SQL 수행시간 등 구간별 소요시간과 오류 유형을 수집하며, 실행 중인 서비스 목록은 확장 명령어로 실시간 조회할 수 있습니다.

적용 범위

Note

소나 4.0.2308.0 이상, 제니퍼 Open API를 제공하는 제니퍼 서버에서 동작합니다.

요구 사항

항목	요구사항	비고
제니퍼 계정/권한	제니퍼 Open API 호출 권한	권한 부족 시 수집 누락 가능
발급 필요 자격증명	제니퍼 Open API 토큰	제니퍼 관리 콘솔에서 발급
사전 확인 정보	수집 대상 도메인 ID, 인스턴스 ID(선택)	제니퍼 관리 콘솔에서 확인
네트워크 허용	HTTPS/443 (소나 수집 노드 → 제니퍼 서버, Outbound)	방화벽 정책 반영 필요

Note

제니퍼 API는 한 번에 1분 범위까지만 조회할 수 있습니다. 앱이 자동으로 60초 단위로 나누어 호출하므로, 수집기 옵션 중 "모니터링 대상 일수"를 크게 지정하면 API 호출 횟수가 그만큼 늘어납니다.

제니퍼 APM 설정

단계 1: Open API 토큰 발급

제니퍼 관리 콘솔에서 Open API 호출에 사용할 토큰을 발급합니다. 발급한 토큰 문자열은 안전한 곳에 보관하고, 소나 접속 프로파일 등록 시 입력합니다.

단계 2: 도메인 ID 확인

수집 대상 도메인의 ID를 확인합니다. 도메인 ID는 수집기 설정의 필수 항목입니다.

단계 3: 인스턴스 ID 확인 (선택)

특정 인스턴스만 수집하려면 해당 인스턴스의 ID를 확인합니다. 인스턴스 ID를 지정하지 않으면 도메인에 속한 모든 인스턴스를 수집합니다.

로그프레소 수집 설정

단계 1: 접속 프로파일 추가

시스템 > 접속 프로파일에서 추가를 클릭하고 아래 값을 입력합니다.

구분	항목	설정
필수	이름	접속 프로파일을 식별할 고유한 이름
필수	식별자	로그프레소 쿼리 등에서 사용할 접속 프로파일의 고유 식별자. 예: `jennifer_apm`
필수	유형	`JENNIFER APM` 선택
필수	Token	제니퍼 APM 설정 단계 1에서 발급한 Open API 토큰
필수	엔드포인트	제니퍼 서버 URL. 예: `https://example.com:7900`
선택	HTTP 프록시	`IP:포트`
선택	접속 타임아웃	밀리초 단위. 기본값 30000 권장

단계 2: 수집기 추가

수집 > 수집기에서 추가를 클릭하고 아래 값을 입력합니다.

구분	항목	설정
필수	이름	수집기를 식별할 고유한 이름
필수	주기	60초 권장
필수	적재 위치/수집 위치	로그프레소 플랫폼 구성에 따라 적합한 노드 선택
필수	수집 모델	`제니퍼 APM 트랜잭션` 선택
필수	테이블	수집 데이터를 적재할 테이블 이름. 도메인별로 분리하려면 도메인 ID를 접미사로 사용 (예: `APM_JENNIFER`)
필수	접속 프로파일	단계 1의 프로파일 식별자
필수	도메인 ID	제니퍼 APM 설정 단계 2에서 확인한 도메인 ID
선택	인스턴스 ID	콤마로 구분해 여러 개 지정 가능. 예: `10000,10001`. 미지정 시 전체 인스턴스
선택	모니터링 대상 일수	0~90일. 최초 수집 시 소급할 일수. `0`이면 현재 시각부터 수집 (기본값)
선택	수집 지연 시간	초 단위. 현재 시각에서 지연시켜 조회 (기본값 0)

Tip

제니퍼 서버에 트랜잭션이 적재되기까지 지연이 있는 환경에서는 수집 지연 시간을 30~60초로 설정하면 누락을 줄일 수 있습니다.

Caution

"모니터링 대상 일수"는 최초 수집 시 조회할 일수이며, 제니퍼 API가 1분 범위만 조회할 수 있어 앱이 60초 단위로 나누어 호출합니다. 따라서 최초 호출 횟수는 "지정한 일수 x 24시간 x 60분"이 됩니다. 7일은 약 1만 회, 30일은 약 4만 3천 회, 최대값인 90일은 약 13만 회입니다. 이 호출이 첫 수집 주기에 순차로 발생하므로 완료까지 수 시간이 걸릴 수 있습니다. 제니퍼 서버 부하와 최초 수집 소요 시간을 고려해 필요한 범위만 지정하세요.