Python Agent Guide

Transcription

1 Python Agent Guide WhaTap Support Version 1.0.0

2 Table of Contents Python Agent Guide Install 에이전트실행및모니터링개요 표준설치 에이전트네이밍 애플리케이션서버별적용절차 에이전트로그 설치에러대응 Advanced Feature 설치환경 Data 트랜잭션성능추적 통계 ( 리스트데이터 ) 성능카운터 Python 애플리케이션모니터링설정 성능카운터 & 통계확장

3 Preface Python Agent Guide 제목 : Python Agent Guide 작성자 : WhaTap Support 이메일 : support@whatap.io 날짜 : 버전 : 설명 : 본문서는 WhaTap Python Monitoring 에이전트에대해설명합니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 1

4 1.1. 에이전트실행및모니터링개요 Chapter 1. Install 에이전트설치부터실행, 업데이트및종료에대해설명하며, 나아가설치중발생할수있는오류에대한사례들을설명합니다 에이전트실행및모니터링개요 와탭 Python 애플리케이션모니터링은 Python 기반웹애플리케이션서버모니터링서비스를제공합니다 에이전트구성 에이전트의구성은수집서버, 에이전트, 그리고수집서버로이루어집니다. 수집서버 에이전트가수집한애플리케이션의성능데이터를수집, 저장및통계정보추출하고이를사용자에효율적인방법으로제공합니다. 수집서버는지역 (Region) 별로설정이가능합니다. 지역 (Region) 별로수집서버의주소가다르게할당되므로사용자가선택한지역 (Region) 에따라수집서버주소는다를수있습니다. 지역 (Region) 선택은프로젝트생성시에함께설정합니다. 에이전트 애플리케이션서버에설치되어, 애플리케이션성능데이터를수집하여서버로전송합니다. 트레이서 애플리케이션코드에서프로파일링데이터를추적합니다. 네트워크 와탭모니터링에이전트는모니터링정보를수집하여서버에데이터전송하기위하여외부통신 (TCP) 을위한 6600 포트와내부통신 (UDP) 을위한 6600 포트를사용합니다. 내부포트가충돌이나는경우, net_udp_port 옵션을통해포트변경이가능합니다 에이전트구성파일 Table 1. 에이전트구성파일의종류 파일명 whatap.conf paramkey.txt 설명 에이전트설정파일 보안키를필요로하는옵션에서참조하는파일 Copyright c 2019 WhaTap Labs Inc. All rights reserved. 2

5 1.2. 표준설치 설정파일 파일명 : whatap.conf 에이전트설정기본필수파일입니다. 에이전트와관련된옵션은모두 whatap.conf 에서설정이가능합니다. 보안키파일 파일명 : paramkey.txt 추적한트랜잭션의프로파일정보로수집한 HTTP와 SQL데이터의파라미터정보를확인하는데사용합니다. 보안키를파일에저장하고실제수집된데이터를브라우저에서확인하고자할때파일에저장해둔보안키를입력해야조회할수있습니다. 파일의내용을직접변경하여보안키수정이가능합니다. 관련옵션 : profile_http_parameter_enabled (default: false) profile_sql_param_enabled (default: false) 1.2. 표준설치 와탭 APM 모니터링서비스를사용하기위해서는모니터링대상애플리케이션서버에와탭 APM 모니터링에이전트를설치해야합니다. 와탭 APM 모니터링에이전트설치방법은 whatap.io 사이트에서압축된에이전트파일을다운로드받아서버임의의위치에압축을풀어실행하는 것만으로설치가완료됩니다 설치절차 프로젝트생성 Figure 1. 프로젝트생성페이지 서버를등록하기위해우선프로젝트를생성합니다. 추가버튼을선택하면아래와같이프로젝트생성창이나타납니다. 설치하려는 Python 아이콘을선택한뒤, 희망하는프로젝트명과데이터서버지역 (Region), 소속하게될그룹을선택한뒤프로젝트를생성합니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 3

6 1.2. 표준설치 Figure 2. 프로젝트이름지정및수집서버지역선택 라이센스발급 프로젝트관리화면에서는우선적으로라이선스를발급받습니다. 라이센스키는프로젝트별로귀속되기때문에, 유출되거나배포되어서는 안됩니다. 반드시본인프로젝트에서버를등록할때에만이용하시기바랍니다. WHATAP_HOME 기본경로설정 로그와설정파일경로를위한 $WHATAP_HOME 경로를지정해주세요. whatap 디렉토리를새로생성하는것을권장합니다. $ export WHATAP_HOME=[PATH] 라이센스키및수집서버설정 다음명령어를실행하면 $WHATAP_HOME 에지정한경로에바로 whatap.conf 파일이생성및설정됩니다. $ whatap-setting-config --host [HOST_ADDR] --license [LICENSE_KEY] --app_name [APPLICATION_NAME] --app_process_name [APP_PROCESS_NAME ex]uwsgi, gunicorn..] Copyright c 2019 WhaTap Labs Inc. All rights reserved. 4

7 1.2. 표준설치 설정확인 다음과같이설정파일이잘생성되어있는지확인해주세요. $ cat $WHATAP_HOME/whatap.conf 명령어실행 WHATAP_AGENT 시작커맨드와함께애플리케이션서버를재시작해주세요. $ whatap-start-agent [YOUR_APPLICATION_START_COMMAND] 애플리케이션재시작 애플리케이션서버가실행되면애플리케이션의모니터링정보를수집하기시작합니다. 에이전트프로세스확인 다음과같은명령어를통하여동작중인와탭 Python 에이전트프로세스를확인할수있습니다. $ ps ef grep whatap_python 로그확인서비스재시작시정상적으로로그가뜨는화면을통해정상구동여부를확인합니다. whatap-python 패키지를설치한후에이전트사용안내에따라애플리케이션서버를재시작하면다음과같은로그를확인할수있습니다. 에이전트등록후수집과관련된로그는 $WHATAP_HOME/logs 디렉토리에서확인할수있습니다. (whatap-hook.log / whatap-boot-[date].log) Python-AGENT / / / / / / / / / _ \/ _ `// / / _ `/ _ \ / /_//_/\_,_//_/ \_,_/. / /_/ Just Tap, Always Monitoring WhaTap Python Agent version , WHATAP_HOME: /Users/kimjihye/workspace/whatap/python-sample/whatap Config: /Users/kimjihye/workspace/whatap/python-sample/whatap/whatap.conf Logs: /Users/kimjihye/workspace/whatap/python-sample/whatap/logs 모니터링확인 서버에서정상적으로로그가올라온것을확인한뒤, 콘솔에정상적으로등록되어있는여부를확인하기위해해당프로젝트의 서버 메뉴에올라온 해당애플리케이션서버의명칭을확인합니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 5

8 1.2. 표준설치 애플리케이션명은 {type}-{ip2}-{ip3}-{process} 의형태의식별 ID 가부여됩니다. 애플리케이션재시작 애플리케이션서버가실행되면애플리케이션의모니터링정보를수집하기시작합니다. 에이전트프로세스확인 다음과같은명령어를통하여동작중인와탭 Python 에이전트프로세스를확인할수있습니다. $ ps ef grep whatap_python 에이전트삭제 에이전트삭제를원하는경우, 다음절차를진행해주세요.. 1. 애플리케이션서버재시작시함께추가한 WHATAP_AGENT 시작커맨드를삭제합니다. 2. whatap-stop-agent 명령어로와탭 Python 에이전트프로세스를종료합니다. $ whatap-stop-agent 3. 프로세스가죽지않는경우다음명령어를통해프로세스를종료시켜주세요. $ killall whatap-python 4. 프로세스가정삭적으로죽었는지에대한확인은다음명령어로확인가능합니다. $ ps -ef grep whatap_python 패키지설치확인 / 업데이트 / 제거 Copyright c 2019 WhaTap Labs Inc. All rights reserved. 6

