환영합니다
JENNIFER PHP 프로모션에 선정되신 것을 환영합니다. 아래 절차를 통해 https://9php.jennifersoft.com으로 PHP 애플리케이션 모니터링을 할 수 있습니다.
아래 절차를 통한 에이전트 설치가 어려우신 분은 promotion.kr@jennifersoft.com으로 문의 주시기 바랍니다. 원격 접속(http://113366.com/jennifer)을 통해 에이전트 설치를 지원합니다.
제니퍼는 크롬(Chrome) 브라우저에 최적화 되어 있습니다. IE나 Firefox 사용 시 일부 기능에 문제가 있을 수 있습니다.
JENNIFER 접속
크롬(Chrome)브라우저를 사용해 https://9php.jennifersoft.com로 접속합니다.
메일에 명시된 ID와 임시 비밀 번호로 접속합니다.
접속 후 대시 보드 좌측 하단에 위치한 사용자 메뉴 > 계정관리 > 내 계정 을 이용해 비밀번호를 변경합니다.
이후 에이전트 설치를 완료하면 대시 보드에서 PHP 애플리케이션 모니터링을 할 수 있습니다.
PHP 에이전트 설치
1. PHP 에이전트와 제니퍼 서버는 TCP 포트 5000번으로 통신합니다. JENNIFER 서버 5000번 포트로 접속할 수 있도록 방화벽 설정이 되어 있는지 확인해 주세요.
2. Redhat 계열 리눅스(Redhat, CentOS, Fedora)의 SELinux가 사용 시 PHP 에이전트가 구동되지 않습니다.
메일에 첨부된 Domain ID로 여러 PHP 애플리케이션을 모니터링 할 수 있습니다.
PHP 에이전트를 설치할 디렉토리를 생성하고 해당 디렉토리로 이동합니다. (ex : ~/jennifer)
$ mkdir ~/jennifer $ cd ~/jennifer
wget 명령으로 PHP 에이전트 설치 zip 파일을 다운로드 받습니다.
$ wget https://cdn.jennifersoft.com/public/promotion/kr/agent.php.zip
압축을 해제 하고 agent.php 디렉토리로 이동합니다.
$ unzip agent.php.zip $ cd agent.php
sudo ./agent-installer
를 실행해 PHP Agent를 설치합니다. PHP 설치 정보가 .install-info 파일에 기록됩니다.
#sudo ./agent-installer Install Jennifer PHP Agent Inspect running PHP Application(mod-apache or fpm) Inspect file : "/usr/lib/apache2/modules/libphp7.so" Found PHP Thread Safety : NTS Found php.ini : /etc/php/php.ini Found PHP Version : 7.2.16 1. cmd: apache2, version: PHP 7.2.16, thread safety: NTS Found 1 PHP Application. Select PHP Application [1,n] :1 Find extension for php-7.2.16-NTS PHP extension path : /home/user/jennifer/agent.php/bin/jennifer5-php-7.2.x-NTS.so Update /etc/php/php.ini * [jennifer] * jenniferAgent.agent_file_root=/home/user/jennifer/agent.php * extension=/home/user/jennifer/agent.php/bin/jennifer5-php-7.2.x-NTS.so Install complete, edit /home/user/jennifer/agent.php/jennifer.conf and restart apache or fpm.
jennifer.conf 를 편집 프로그램으로 열어 선정 메일에 명시된 domain_id를 지정합니다. 만약 domain_id가 2000이라면 아래와 같이 지정합니다.
server_address=9php.jennifersoft.com server_port=5000 domain_id= 2000
domain_id가 잘못 지정되면 모니터링이 불가능합니다.
Apache 또는 PHP-FPM을 재시작 합니다.
$ sudo service apache2 restart (Apache) or $ sudo service php-fpm restart (PHP-FPM)
PHP 에이전트가 성공적으로 구동되었을때 에이전트 설치 디렉토리내의 log 디렉토리에 JENNIFER 로그 파일이 생성된 것을 확인할 수 있습니다. 로그 파일을 확인하면 아래와 같은 로그를 확인할 수 있습니다.
2020-06-01/11:13:21 INFO--Apache 19402: Jennifer Agent Version : 5.5.2 2020-06-01/11:13:22 INFO--Apache 19402: Jennifer Data Server address : x.x.x.x 2020-06-01/11:13:22 INFO--Apache 19402: Jennifer Data Server port : 5000 2020-06-01/11:13:22 INFO--Apache 19402: Jennifer Agent Domain ID : x 2020-06-01/11:13:22 INFO--Apache 19402: Jennifer Agent Instance ID : x
PHP 에이전트가 제니퍼 서버와 TCP 연결을 맺은 후에는 다음 로그를 확인 할 수 있습니다.
2020-06-01/11:13:26 INFO--Agent 19403: Send Session Data ---------------- [App Initialized] ---------------------- Apache 2.0 Handler Master Pid=19402 MachineName = CentOS release 5.9 (Final) Is64BitProcess = 1 Processor Architecture = x86_64 PHP Version = PHP 7.2.16NTS Jennifer PHP Agent Install Path = X Jennifer PHP Agent Domain ID = 1000 Jennifer PHP Agent Inst ID = x Jennifer PHP Agent Pid = 19403 --------------------------------------------------------- 2020-06-01/11:13:26 INFO--Agent 19403: Session Create Success
https://9php.jennifersoft.com 대시보드의 좌측 상단에 Instance ID(아래 그림에서는 10000번)가 추가되었는지 확인합니다.
PHP 에이전트 제거
php.ini 설정파일의 다음 라인을 삭제하거나 주석처리 한 후 아파치/PHP-FPM을 재시작합니다.
[jennifer] extension=/home/user_id/jennifer/agent.php/bin/jennifer5-php-5.x.x-NTS.so jenniferAgent.agent_file_root=/home/user/jennifer/agent.php
JENNIFER 따라하기
아래 '실시간 데이터 조회하기', '과거 데이터 조회하기', '통계 보기'를 통해 JENNIFER의 컨셉과 간략한 사용법을 학습할 수 있습니다.
제니퍼를 처음 사용하시는 분들을 위해 원격 접속(http://113366.com/jennifer)을 통해 주요 사용 방법을 안내 합니다. promotion.kr@jennifersoft.com으로 연락 주시기 바랍니다.
매뉴얼을 통해 제니퍼의 기능 활용방법을 확인하실 수 있습니다. 매뉴얼은 모든 제니퍼 화면 우측 상단의 '?' 버튼으로 확인 가능합니다.
실시간 데이터 조회하기
JENNIFER 로그인 후 바로 보이는 화면은 '시스템 관리자' 대시보드 입니다. 이 화면에서 액티브 서비스, 응답시간, 프로세스 메모리 사용량, TPS를 살펴보세요.
액티브 서비스란 PHP 엔진이 처리 중인 PHP 요청을 의미합니다. 액티브 서비스 숫자가 10이라면 현재 처리 중인 요청의 수가 10이라는 것을 의미합니다.
시스템 관리자 대시보드 우측의 X-View 차트를 확인하세요. X-View 차트는 트랜잭션(PHP 요청)을 '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 PHP 기능에 문제가 있거나 개선할 점이 있으시면 언제든지 promotion.kr@jennifersoft.com 으로 연락 주시기 바랍니다.