환영합니다
JENNIFER PYTHON 프로모션에 선정되신 것을 환영합니다. 아래 절차를 통해 https://9python.jennifersoft.com으로 PYTHON 애플리케이션 모니터링을 할 수 있습니다.
아래 절차를 통한 에이전트 설치가 어려우신 분은 promotion.kr@jennifersoft.com으로 문의 주시기 바랍니다. 원격 접속(http://113366.com/jennifer)을 통해 에이전트 설치를 지원합니다.
제니퍼는 크롬(Chrome) 브라우저에 최적화 되어 있습니다. IE나 Firefox 사용 시 일부 기능에 문제가 있을 수 있습니다.
JENNIFER 접속
크롬(Chrome) 브라우저를 사용해 https://9python.jennifersoft.com으로 접속합니다.
메일에 명시된 ID와 임시 비밀 번호로 접속합니다.
접속 후 대시 보드 좌측 하단에 위치한 사용자 메뉴 > 계정관리 > 내 계정 을 이용해 비밀번호를 변경합니다.
이후 에이전트 설치를 완료하면 대시 보드에서 PYTHON 애플리케이션 모니터링을 할 수 있습니다.
PYTHON 에이전트 설치
Python 에이전트와 제니퍼 서버는 TCP 포트 5000번으로 통신합니다. JENNIFER 서버 5000번 포트로 접속할 수 있도록 방화벽 설정이 되어 있는지 확인해 주세요.
메일에 첨부된 Domain ID로 여러 Python 애플리케이션을 모니터링 할 수 있습니다.
pip를 통해 jennifer-python을 설치합니다.
$ pip install jennifer-python
그다음 jennifer-python 에이전트가 설치될 응용 프로그램 하나마다 설정 파일(ini)을 생성합니다. 이를 위해 jennifer-admin 명령을 사용할 수 있습니다.
$ jennifer-admin generate-config
위의 명령을 실행하면 "jennifer.ini" 파일이 생성됩니다.
생성된 INI 파일을 편집기로 열어 각각의 값을 프로모션 메일에 지정된 값으로 변경합니다.
[JENNIFER] server_address=9python.jennifersoft.com server_port=5000 domain_id=...프로모션 메일에 포함된 domain_id 값... inst_id=...임의의 숫자값... (예: 10000)
domain_id가 잘못 지정되면 모니터링이 불가능합니다.
inst_id는 파이썬 응용 프로그램마다 고유하게 설정합니다. 만약 2개의 웹 애플리케이션을 모니터링하고 싶다면 jennifer.ini 파일을 다른 이름으로 복사해 inst_id 값만 바꾸면 됩니다.
이제 여러분의 파이썬 응용 프로그램이 시작될 환경 내에 위에서 만든 jennifer.ini 파일의 경로를 JENNIFER_CONFIG_FILE 환경 변수를 이용해 설정합니다. 예를 들어 jennifer.ini 파일이 /home/user/jennifer 경로에 있다면 다음과 같은 구성으로 설정합니다.
$ export JENNIFER_CONFIG_FILE=/home/user/jennifer/jennifer.ini
마찬가지로 2개 이상의 웹 애플리케이션을 모니터링한다면 각각의 환경마다 JENNIFER_CONFIG_FILE 옵션에 inst_id만 다르게 설정한 INI 파일의 경로를 설정합니다.
파이썬 웹 응용 프로그램의 실행을 jennifer-admin 명령을 경유해 실행합니다.
$ jennifer-admin run ...[python 실행 코드]...
예를 들어, 기존에 uwsgi를 이용해 실행한 경우 다음과 같은 식으로 실행합니다.
[기존 실행 명령] $ uwsgi -i uwsgi.ini [제니퍼가 반영된 실행 명령] $ jennifer-admin run uwsgi -i uwsgi.ini [또는, 환경변수가 함께 반영된 실행 명령] $ JENNIFER_CONFIG_FILE=/home/user/jennifer/jennifer.ini jennifer-admin run uwsgi -i uwsgi.ini
Python 에이전트가 제니퍼 서버와 TCP 연결을 맺은 후에는 다음 로그를 확인 할 수 있습니다.
2020-06-01/11:13:26 ... ---------------- [App Initialized] ---------------------- MachineName = CentOS release 5.9 (Final) Is64BitProcess = 1 Processor Architecture = x86_64 Python Version = Python 3 Jennifer Python Agent Install Path = ... Jennifer Python Agent Domain ID = 1000 Jennifer Python Agent Inst ID = ... Jennifer Python Agent Pid = 19403 --------------------------------------------------------- 2020-06-01/11:13:26 ...
https://9python.jennifersoft.com 대시보드의 좌측 상단에 Instance ID(아래 그림에서는 10000번)가 추가되었는지 확인합니다.
final
PYTHON 에이전트 제거
설치 제거는 2가지 관점에서 다룰 수 있습니다. 우선, 현재 파이썬 응용 프로그램에서 JENNIFER PYTHON을 제거하려면 단순히 응용 프로그램만 "jennifer-admin" 명령이 아닌 기존의 방법으로 재실행하면 됩니다.
만약 바이너리까지 모두 지우려면 pip 명령어를 이용해 제거합니다.
$ pip uninstall jennifer-python
JENNIFER 따라하기
아래 '실시간 데이터 조회하기', '과거 데이터 조회하기', '통계 보기'를 통해 JENNIFER의 컨셉과 간략한 사용법을 학습할 수 있습니다.
제니퍼를 처음 사용하시는 분들을 위해 원격 접속(http://113366.com/jennifer)을 통해 주요 사용 방법을 안내 합니다. promotion.kr@jennifersoft.com으로 연락 주시기 바랍니다.
매뉴얼을 통해 제니퍼의 기능 활용방법을 확인하실 수 있습니다. 매뉴얼은 모든 제니퍼 화면 우측 상단의 '?' 버튼으로 확인 가능합니다.
제니퍼기능사용하기
실시간 데이터 조회하기
JENNIFER 로그인 후 바로 보이는 화면은 '시스템 관리자' 대시보드 입니다. 이 화면에서 액티브 서비스, 응답시간, 프로세스 메모리 사용량, TPS를 살펴보세요.
액티브 서비스란 웹 서버 엔진이 처리 중인 Python 요청을 의미합니다. 액티브 서비스 숫자가 10이라면 현재 처리 중인 요청의 수가 10이라는 것을 의미합니다.
시스템 관리자 대시보드 우측의 X-View 차트를 확인하세요. X-View 차트는 트랜잭션(Python 요청)을 'X'로 표시합니다. x축은 요청이 완료된 시간이며, y축은 응답시간(elapsed time)입니다.
마우스 드래그를 동작을 사용해 X-View 차트의 특정 X점들(처리된 트랜잭션)을 선택하세요. 선택된 트랜잭션의 상세 정보를 X-View 트랜잭션 분석 팝업을 통해 확인하실 수 있습니다. X-View 트랜잭션 분석 팝업을 활용한 트랜잭션 분석으로 자세한 사용법을 학습할 수 있습니다.
실시간 모니터링으로 실시간 모니터링 데이터를 확인할 수 있습니다. 화면 좌측 메뉴목록의 대시보드 메뉴를 클릭하면 실시간 모니터링 화면 리스트를 볼 수 있습니다. 여기서 사용자를 클릭한 후 보이는 화면에서 방문자 수, TPS, 액티브 사용자 수치를 확인하세요.
과거 데이터 조회하기
분석 퍼스펙티브로 이동하면 JENNIFER에 저장된 과거 데이터를 조회할 수 있습니다.
분석 퍼스펙티브 리스트에서 애플리케이션 현황을 클릭하면 일일 호출 건수와 시간당 호출 건수를 볼 수 있습니다. 시간당 호출 건수 바 그래프에서 특정 시간대를 클릭하세요. 하단 테이블에서 해당 시간대에 어떤 애플리케이션 URL이 호출되었는지, 어떤 SQL이 실행되었는지 확인하세요. 테이블의 '응답시간' 컬럼을 클릭해 응답시간이 가장 느린 순으로 애플리케이션을 정렬해보세요.
분석 퍼스펙티브 리스트에서 성능 브라우저를 클릭하세요. 상단 입력 컴포넌트에서 Domain 이름과 날짜, Instance를 차례대로 선택합니다. Metrics 선택 화면에서 시스템 CPU 사용률(%)를 선택한 후 검색 버튼을 누르세요. 하단 그래프에서 선택한 날짜의 시스템 CPU 사용률 추이를 확인할 수 있습니다.
분석 퍼스펙티브 리스트에서 X-View를 클릭하세요. 이후 조회 기간을 선택한 후 검색 버튼을 누르세요. 해당 시간대에 처리된 트랜잭션을 X점으로 확인하실 수 있습니다. 또한 마우스 그래그로 X점들을 선택하면 상세 트랜잭션 데이터 정보를 확인하실 수 있습니다.
통계 보기
통계 화면을 통해 일별, 월별 통계 데이터를 확인할 수 있습니다. 통계 퍼스펙티브로 이동해 일일 방문자, 운영시간 호출 건수등 통계 데이터를 확인하세요.
문제 리포트 및 개선 사항 수렴
JENNIFER PYTPHON 기능에 문제가 있거나 개선할 점이 있으시면 언제든지 promotion.kr@jennifersoft.com 으로 연락 주시기 바랍니다.