9 1.3. 에이전트네이밍 패키지설치확인 다음과같은명령어를통하여설치된와탭 Python 에이전트패키지를확인할수있습니다. $ pip list grep whatap-python 패키지업데이트 다음과같은명령어를통하여설치된와탭 Python 에이전트패키지를업데이트할수있습니다. $ pip install U whatap-python 또는 $ pip install U whatap-python==[ 특정버전 ] 패키지제거 다음과같은명령어를통하여설치된와탭 Python 에이전트패키지를제거할수있습니다. $ pip uninstall whatap-python 1.3. 에이전트네이밍 와탭모니터링서비스에서모니터링대상을포괄적인의미로오브젝트라는명칭을사용하며에이전트와혼용해서사용하기도합니다. 모니터링 대상즉오브젝트를구분하기위해서는이름을구분해야합니다. 와탭은오브젝트이름과오브젝트아이디를통해서대상을구분합니다. 오브젝트 ( 에이전트 ) 이름은프로젝트단위로유일해야합니다. 오브젝트아이디 = CRC32( 오브젝트이름 ) 입니다. 오브젝트아이디 / 이름이바뀌면이전데이터와연결되지않습니다 이름결정방식 애플리케이션서버로부터추출한정보를활용하는이유는애플리케이션서버정지, 네트워크단절또는에이전트문제로인한수집서버와에이전트의통신단절상태가복구되었을경우, 재접속된에이전트로부터송신되는정보가기존에이전트로부터송신된정보와의연속성을유지하기위해서입니다. 에이전트이름식별와탭은모니터링정보수집대상인애플리케이션서버식별을위한정보로기본적으로애플리케이션서버로부터수집한정보를활용합니다. 기본적으로활용하는정보는애플리케이션서버종류, 애플리케이션서버의 IP, 서비스포트를조합하여애플리케이션서버를고유식별자로사용하게되며필요에따라사용자가지정한명칭을사용하거나패턴을변경하여사용하는것도가능합니다. 이때에는꼭고유한값이어야만합니다. 애플리케이션서버로부터추출한정보를활용하는이유는애플리케이션서버정지, 네트워크단절또는에이전트문제로인한수집서버와에이전트의통신단절상태가복구되었을경우, 재접속된에이전트로부터송신되는정보가기존에이전트로부터송신된정보와의연속성을유지하기위해서입니다. 와탭이애플리케이션서버를식별하기위해사용하는기본패턴은다음과같습니다. default: {type}-{ip2}-{ip3}-{process} Copyright c 2019 WhaTap Labs Inc. All rights reserved. 7

10 1.4. 애플리케이션서버별적용절차 기본패턴에대한변경은 whatap.conf 에서설정에서가능합니다. object_name default: {type}-{ip2}-{ip3}-{process} Table 2. 패턴옵션 설정 type 설명 app_name ip# Ip 를. 으로나누었을때 # 번째자리 (0 부터 ) process hostname app_process_name 호스트명 1.4. 애플리케이션서버별적용절차 사용예 기본 예제 $ whatap-start-agent python manage.py runserver uwsgi 예제 1 $ whatap-start-agent uwsgi --ini myapp.ini 예제 2 description "uwsgi application server handling myapp" start on runlevel [2345] stop on runlevel [!2345] exec whatap-start-agent [YOUR_APPLICATION_START_COMMAND] 또는 exec env WHATAP_HOME=[PATH] [ 절대경로 ]/whatap-start-agent [YOUR_APPLICATION_START_COMMAND] 예제 3 $ whatap-start-agent gunicorn myapp.wsgi Gunicorn Copyright c 2019 WhaTap Labs Inc. All rights reserved. 8

11 1.4. 애플리케이션서버별적용절차 예제 1 NAME="uwsgi" PATH=/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin DAEMON=/usr/local/bin/uwsgi ########## WHATAP_AGENT_CONF ########## WHATAP_HOME=[PATH] WHATAP_AGENT=[ 절대경로 ]/whatap-start-agent... do_start(){ env WHATAP_HOME=$WHATAP_HOME $WHATAP_AGENT [YOUR_APPLICATION_START_COMMAND] } 예제 2 description "Gunicorn application server handling myapp" start on runlevel [2345] stop on runlevel [!2345] exec whatap-start-agent [YOUR_APPLICATION_START_COMMAND] 또는 exec env WHATAP_HOME=[PATH] [ 절대경로 ]/whatap-start-agent [YOUR_APPLICATION_START_COMMAND] 예제 3 NAME="gunicorn" PATH=/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin DAEMON=/usr/local/bin/gunicorn ########## WHATAP_AGENT_CONF ########## WHATAP_HOME=[PATH] WHATAP_AGENT=[ 절대경로 ]/whatap-start-agent... do_start(){ env WHATAP_HOME=$WHATAP_HOME $WHATAP_AGENT [YOUR_APPLICATION_START_COMMAND] } Supervisor 예제 [program:app-uwsgi] environment = WHATAP_HOME=[PATH] command = [ 절대경로 ]/whatap-start-agent /usr/local/bin/uwsgi --ini /home/blog/backend/config/uwsgi.ini [program:nginx-app] command = /usr/sbin/nginx WSGI 애플리케이션직접구현 Copyright c 2019 WhaTap Labs Inc. All rights reserved. 9

12 1.5. 에이전트로그 예제 import def simple_app(environ, start_response): """Simplest possible application object""" status = '200 OK' response_headers = [('Content-type', 'text/plain')] start_response(status, response_headers) return ['Hello world!\n'] 1.5. 에이전트로그 애플리케이션서버가실행되면애플리케이션의모니터링정보를수집하기시작합니다. 로그의위치는 $WHATAP_HOME 의 logs 디렉토리에다음과 같은파일로생성됩니다 로그파일종류 로그파일은 2 가지로종류는다음과같습니다. whatap-boot-[date].log : 데이터수집로그 whatap-hook.log : 데이터수집로그 정상동작확인 다음은정상동작하는경우의로그예입니다. Python-AGENT / / / / / / / / / _ \/ _ `// / / _ `/ _ \ / /_//_/\_,_//_/ \_,_/. / /_/ Just Tap, Always Monitoring WhaTap Python Agent version , WHATAP_HOME: /Users/kimjihye/workspace/whatap/python-sample/whatap Config: /Users/kimjihye/workspace/whatap/python-sample/whatap/whatap.conf Logs: /Users/kimjihye/workspace/whatap/python-sample/whatap/logs 1.6. 설치에러대응 방화벽설정확인 와탭서버에대한 TCP 아웃바운드방화벽이설정되어있으면모니터링정보를서버로전송할수없으므로방화벽차단을해제해야합니다. 방화벽확인방법 (telnet 서버 IP 서버포트 ) telnet 명령수행시하기와같은접속관련정보가표시되어야정상입니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 10

13 1.6. 설치에러대응 $ telnet Trying Connected to Escape character is '^]'. 수집서버정보는에이전트설치메뉴에서확인할수있습니다 Permission denied 에러발생시 와탭파이썬모니터링을사용하기위해서는다음과같은권한필요합니다. 와탭설정을위한 $WHATPA_HOME/whatap.conf 파일의읽기및쓰기권한 와탭로그를위한 $WHATPA_HOME/logs 디렉토리와하위파일의읽기및쓰기권한 권한문제가발생하는경우 (Permission denied error), 다음과같이 $WHATPA_HOME 에권한을부여합니다. $ echo `sudo chmod -R 777 $WHATAP_HOME` 프로젝트에에이전트가등록되지않는경우모니터링데이터수집이이루어지지않는 경우 로그파일 ($WHATAP_HOME/logs/) 을확인한후각각의문제에대하여다음과같이문제를해결할수있습니다. whatap-hook.log CONF FILE ERROR: 설정파일생성권한이없습니다. 파일을만들어주세요. CONF READ ERROR: 설정파일은있으나리드권한이없습니다. 권한을주어야합니다. LOG FILE ERROR: 로그디렉토리생성권한이없이없습니다. 디렉토리를만들어주세요. LOGGING ERROR: 로그디렉토리는있으나, 쓰기권한없습니다. 권한을주어야합니다. whatap-boot-[date].log license or whatp.server.host error: 라이선스키또는수집서버주소가잘못되었습니다 포트충돌이발생하는경우 내부통신을하는에이전트는기본으로 UDP 6600 포트를사용합니다. 내부포트가충돌이나는경우, net_udp_port=xxx 옵션으로포트를변경할 수있습니다 $WHATAP_HOME 환경변수가설정되지않는경우 Apache HTTPD 아파치로웹서버구동하는경우환경변수설정을다음과같이해주어야합니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 11

14 1.7. Advanced Feature <VirtualHost *:80> #ServerName #DocumentRoot SetEnv WHATAP_HOME "application path" # Directory </VirtualHost> 수동으로환경변수설정하는경우 필요에따라서는, 다음과같이수동으로환경변수를설정해주어야합니다. --- import os os.environ.setdefault("whatap_home", [application path]") import whatap FAQ 제약사항 1.7. Advanced Feature 서버명을임의로부여하여관리하고싶은경우 에이전트는애플리케이션서버종류와애플리케이션서버의 IP, 서비스포트를사용하여자동으로서버명을부여합니다. 애플리케이션명지정옵션 기본패턴에대한변경은 whatap.conf 에서설정에서가능합니다. object_name default: {type}-{ip2}-{ip3}-{process} 애플리케이션명패턴 프로젝트에등록된애플리케이션서버별로동일한이름이사용되면안되므로서버명을고정으로사용해서는안됩니다. Internal ip address 로인해 서버 ip 가중복되는경우는애플리케이션서버명을그룹단위로패턴화하여적용할수있습니다. Table 3. 패턴옵션 설정 type 설명 app_name ip# Ip 를. 으로나누었을때 # 번째자리 (0 부터 ) process hostname app_process_name 호스트명 Copyright c 2019 WhaTap Labs Inc. All rights reserved. 12

15 1.8. 설치환경 AES 256 암호화적용 와탭 APM 에이전트는수집된데이터를암호화하여서버로전송합니다. 데이터의중요도나설정에따라이를변경할수있습니다. 기본적으로 XOR 연산과 AES 알고리즘을통한암호화를사용하며평문을 128비트단위로나누어암호화, 복호화를수행하며, 사용자의설정에따라 256비트까지확장할수있습니다. 설정 와탭 APM 에이전트가설치된디렉토리에서 whatap.conf 파일에아래와같은설정을추가합니다. cypher_level=256 설정을추가합니다. license=[ 라이센스키 ] whatap.server.host= / cypher_level=256 재실행 설정을추가한후 WAS 를재기동합니다 제약사항 복수리전을단일프로젝트로선택불가 whatap.io 사이트에서프로젝트생성시, 지역 (Region) 은중복선택이불가하며복수의지역 (Region) 을활용하는경우별도의프로젝트를 생성해야합니다. Cloud 환경과같이복수의지역 (Region) 에서버가존재하는경우, 네트워크 latency 등성능정보수집상의제약사항을회피하기위하여 지역 (Region) 단위로수집서버를위치시켜야합니다. 와탭은고객요구사항에부응하기위하여지역 (Region) 별로수집서버를구축합니다. 에이전트이름 (ONAME) 중복사용불가 와탭 APM 모니터링은에이전트의식별을위한용도로에이전트의 IP 주소와 Port 정보를활용하기때문에사용자환경의모니터링대상 애플리케이션서버가동일 IP, 동일 Port 를사용하는경우와탭서버에서해당서버인스턴스를구분할수없게됩니다. 서버인스턴스가동적으로확장되는환경이아니라면 서버명을임의로부여하여관리하고싶은경우 를참조하여애플리케이션식별을위한명칭을직접지정하는방식을통해우회할수있습니다. 와탭에서는현재모니터링대상애플리케이션이 internal address 또는네트워크가상화로인해중복된 IP를사용할경우, 서버명을임의로부여하여관리하고싶은경우 를참고하여별도의애플리케이션명패턴을활용합니다 설치환경 운영체제 다음운영체제환경에서에이전트를실행할수있습니다. CentOs 6 이상 (64bit) Ubuntu 14 이상 (64bit) Copyright c 2019 WhaTap Labs Inc. All rights reserved. 13

16 1.8. 설치환경 지원버전 Python2.7 이상 & Python3.3 이상 WSGIApplication Copyright c 2019 WhaTap Labs Inc. All rights reserved. 14

17 2.1. 트랜잭션성능추적 Chapter 2. Data 와탭의 Python 에이전트는트랜잭션성능, 주요성능통계그리고서비스와자원에대한카운터를수집합니다 트랜잭션성능추적 트랜잭션시작과종료 트랜잭션이란사용자브라우저의요청을처리하기위한서버사이드의 LUW(Logical Unit of Work) 를말합니다. 개별웹서비스 (URL) 요청에대한처리과정이바로트랜잭션인것입니다. 웹어플리케이션에서트랜잭션은웹서비스 (URL) 에대한 HTTP Request를받아 Response를반환하는과정입니다. 애플리케이션의성능은이트랜잭션들의성능으로요약할수있습니다. 트랜잭션성능은트랜잭션시작에서부터종료시점, 그리고응답시간및자원사용량혹은트랜잭션호출자의속성등의정보들을포함합니다. 기본적으로트랜잭션응답분포와트랜잭션통계를통해서트랜잭션성능을분석할수있습니다. 트랜잭션의이름 트랜잭션의이름은 URL 입니다. 단 Get 파라미터 (Query String) 는제외됩니다. 브라우저요청 트랜잭션이름 /hr/apply.do 와탭에서는 " 웹서비스이름 " 과 " 트랜잭션이름 " 을혼용해서사용합니다. 서비스특정 URL과그에대한요청을처리하기위한 모듈로볼수있고트랜잭션그요청에대한처리하나를의미하기때문에둘의이름은동일하게 URL 이라고할수있습니다. 트랜잭션이름정규화 MSA 기반의시스템이발전하면서 URL? 파라미터형식보다는 URL 패스에파라미터를넣는방식을많이사용하게된다. 이렇게패스파라미터를그대로트랜잭션이름으로사용하게되면통계적관점의성능분석이어렵게됩니다. 따라서정규화할필요가있습니다. 와탭은이때정규화를위한옵션과기능을제공하고있습니다. whatap.conf trace_normalize_urls=/hr/{name}/apply.do 위와같이설정하면트랜잭션이름이 /hello/kim /hello/:name 이렇게치환되어수집됩니다. 만약대상 url 설정은그대로두고기능만 off 하고자 한다면다음과같이옵션을지정할수있습니다. 기본값은 true 입니다. whatap.conf trace_normalize_enabled=false Copyright c 2019 WhaTap Labs Inc. All rights reserved. 15

18 2.1. 트랜잭션성능추적 트랜잭션프로파일 트랜잭션성능이트랜잭션시작과종료사이의요약지표들이나속성들을의미한다면트랜잭션프로파일은트랜잭션이수행되는과정중이스텝들을 추적하는것입니다. 트랜잭션이느리거나오류가있다면그원인을추적하기위해서수행이력을스텝별로추적할필요가있는데이것을트랜잭션프로파일링이라고 합니다. 와탭이수집하는스텝의종류에는크게 SQL 스텝, HTTP CALL 스탭, 메세지스텝, SOCKET 오픈스텝, DB 연결스텝, 메소드스텝등이있습니다. DB 연결스텝 수집방식 : START-END RDB 에대한연결에대한성능을포함합니다. 스텝정보에는이름, 응답시간, 에러를포함합니다. SQL 스텝 수집방식 : START-END JDBC SQL 에대한성능을포함합니다. 스탭정보에는연결정보,SQL 문, 에러가포함되어있습니다. HTTP Call 스텝 수집방식 : START-END 외부 http 서비스호출에대한성능을포함합니다. 스텝정보에는 url, host, port, 응답시간, 에러가포함됩니다. Message 스텝수집방식 : ADD 메세지스텝을프로파일을수집하는과정에서비정형적인모든구간에대한이력을수집할때사용됩니다. file오픈등등혹은사용자도임의의위치를지정하는데사용할수있습니다. SOCKET 스탭 수집방식 : ADD Socket 오픈을표현하는스텝입니다. METHOD 스탭 수집방식 : START-END 메소드응답시간을추적합니다. ACTIVE STATCK 스탭 수집방식 : ADD 액티브스탭에대한정보를포함합니다. 별도쓰레드가생성하여프로파일에추가하는방식으로수집합니다 트랜잭션스탭수집방식 자바에이전트는선형수집방식과환형수집방식을제공합니다. 선형수집 개별트랜잭션프로파일은무한정스텝을수집할수없습니다. 트랜잭션별로길이가제한된버퍼에프로파일스텝을저장합니다. 각트랜잭션은 최대로수집할수있는스텝의수가옵션으로지정되어있습니다. profile_step_max_count default: 1024 최대로수집가능한스텝수 Copyright c 2019 WhaTap Labs Inc. All rights reserved. 16

19 2.1. 트랜잭션성능추적 profile_step_normal_count default: 800 일반적으로아무런제약없이수집되는스텝수 profile_step_heavy_count default : 1000 normal count 를초과한경우에스텝은응답시간이느린스텝과액티브스택스텝만수집합니다. profile_step_heavy_time default:100 heavy count 이내에서의수집되는스텝의기준시간은 profile_step_heavy_time 입니다. Figure 3. Profile Step Buffer 수집되는프로파일의스텝수가 heavy count 를초과하는경우에는액티브스택만이수집됩니. 단이경우에도최대스텝수는 profile_step_max_count 를넘을수없습니다. 환형수집 선형수집은프로파일에서앞부분을수집하고버퍼사이즈를넘으면나중내용을버리지만반대로환형수집은앞부분의스텝을버리는방식입니다. circular_profile_enabled=true Figure 4. Profile Step Circular Buffer 버퍼사이즈는 profile_step_max_count 에설정합니다. profile_step_max_count=1024 Copyright c 2019 WhaTap Labs Inc. All rights reserved. 17

20 2.1. 트랜잭션성능추적 NON HTTP 트랜잭션추적을위한 END-POINT 설정방법 트랜잭션 end-point 트랜잭션 end-point 는트랜잭션의시작메소드입니다 HTTP 트랜잭션의경우에는 HttpServlet.service() 혹은 Filter.doFilter() 가트랜잰션의 시작점이고이곳을트랜잭션엔드포인트라고부릅니다. NON HTTP 추적 트랜잭션 end-point 로지정된메소드가시작해서종료될때까지의성능을트랜잭션성능이라고합니다. non http 트랜잭션을추적하기위해서는 end point 를지정해야합니다. 여기서는알수없는 end-point 를찾는과정은다음과같습니다. 1. 트랜잭션이호출될것으로추정되는모든메소드에대해프로파일추적을설정합니다. 2. 재기동후트랜잭션을일으켜서모니터링합니다. 3. back stack 옵션을켜서진입메소드를정확히파악합니다. STEP1, 먼저메소드프로파일설정 일단메소드프로파일을설정합니다. 하지만해당클래스들이잠재적인트랜잭션 end point 보다는확실하게트랜잭션에서호출되는클래스를 지정합니다. 그래서 DB 를사용한는프로그램에서는 JDBC 드라이버가일반적으로유용합니다. jdbc드라이버에프로파일을설정합니다.(whatap.conf) hook_method_patterns=jdbc.*.* hook_method_access_public_enabled=true hook_method_access_protected_enabled=true hook_method_access_none_enabled=true 어느메소드이건호출되면트랜잭션을시작시킨다옵션과트랜잭션시작시스택을덤프하는옵션을켭니다.(whatap.conf) trace_auto_transaction_enabled=true trace_auto_transaction_backstack_enabled=true STEP2, 재기동후프로파일분석 재기동하고서비스를호출하면트랜잭션이추적되는것을볼수있습니다. 트랜잭션들을조회해보면모든 jdbc.* 로시작하는클래스의메소드를이 트랜잭션으로나타남을알수있습니다. 트랜잭션프로파일을조회하면 <TRANSACTION BACKSTACK> 라는메세지스탭을확인할수있습니다. TRANSACTION BACKSTACK jdbc.fakepreparedstatement.executequery(fakepreparedstatement.java), com.virtual.dao.selectdao.execute2(selectdao.java:29), com.virtual.web.simulanonhttp.execute(simulanonhttp.java:147), com.virtual.web.simulanonhttp.process(simulanonhttp.java:76), com.virtual.web.simulanonhttp.run(simulanonhttp.java:100) 스택내용을보면어떤메소드로부터출발하고있는지얼추추정할수있다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 18

21 2.1. 트랜잭션성능추적 예제 com.virtual.web.simulanonhttp.execute(simulanonhttp.java:147), com.virtual.web.simulanonhttp.process(simulanonhttp.java:76), com.virtual.web.simulanonhttp.run(simulanonhttp.java:100) 위 3 개의메소드중에하나를트랜잭션시작점으로판단하면된다. 이정도상황에서는역컴파일을수행해서적절한트랜잭션 end point 를 결정해야한다. 로직을간단히보면 SimulaNonHttp.run 내에서 while() 가돌면서 SimulaNonHttp.process() 을호출하고 SimulaNonHttp.execute() 가수행된다. process() 가적당하다는것을알수있다. ( 이부분은어쩔수없이소스를보고판단해야 한다.) end point의가장중요한기준은종료되어야한다는것이다. 정상적인상황에서지연되지않고곧바로종료되어야성능적인 판단을할수있다. STEP3, 트랜잭션 END POINT 지정하기 트랜재션시작지점을아래와같이설정한다. hook_service_patterns=com.virtual.web.simulanonhttp.process 그리고재기동하면 process() 메소드가새로운트랜잭션의 end point 가된다. STEP4, 트랜잭션이름추적하기 보통의경우에는메소드명칭으로충분히트랜잭션을구분할수있습니다. whatap.conf service_name_mode=[full,class,method,string,arg] service_name_index=0 service_name_mode full,class,method,string,arg 5 가지옵션을지정할수있습니다. full : Full Class이름사용 class : Class 이름서비스명으로사용 method : Method이름을서비스명으로사용 string : 문자열중에서첫번째파라미터를서비스명으로사용 arg : 파라미터중에서 service_name_index옵션에지정한인덱스이파라미터를서비스명으로 플러그인 사용은전문가영역이기때문에충분히이해한경우에만사용하길권장합니다. STEP5, 에이전트플러그인사용하기 WHATAP_HOME 디렉토리아래에 plugin 디렉토리를만듭니다. 그리고 vi 를통해 AppServiceStart.x 파일을만듭니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 19

22 2.1. 트랜잭션성능추적 그리고는 println( test ); 라고타이핑하고저장하면화면에 test 라는문자열이출력되는것을확인할수있습니다. 그러면파라미터에서정보를 추출해봅니다. 본예제에는파라미터에 HashMap 에전달되고거기에는 url 파라미터가전달되고있습니다. Object url =((java.util.hashmap)$point.getargs()[0]).get("url"); $ctx.service((string)url); //println( url= +url); 이렇게플러그인을만들면트랜잭션이름이변경됩니다 Active Stack 수집 진행중인트랜잭션을액티브트랜잭션이라고합니다. 액티브트랜잭션에서정기적으로덤프한스택을액티브스택이라합니다. 와탭 에이전트는매 10 초 ( 옵션가능 ) 마다액티브트랜잭션에대해서액티브스택을덤프하고이것을서버에전송합니다. (active_stack_second=10) 컴팩트한액티브스택수집 액티브스택은스레드덤프를정기적으로수행하기때문에잘못구현되면에이전트에오버헤드가커질수있습니다. 따라서와탭은에이전트부하를 최소화하면서액티브스택을수집하기위해다양한옵션들을가지고있습니다. 서버 > 더보기 > 쓰레드목록 / 덤프메뉴에서스레드목록중에 "WhaTap-ActiveStackDump" 쓰레드의 CPU Time을확인하면 오버헤드를판단할수있습니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 20

23 2.1. 트랜잭션성능추적 액티브스택의예 java.lang.stringbuffer.append(stringbuffer.java:309) java.util.regex.matcher.appendreplacement(matcher.java:839) java.util.regex.matcher.replaceall(matcher.java:906) java.lang.string.replaceall(string.java:2162) core.log.triggers.triggerregister.changenotify(triggerregister.java:114) core.log.aop.handler.daoinfo.log(daoinfo.java:141) core.log.aop.handler.daoinfo.doaround(daoinfo.java:102) core.log.aop.reflection.profiler.aroundprofiler.invoke(aroundprofiler.java:19) com.sun.proxy.$proxy39.getupdatecount(unknown Source) org.apache.ibatis.executor.resultset.defaultresultsethandler.getnextresultset(defaultresultsethandler.java:256) org.apache.ibatis.executor.resultset.defaultresultsethandler.handleresultsets(defaultresultsethandler.java:193) org.apache.ibatis.executor.statement.preparedstatementhandler.query(preparedstatementhandler.java:64) * * * sun.reflect.generatedmethodaccessor140.invoke(unknown Source) sun.reflect.delegatingmethodaccessorimpl.invoke(delegatingmethodaccessorimpl.java:43) java.lang.reflect.method.invoke(method.java:606) org.springframework.web.method.support.invocablehandlermethod.doinvoke(invocablehandlermethod.java:221) org.springframework.web.method.support.invocablehandlermethod.invokeforrequest(invocablehandlermethod.java:136) org.springframework.web.servlet.mvc.method.annotation.servletinvocablehandlermethod.invokeandhandle(servletinvocab lehandlermethod.java:114) org.springframework.web.servlet.mvc.method.annotation.requestmappinghandleradapter.invokehandlermethod(requestmapp inghandleradapter.java:827) 최적화된데이터수집 트랜잭션을수행중인쓰레드에대해서만스택을덤프합니다. 액티브스택덤프시간간격을조정할수있습니다. (active_stack_second=10) 액태브스택의최대라인에제한되어있습니다,top라인에서부터기본 50라인을수집합니다. (trace_active_callstack_depth=50) 액티브스택의각라인은해쉬처리되어수집됩니다.(text는한번만 ) 한타임에수집되는최대액티브스택갯수도제한되어있습니다.(active_stack_count=100) Background v1.6.2 기본적으로액티브스택은트랜잭션이수행되고있는쓰레드의스택을말합니다. 하지만일부백그라운드쓰레드에대해서도스택을분석할필요가있을수있습니다. 이때옵션을통해서백그라운드쓰레드에대한액티브스택을확보할수있습니다. async_stack_enabled=false async_stack_enabled 를 true 로설정하면활성화됩니다. active_stack_second=10 스택덤프간격은포그라운드액티브스택설정에따가랍니다. async_thread_match=http*,abc* 대상쓰레드이름을지정할때는 '*' 사용하여문자열패턴을지정합니다. 쓰레드이름으로스택덤프대상을식별합니다. "," 를사용하여 match 를여러개를지정할수있습니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 21

24 2.2. 통계 ( 리스트데이터 ) async_thread_parking_class=sun.misc.unsafe async_thread_parking_method=park 스택의 Top 메소드가 async_thread_parking 에등록된클래스 / 메소드일때쓰레드가파킹상태에있다고판단하고덤프를생성하지않습니다 통계 ( 리스트데이터 ) 와탭에이전트는트랜잭션이나 SQL 처럼중요한서비스수행이력통계를수집합니다. 매 5 분마다목록을만들고서버로전송합니다. 0 분,5 분,15 분등매 5 분마다통계를수집하고서버로전송합니다 트랜잭션통계 트랜잭션통계를수집합니다. 매 5 분마다최대 5000 개의 URL 별수행통계를수집하여서버에전송합니다. 만약서로다른 URL 의수가 5 분동안 5000 개가넘으면무시됩니다. 칼럼설명타입 hash URL 해쉬 u4 count 건수 u4 error 에러건수 u4 time_sum 응답시간의합 u8 time_max 최대응답시간 u4 sql_count SQL 수행건수 u4 sql_time SQL 수행시간의합 u8 sql_fetch SQL 패치건수 u4 sql_fetch_time SQL 패치시간의합 u8 httpc_count HTTP Call 건수 u4 httpc_time HTTP Call 시간의합 u8 malloc_sum 메모리사용량 SUM u8 cpu_sum CPU 사용량 SUM u8 malloc_sum 은 trace_malloc_enabled=true 로변경해야수집됩니다.(default: false) SQL 수행통계 5 분동안의 SQL 수행통계를수집합니다. 5 분동안서로다른 SQL 문장이최대 5000 까지만허용이됩니다. 만약하나의 node.js 프로세스에서한계를 넘는 SQL 이발생하면통계데이터에서는버려집니다. 칼럼설명타입 dbc DB 연결정보의 Hash u4 sql SQL 문 Hash u4 count_total 수행건수 u4 count_error 에러건수 u4 Copyright c 2019 WhaTap Labs Inc. All rights reserved. 22

25 2.2. 통계 ( 리스트데이터 ) 칼럼설명타입 time_sum 응답시간의합 u8 time_max 최대응답시간 u4 fetch_count 패치건수 u4 fetch_time 패치시간의합 u8 service SQL 을수행한 service 중에하나 u4 service(url) hash 는 5 분동안해당 SQL 을호출한 URL 중하나 ( 마지막호출 URL) 를분석활용을위해수집합니다 HTTPCall 수행통계 5 분동안의 Http Call 수행통계를수집합니다. 5 분동안서로다른 Http Call 문장이최대 5000 까지만허용이됩니다. 만약하나의 node.js 프로세스에서한계를넘는외부 Http Call 이발생하면통계데이터에서는버려집니다. 칼럼설명타입 url 타겟 URL hash u4 host Host or ip u4 port Tcp Port u4 count_total 수행건수 u4 count_error 에러건수 u4 time_sum 응답시간의합 u8 time_max 최대응답시간 u4 service Http Call 을수행한 service 중에하나 u 에러통계 5 분동안발생한서비스에러에대한통계입니다. 서로다른에러 + 트랜잭션이름을키로발생건수를수집합니다. 5 분당최대 1000 가지서로다른 에러를통계화합니다. 칼럼설명타입 classhash 에러클래스 u4 service 트랜잭션 HASH u4 snapseq 스택정보 u8 msg 메세지 hash u4 count 발생건수 u IP 별호출건수 IP 별로호출한트랜잭션건수을통계적으로수집합니다. 5 분당수집가능한서로다른 IP 수는인스턴스당최대 개입니다. 칼럼설명타입 ip ip 주소 u4 Copyright c 2019 WhaTap Labs Inc. All rights reserved. 23

26 2.2. 통계 ( 리스트데이터 ) 칼럼설명타입 count 건수 u UserAgent 별호출건수 User Agnet 문자열의 Hash 별로호출건수를수집합니다. 5 분당수집가능한서로다른 UserAgent Hash 는인스턴스당최대 500 개입니다. 칼럼설명타입 hash hash u4 count 건수 u 트랜잭션 Caller 통계 멀티서버가 rest 호출로연결된경우 Caller 와 Callee 간의연관통계를수집할수있다. 이데이터를수집하기위해서는다음의옵션을먼저설정해야 한다. whatap.conf mtrace_rate=100 mtrace_spec=v1 stat_mtrace_enabled=true Figure 5. MSA 시스템 위와같은아키텍처에서 caller&callee 통계는 api1 와 api2 에서만조회할수있습니다. 사용자브라우저에서호출되는시스템에서는 Caller 통계를 조회할수없습니다. 하지만 Caller 쪽서버에서데이터를전송해야하기때문에모든서버에적절한설정이들어가야합니다. whatap.conf of [front] mtrace_rate=100 mtrace_spec=v1 stat_mtrace_enabled=true whatap.conf of [api1] & [api2] mtrace_spec=v1 stat_mtrace_enabled=true 수집되는통계데이터는다음과같습니다. Callee 쪽에서조회되어야합니다. 칼럼설명타입 caller_pcode Caller 의프로젝트 ( 와탭 ) 코드 u8 caller_spec Caller 의버전문자열 hash u4 caller_url Caller 의 URL hash u4 spec Callee 의버전문자열 hash u4 url Callee URL hash u4 count 수행건수 u4 Copyright c 2019 WhaTap Labs Inc. All rights reserved. 24

27 2.3. 성능카운터 칼럼설명타입 error 에러건수 u4 time 응답시간의합 u 트랜잭션도메인통계 와탭에이전트는도메일별트랜잭션통계를수집할수있습니다. 하나의서버에비즈니스적인이유등으로여러개의도메인을분리하여서비스하는 시스템에서는도메인별분석이필요할수있습니다. 그래서 front 서버에서유효하다 whatap.conf stat_domain_enabled=true 수집되는데이터는도메인별 URL 의처리현황을파악할수있습니다 칼럼설명타입 domain 서비스도메인 hash u4 url 트랜잭션 URL hash u4 count 수행건수 u4 error 에러건수 u4 time 응답시간의합 u 트랜잭션 REFERER 통계 와탭에이전트는 Referer 별트랜잭션통계를수집할수있습니다. 업무에딸서는 Referer 별분석이필요할수있습니다. whatap.conf stat_domain_enabled=true 수집되는데이터는도메인별 URL 의처리현황을파악할수있습니다 칼럼설명타입 referer Referer hash u4 url 트랜잭션 URL hash u4 count 수행건수 u4 error 에러건수 u4 time 응답시간의합 u 성능카운터 와탭에이전트가수집하는성능카운터는크게 3 가지로분류할수있습니다. Counters User : 실시간사용자혹은방문사용자 Copyright c 2019 WhaTap Labs Inc. All rights reserved. 25

28 2.3. 성능카운터 Service : 트랜잭션,SQL, 외부호출건수및응답, 에러율등 Resource : 시스템, 프로세스자원사용량 User Counter 사용자는모니터링대상시스템을사용하는클라이언트를말한다. 클라이언트에는다른시스테또한포함될수있지만일반적으로는브라우저를 기준으로사용자를카운팅한다. 웹시스템성능에서사용자는부하를발생시키는시작이기때문에중요하다사용자추적을위해서는사용자는어떤기준으로구분할것이며어떻게 카운팅할것인가에대한고려가필요하다 사용자구분 와탭에이전트사용자를구분하기위해다양한옵션을제공합니다. RemoteIP 가장기본은 remote ip 를사용하여사용자를구분하는것입니다. 하지만 remote ip 실제사용자를구분하는데한계가있습니다 Cookie(WHATAP) 쿠키를사용하여사용자를구분할수있습니다. 모든접속클라이언트에대한 UUID 가 "WHATAP" 이라는쿠키에셋팅합니다. whatap.conf trace_user_using_ip=false Header Key http header 에전달되는값으로사용자를구분할수있습니다..whatap.conf user_header_ticket=user 사용자카운팅 사용자를카운팅하는방법에따라서다른목적으로사용될수있다. 동시사용자는현재시스템을사용하는사용자의수를알기위해서측정하고일일 액티브사용자는하룻동안해당서비스에관심을갖는사용자가몇명인지에대한비즈니스적인관리를위해측정합니다. 실시간사용자 최근 5 분동안사용자수를카운팅합니다. 매 5 초마다 shifting 하면사용자를카운팅합니다. 각서버에서카운팅된숫자는 HyperLogLog 알고리즘을 통해서머지됩니다. 일일방문 ( 액티브 ) 사용자 (DAU) 하룻동안시스템에접속한사용자를카운팅합니다. 24 시간동안발생한사용자를 hyperloglog 를통해서계산합니다. 와탭에서는장기간사용자를카운팅하기위해사용자데이터에대한 byte block을서버로수집합니다. 이데이터를 hyperloglog 로머지하면이론적으로한달이상의맥티브사용자를계산할수있습니다 Service Counter 서비스카운터에는트랜잭션과트랜잭션이사용하는 SQL 혹은외부호출등에대한건수응답시간에러건수등에대한성능지표가표함된다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 26

29 2.3. 성능카운터 Transaction Counter 트랜잭션을수행하면측정하는카운터입니다. 건수 응답시간 에러건수 Active Transaction Counter 진행중인트랜잭션의수를카운팅합니다. 건수 Active Status 진행상태는 METHOD,SQL,HTTPC,DBC,SOCKET 5가지상태로고정되어있습니다. 1. METHOD - 일반함수를호출하는상태 2. SQL - db sql을수행중인상태 3. HTTPC - 외부 Http Api( 서비스 ) 를호출중인상태 4. DBC - DB연결을요청한상태, 일반적으로 Pool에서가져옴 5. SOCKET - TCP세션을 Connecting 중인상태 SQL SQL 수행현황을카운팅합니다. 건수 응답시간 에러건수 패치건수 HTTP Call 외부 Http 호출에대한현황을카운팅합니다. 건수 응답시간 에러건수 Resource Counter 서버자원혹은 node 프로세스내부의자원사용량을카운팅합니다. CPU(sys,usr,wait,steal,irq, cores) CPU 사용량 % 입니다. 각종류별로수집됩니다. 가상환경에서만 Steal 이의미가있습니다. Cput Core 갯수를같이수집하고있습니다. Process CPU 자바프로세스가사용하는 CPU % 입니다. Memory 시스템메모리사용율 (%) 입니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 27

30 2.4. Python 애플리케이션모니터링설정 Swap Swap 메모리사용율 (%) 입니다. Disk Disk 는 Java Process 의 Current 디렉토리의사용율 (%) 입니다. Unresolved directive in index.adoc - include::4_control&status.adoc[leveloffset=+1] 2.4. Python 애플리케이션모니터링설정 해당가이드는 Python 애플리케이션모니터링을할때에설정할수있는옵션에대해설명합니다. (*) 표시가있는옵션은애플리케이션을재시작 하여야만적용되는옵션입니다 에이전트네트워크통신에관한설정 license Default : NONE Type : String 에이전트설치시서버로부터부여받은라이센스를지정합니다. 라이센스에는에이전트가속한프로젝트와보안통신을위한암호키를포함하고있습니다. whatap.server.host Default : , Type : String 에이전트가수집한데이터를전송할서버를지정합니다. 수집서버이중화로 2개이상의 IP를가진경우콤마 (,) 로분리하여지정할수있습니다. 지정된 IP 에는수집서버 proxy 데몬이리스닝상태로서비스되어야합니다. whatap.server.port Default : 6600 Type : String 수집서버 PORT 를지정합니다. 포트는하나만지정할수있으므로 whatap_server_host 에지정된수집서버들은동일 PORT 를사용해야합니다 에이전트네트워크내부통신에관한설정 net_udp_port Default : 6600 Type : String 와탭에이전트는수집한데이터를 UDP를거쳐 TCP를통해서버로전송을하는데, 처음 UDP서버의포트를지정할수있습니다. 기본값으로제공되는 6600포트가사용중일때이옵션을사용합니다 에이전트네트워크외부통신에관한설정 tcp_so_timeout Default : Type : MiliSecond 수집서버와통신하는 TCP세션의 Socket Timeout 값을지정합니다. tcp_connection_timeout Copyright c 2019 WhaTap Labs Inc. All rights reserved. 28

31 2.4. Python 애플리케이션모니터링설정 Default : 5000 Type : MiliSecond 수집서버와통신하는 TCP 세션의 Connection Timeout 값을지정합니다. net_send_max_bytes Default : Type : Byte 에이전트가데이터를수집하고네트워크로한번에전송할수있는최대바이트크기입니다. net_send_buffer_size Default: 1024 Type: byte 데이터전송을하기위해가지고있는최대바이트크기입니다 애플리케이션등록에관한설정 object_name Default : {type}-{ip2}-{ip3}-{process} Type : String 애플리케이션을식별하는에이전트이름 (ONAME) 체계입니다. ONAME을토대로 OID가생성됩니다. 명칭 설명 {type} whatap.app_name 에설정된값을사용합니다. {ip#} IP 를나누었을때 # 번째자리를사용합니다. {process} whatap.app_process_name 에설정된값을사용합니다. {hostname} 서버호스트명을사용합니다. app_name Default : NONE Type : String 애플리케이션을식별하는에이전트이름 (ONAME) 체계에사용되는애플리케이션명. object_name의 {type} 에해당하는값이다. app_process_name Default : NONE Type : String 애플리케이션을식별하는에이전트이름 (ONAME) 체계에사용되는애플리케이션프로세스명. 애플리케이션서버의 CPU, Heap Memory등을수집할대상프로셋를설정합니다. object_name의 {process} 에해당하는값이다 에이전트기능제어에관한설정 enabled Default : true 전체기능을활성화합니다. false인경우에도서버와최소한의통신을유지하기위한정보는전송됩니다. counter_enabled Default : true 성능카운터추적을활성화합니다. 성능카운터는액티브트랜잭션, 사용자, CPU, Memory, SQL, 외부 HTTP 호출등의데이터를포함합니다. 단, Copyright c 2019 WhaTap Labs Inc. All rights reserved. 29

32 2.4. Python 애플리케이션모니터링설정 enable 이 false 면무시됩니다. stat_enabled Default : true 통계정보추적을활성화합니다. 5분마다트랜잭션, SQL Query, 외부 HTTP 호출, User Agent, Client IP등의통계데이터가수집되는데이들정보의수집이중단됩니다. 단, enable이 false면무시됩니다. active_stack_enabled Default : true 액티브스택추적을활성화합니다. 참고로, counter_enabled 값이비활성화된경우액티브트랜잭션데이터가수집되지않으므로액티브스택또한수집되지않습니다 트랜잭션프로파일데이터에관한설정 profile_http_header_enabled Default : false 프로파일에 HTTP 헤더정보를출력합니다. 헤더수집의여부와무관하게헤더를프로파일에노출할것인가에대한설정입니다. profile_http_parameter_enabled Default : false http 파라미터를프로파일링을활성화합니다. 단파라미터는별도보안키를입력해야조회할수있습니다. 보안키는에이전트설치경로의 paramkey.txt 파일에 6 자리로지정합니다. paramkey.txt 가존재하지않는경우자동생성되며 random 키가설정됩니다. profile_dbc_close(*) Default : false (profile_connection_open_enabled=true 에서만동작 ) profile_connection_open_enabled이활성화되어있는경우, 프로파일에 DB Connection이 close될때의정보를출력합니다. profile_step_normal_count Default: 1000 Type : Int 트랜잭션프로파일의기본스텝수를지정합니다. profile_step_heavy_count Default: 1020 Type : Int 프로파일기본스텝을초과한경우, 최대 heavy스텝수를제한합니다. profile_step_normal_count에서 profile_step_heavy_time을초과하는스텝을카운팅합니다. 따라서, 응답시간이없는스텝들은수집되지않습니다. profile_step_max_count Default: 1024 Type : Int 프로파일스텝의최대수를설정합니다. 수집된프로파일스텝수가이값을초과하면이후수집되는스텝들은모두버려집니다. profile_step_heavy_count을최대 1000으로설정한다면 profile_step_max_count만큼액티브스택이수집됩니다. profile_step_heavy_time Default: 100 Type : MiliSecond Copyright c 2019 WhaTap Labs Inc. All rights reserved. 30

33 2.4. Python 애플리케이션모니터링설정 Heavy 한스텝의기준을지정합니다. 지정된값보다수행시간이긴경우 profile_step_normal_count 를초과하는경우라도 profile_step_heavy_count 이내에서기록됩니다. profile_basetime Default: 0 Type : MiliSecond 트랜잭션이설정된값이하의시간내에종료된경우프로파일정보를수집하지않습니다. 단, 5 분단위로최초호출된 URL, 에러가발생한트랜잭션에대한프로파일정보는수집됩니다. query_string_enabled Default : false 트랜잭션 URL의쿼리스트링을함께수집하는기능을활성화합니다. query_string_urls Default : NONE Type : String 트랜잭션에서쿼리스트링을수집할 URL들을등록합니다. 여러개를등록할때는콤마 (,) 를사용합니다. profile_sql_param_enabled Default : false SQL 파라미터를수집을활성화합니다. 단파라미터는별도보안키를입력해야조회할수있습니다. 보안키는에이전트설치경로의 paramkey.txt 파일에 6 자리로지정합니다. paramkey.txt 가존재하지않는경우자동생성되며 random 키가설정됩니다. profile_sql_resource_enabled Default : false 프로파일에서 SQL 이수집될때해당스텝에서사용한 CPU 와 Memory 사용량을추적합니다. 트랜잭션에서리소스들의사용량을확인할때구간으로나누어추적이용이합니다. profile_httpc_resource_enabled Default : false 프로파일에서 HTTP Call 스텝이수집될때해당스텝에서사용한 CPU 와 Memory 사용량을추적합니다. hook_method_patterns Default : None Type : String 특정메소드의응답시간을측정하고싶을때사용합니다. [MODULE_NAME]:[CLASS_NAME].[FUNCTION_NAME] 혹은 [MODULE_NAME]:[FUNCTION_NAME] 형식으로값을사용합니다., 구분자를통하여여러메소드패턴을지정할수있으며모듈에대한전체클래스나, 클래스에대한전체모듈은 asterisk(*) 를사용하여추적이가능합니다. 단, 전체모듈에대한추적은오버헤드가발생할수있으니운영환경시에는가급적정확한모듈명과메소드명에대한사용을권장합니다. mtrace_rate Default : 0 Type : % 최초트랜잭션이발생할때발급받는 MTID(Multi Transaction ID) 의발급비율을설정하는옵션이다. MTID 를추적하면등록된모든애플리케이션간의호출을확인할수있습니다. 같은프로젝트에속한애플리케이션은 Caller & Callee 기능을통해트랜잭션의프로파일을바로확인가능합니다. mtrace_spec Default: v1 Copyright c 2019 WhaTap Labs Inc. All rights reserved. 31

34 2.4. Python 애플리케이션모니터링설정 Type : String 현인스턴스의애플리케이션버전을지정합니다. 임의의문자열을지정할수있습니다. 이데이터는호출통계를위해사용됩니다. mtrace_send_url_length Default : 80 Type : Integer 사용자추적을위한설정 trace_user_enabled(*) Default : true 실시간사용자를추적할지를결정합니다. 이값을활성화하는경우기본값은 IP가됩니다. trace_user_using_ip(*) Default : true 실시간사용자의구분을 IP로하고자하는경우설정합니다. 이데이터는 Real Time User에서확인가능합니다. 단, user_header_ticket옵션과배타적으로설정을동시에적용할수없습니다 트랜잭션추적을위한설정 trace_error_callstack_depth Default: 50 Type : Int 트랜잭션에서에러콜스택을수집할때, 콜스택최대라인수를지정합니다. 이데이터는에러통계데이터에서조회할수있습니다. trace_active_callstack_depth Default: 50 Type : Int 트랜잭션에서액티브스택을수집할때, 콜스택최대라인수를지정합니다. trace_active_transaction_slow_time Default: 3000 Type : MiliSecond 엑티브트랜잭션의아크이퀄라이저에서 slow 구간의응답기준을지정합니다. trace_active_transaction_very_slow_time Default: 8000 Type : MiliSecond 엑티브트랜잭션의아크이퀄라이저에서 very slow 구간의응답기준을지정합니다. trace_active_transaction_lost_time Default: Type : MiliSecond 트랜잭션의종료를기다리는제한시간. 5분안에트랜잭션이끝나지않는경우트랜잭션을정보를더이상수집하지않습니다. web_static_content_extensions(*) Default : js, htm, html, gif, png, jpg, css, swf, ico Type : String 스태틱컨텐츠임을판단하는확장자를지정합니다. 여기에설정된확장자를가진트랜잭션들은프로파일추적과카운팅이제외됩니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 32

35 2.5. 성능카운터 & 통계확장 2.5. 성능카운터 & 통계확장 stat_domain_enabled Default : false 도메인별트랜잭션통계를수집합니다. stat_domain_max_count Default : 7000 Type : Int 5분동안애플리케이션에서수집할도메인별트랜잭션통계의최대레코드수입니다. stat_mtrace_enabled Default : false 멀티서버트랜잭션에서 Callser&Callee간에버전별의존성통계를수집합니다. stat_mtrace_max_count Default : 7000 Type : Int 멀티서버트랜잭션에서 Callser&Callee간에버전별의존성통계의최대레코드수입니다. stat_login_enabled Default : false 로그인별트랜잭션통계를수집합니다. stat_login_max_count Default : 7000 Type : Int 5분동안애플리케이션에서수집할로그인별트랜잭션통계의최대레코드수입니다. stat_referer_enabled Default : false Referer별트랜잭션통계를수집합니다. stat_referer_max_count Default : 7000 Type : Int 5분동안애플리케이션에서수집할 Referer별트랜잭션통계의최대레코드수입니다. stat_tx_max_count Default : 5000 Type : Int stat_sql_max_count Default : 5000 Type : Int stat_httpc_max_count Default : 5000 Copyright c 2019 WhaTap Labs Inc. All rights reserved. 33

36 2.5. 성능카운터 & 통계확장 Type : Int stat_error_max_count Default : 1000 Type : Int stat_useragent_max_count Default : 500 Type : Int 운영을위한설정 active_stack_second Default : 10 Type : Seconds 액티브스택을추적하는간격을설정합니다. ( 주의 : 값을바꾸는것을권장하지않습니다.) 값을 바꾸는것을권장하지않습니다. realtime_user_thinktime_max Default : Type : MiliSeconds 실시간사용자측정시동일사용자로인정되는최대호출간격을지정합니다. time_sync_interval_ms Default : Type : MiliSeconds 에이전트와서버간시간동기화주기를지정합니다. 동기화하지않을경우 0으로지정합니다. text_reset Default : 0 Type : Int 와탭에이전트는한번보낸텍스트유형데이터는 hash 처리되므로다음날까지재전송하지않습니다. 이전설정값과다른값을설정하는경우재전송합니다. 트랜잭션 URL, SQL String 등이텍스트유형데이터에해당합니다. trace_auto_normalize_enabled(*) Default : true 트랜잭션 URL 정규화할때패턴값을어노테이션에서추출하여자동으로파싱하는기능을활성화합니다. trace_normalize_enabled Default : true 트랜잭션 URL 을파싱하여정규화하는기능을활성화합니다. false 로변경시패스파라미터파싱이비활성화됩니다. 이경우통계데이터의의미가약화됨으로디버그용도로만잠시사용하는 것이좋습니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 34

37 2.5. 성능카운터 & 통계확장 trace_normalize_urls Default : NONE Type : String 트랜잭션 URL을파싱하여정규화합니다. 호출 URL패턴을파싱하여패스파라미터를제거합니다. 예를들어, /a/{v}/b라고선언하면 /a/123/b /a/{v}/b로치환합니다. 여러개를등록할때는콤마 (,) 를사용합니다. /a/*/b 로사용하여특정형식의패스파라미터를제거하여수집할수있습니다. trace_httpc_normalize_enabled Default : true 외부 HTTP 호출 (HTTP Call) URL을파싱하여정규화하는기능을활성화합니다. trace_httpc_normalize_urls Default : NONE Type : String 외부 HTTP 호출하는 URL을파싱하여정규화합니다. 호출 URL패턴을파싱하여패스파라미터를제거합니다. 예를들면, /a/{v}/b라고선언하면 /a/123/b /a/{v}/b로치환한다. 여러개를등록할때는콤마 (,) 를사용합니다. /a/*/b 로사용하여특정형식의패스파라미터를제거하여수집할수있습니다. trace_sql_normalize_enabled Default : true SQL문에서리터럴부분을추출하여 SQL문을정규화하는기능을활성화합니다 로그를위한설정 log_rotation_enabled Default : true 에이전트로그파일을매일변경합니다. ( 로그파일기본경로 : $WHATAP_HOME/logs/whatap-xxx.log) log_keep_days Default : 7 Type : Day 로그파일보관기간을설정합니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 35