Java Application Monitoring Agent Configure 이문서는와탭 APM 서비스사용자가에이전트설치를돕기위해작성된문서입니다. 이문서는와탭랩스의고유한자산으로재배포또는사용을위해서는 와탭랩스 (support@whatap.io) 에연락주시기바랍니다.
목차 1.1. Java 애플리케이션모니터링... 7 1.1.1. 에이전트기능제어... 7 1.1.1.1. enabled... 7 1.1.1.2. transaction_enabled... 7 1.1.1.3. counter_enabled... 7 1.1.1.4. stat_enabled... 7 1.1.1.5. sigar_enabled... 7 1.1.1.6. active_stack_enabled... 8 1.1.1.7. license... 8 1.1.1.8. cypher_level... 8 1.1.1.9. encrypt_level... 8 1.1.1.10. dbcp_pool_enabled... 9 1.1.1.11. hikari_pool_enabled... 9 1.1.1.12. tomcat_ds_enabled... 9 1.1.1.13. weblogic_ds_enabled... 10 1.1.1.14. weblogic_pool_enabled... 10 1.1.2. 에이전트네트워크설정... 10 1.1.2.1. whatap_server_host... 10 1.1.2.2. whatap_server_port... 10 1.1.2.3. tcp_so_timeout... 11 1.1.2.4. tcp_connection_timeout... 11 1.1.2.5. net_send_max_bytes... 11 1.1.2.6. net_send_queue1_size... 11 1.1.2.7. net_send_queue2_size... 11 1.1.3. 트랜잭션처리제한... 12 1.1.3.1. throttle_enabled... 12 1.1.3.2. throttle_limit... 12 1.1.3.3. throttle_passing_url... 12 1.1.3.4. throttle_passing_url_prefix... 12 1.1.3.5. throttle_blocking_url... 13 1.1.3.6. throttle_blocking_ip... 13 1.1.3.7. throttle_rejected_message... 13 1.1.3.8. throttle_rejected_forward... 13
목차 1.1.3.9. throttle_rejected_forward_ok... 13 1.1.3.10. throttle_blocked_message... 14 1.1.3.11. throttle_blocked_forward... 14 1.1.3.12. throttle_blocked_forward_ok... 14 1.1.3.13. reject_event_enabled... 14 1.1.3.14. reject_event_interval... 14 1.1.4. 프로파일링옵션... 15 1.1.4.1. profile_http_header_enabled... 15 1.1.4.2. profile_http_header_url_prefix... 15 1.1.4.3. profile_http_parameter_enabled... 15 1.1.4.4. profile_http_parameter_url_prefix... 15 1.1.4.5. profile_connection_open_enabled... 16 1.1.4.6. profile_step_normal_count... 16 1.1.4.7. profile_step_heavy_count... 16 1.1.4.8. profile_step_max_count... 16 1.1.4.9. profile_step_heavy_time... 16 1.1.4.10. profile_basetime... 17 1.1.4.11. profile_sql_param_enabled... 17 1.1.4.12. profile_sql_resource_enabled... 17 1.1.4.13. profile_method_resource_enabled... 17 1.1.4.14. profile_httpc_resource_enabled... 17 1.1.4.15. profile_dbc_close... 18 1.1.4.16. profile_position_sql... 18 1.1.4.17. profile_position_httpc... 18 1.1.4.18. profile_position_method... 18 1.1.4.19. profile_position_depth... 18 1.1.4.20. profile_update_count... 19 1.1.5. 사용자추적옵션... 19 1.1.5.1. trace_user_enabled... 19 1.1.5.2. trace_user_using_ip... 19 1.1.5.3. trace_user_using_jsession... 19 1.1.5.4. trace_user_cookie_limit... 20 1.1.5.5. user_header_ticket_enabled... 20
목차 1.1.5.6. user_header_ticket... 20 1.1.5.7. trace_http_client_ip_header_key... 20 1.1.6. 트랜잭션추적옵션... 21 1.1.6.1. trace_auto_transaction_enabled... 21 1.1.6.2. trace_auto_transaction_backstack_enabled... 21 1.1.6.3. trace_background_socket_enabled... 21 1.1.6.4. trace_transaction_name_header_key... 21 1.1.6.5. trace_transaction_name_key... 22 1.1.6.6. trace_error_callstack_depth... 22 1.1.6.7. trace_active_callstack_depth... 22 1.1.6.8. trace_active_transaction_yellow_time... 22 1.1.6.9. trace_active_transaction_red_time... 22 1.1.6.10. trace_intertx_enabled... 22 1.1.6.11. trace_dbc_leak_enabled... 23 1.1.6.12. trace_dbc_leak_fullstack_enabled... 23 1.1.6.13. trace_httpc_normalize_urls... 23 1.1.6.14. trace_httpc_normalize_enabled... 23 1.1.6.15. trace_normalize_urls... 24 1.1.6.16. trace_normalize_enabled... 24 1.1.6.17. trace_auto_normalize_enabled... 24 1.1.6.18. trace_sql_normalize_enabled... 24 1.1.6.19. web_static_content_extensions... 25 1.1.6.20. profile_error_jdbc_fetch_max... 25 1.1.6.21. profile_error_sql_time_max... 25 1.1.6.22. prepared_sql_max... 25 1.1.6.23. mtrace_rate... 25 1.1.6.24. recursive_max... 26 1.1.7. 로그옵션... 26 1.1.7.1. log_datasource_lookup_enabled... 26 1.1.7.2. log_rotation_enabled... 26 1.1.7.3. log_keep_days... 26 1.1.8. 바이트코드 INSTRUMENTATION 옵션... 27 1.1.8.1. hook_connection_open_patterns... 27
목차 1.1.8.2. hook_method_patterns... 27 1.1.8.3. hook_method_ignore_prefixes... 27 1.1.8.4. hook_method_ignore_classes... 27 1.1.8.5. hook_method_access_public_enabled... 28 1.1.8.6. hook_method_access_private_enabled... 28 1.1.8.7. hook_method_access_protected_enabled... 28 1.1.8.8. hook_method_access_none_enabled... 28 1.1.8.9. hook_service_access_public_enabled... 28 1.1.8.10. hook_service_access_private_enabled... 29 1.1.8.11. hook_service_access_protected_enabled... 29 1.1.8.12. hook_service_access_none_enabled... 29 1.1.8.13. hook_serivce_ignore_methods... 29 1.1.8.14. hook_service_patterns... 29 1.1.8.15. hook_httpservlet_classes... 30 1.1.8.16. hook_httpc_patterns... 30 1.1.8.17. hook_future_classes... 30 1.1.8.18. hook_future_prefix... 30 1.1.8.19. hook_runnable_classes... 31 1.1.8.20. hook_runnable_prefix... 31 1.1.8.21. hook_jdbc_pstmt_classes... 31 1.1.8.22. hook_jdbc_stmt_classes... 31 1.1.8.23. hook_jdbc_rs_classes... 31 1.1.8.24. hook_jdbc_wrapping_driver_patterns... 32 1.1.8.25. hook_jsp_patterns... 32 1.1.8.26. hook_trace_helper_patterns... 32 1.1.8.27. hook_trace_helper_end_patterns... 32 1.1.8.28. hook_trace_helper_start_patterns... 33 1.1.8.29. hook_direct_patch_classes... 33 1.1.9. 운영설정... 33 1.1.9.1. active_stack_second... 33 1.1.9.2. boot_redefine_size... 34 1.1.9.3. counter_procfd_enabled... 34 1.1.9.4. counter_netstat_enabled... 34
목차 1.1.9.5. realtime_user_thinktime_max... 34 1.1.9.6. time_sync_interval_ms... 34 1.1.9.7. detect_deadlock_enabled... 35 1.1.9.8. text_reset... 35 1.1.9.9. auto_oname_enabled... 35 1.1.9.10. auto_oname_prefix... 35 1.1.9.11. auto_oname_reset... 36 1.1.10. 알림설정옵션... 36 1.1.10.1. 재귀적으로 forward 되는요청에대한경고알림설정... 36 1.1.10.2. 서비스거절 ( 호출부하제한 / 거절 )) 시경고... 36 1.1.10.3. 외부 API 호출에서에러발생시경고... 37 1.1.10.4. 힙사용량경고... 37 1.1.10.5. 디스크사용량경고... 37 1.1.10.6. CPU 사용량경고... 38 1.1.10.7. DB Connection 중복할당경고... 38 1.1.10.8. Exception 발생시경고... 38 1.1.11. 에이전트명명옵션... 39 1.1.11.1. priority... 39 1.1.11.2. JVM Options Only... 39 1.1.11.3. -Dwhatap.name... 39 1.1.11.4. -Dwhatap.oname... 40 1.1.11.5. 예외적옵션... 40 1.1.11.5.1. object_name... 40 1.1.12. 부록... 41 1.1.12.1. 데이터베이스관련이슈추적옵션... 41 1.1.12.2. tomcat_ds_enabled / weblogic_ds_enabled... 41 1.1.12.3. dbcp_pool_enabled / hikari_pool_enabled... 41 1.1.12.4. profile_dbc_close... 41 1.1.12.5. trace_dbc_leak_enabled... 41 1.1.12.6. trace_dbc_leak_fullstack_enabled... 41 1.1.12.7. 에이전트설정분리옵션... 41 1.1.12.8. -Dwhatap.config... 41
1.1. Java 애플리케이션모니터링 1.1.1. 에이전트기능제어 1.1.1.1. enabled true 전체기능을활성화합니다. 단 false 가되어도서버와최소한의통신을유지하기위한정보는전송됩니다. 1.1.1.2. transaction_enabled true 단 enabled==false 이면무시됨 (false) 트랜잭션추적기능을활성화합니다. 1.1.1.3. counter_enabled true 단 enabled==false 이면무시됨 (false) 성능카운터 ( 트랜잭션, 리소스등 ) 추적을활성화합니다. 1.1.1.4. stat_enabled true 단 enabled==false 이면무시됨 (false) 통계정보추적을활성화합니다. 5 분마다트랜잭션, SQL, HTTPCALL, UserAgent, Client IP 등의통계데이터가수집되는데이들정보의수집이중단됩니다. 1.1.1.5. sigar_enabled
true 단 enabled==false 이면무시됨 (false) sigar library 를통한 OS 정보수집을활성화합니다. 5 초마다 CPU, Memory, Disk 등의자원데이터를 sigar library 를통해수집할지의여부를결정합니다. 1.1.1.6. active_stack_enabled true 단 enabled==false 또는 counter_enabled==false 이면무시됨 (false) 액티브스택추적을활성화합니다. 1.1.1.7. license 에이전트가속한프로젝트의 PCODE 서버와보안통신을위한암호키를포함하고있는보안문자열을설정합니다. 1.1.1.8. cypher_level 128 AES 보안알고리즘에대한암호레벨을지정한다 128,256 중하나를사용할수있다. 1.1.1.9. encrypt_level 2 단, 값의범위는 1,2,3 중에하나를지정할수있다. 와탭은데이터에따라다른암호화알고리즘을적용합니다. 주로 Text 는보안레벨을높게적용하고단순숫자데이터는보안레벨을낮게적용합니다.
이러한보안레벨을적용할때일괄적으로전체적인보안레벨을보다높게 혹은보다낮게적용할수있는데그것을지정하는옵션이다. 1.1.1.10. dbcp_pool_enabled false 데이터소스풀추적을활성화하는기능이다. datasource 를직접추적하고자하는경우 true 로설정한다. JMX 비활용 (datasource connection pool) 정보를수집 ANALYSIS > Daily Counter 의 Resource - DB Connection Total/Active/Idle 지표수집에관여합니다. 1.1.1.11. hikari_pool_enabled false hikari 데이터소스풀추적을활성화하는기능이다. hikari dbcp 를직접추적하고자하는경우 true 로설정한다. JMX 비활용 (datasource connection pool) 정보를수집 ANALYSIS > Daily Counter 의 Resource - DB Connection Total/Active/Idle 지표수집에관여합니다. 1.1.1.12. tomcat_ds_enabled false 톰캣데이터소스추적을활성화하는기능이다. 실질적으로 tomcat datasource 를추적하고자하는경우 true 로설정한다. JMX 활용 ANALYSIS > Daily Counter 의 Resource - DB Connection Total/Active/Idle 지표수집에관여합니다.
1.1.1.13. weblogic_ds_enabled false weblogic 데이터소스추적을활성화하는기능이다. 실질적으로 weblogic datasource 를추적하고자하는경우 true 로설정한다. JMX 활용 ANALYSIS > Daily Counter 의 Resource - DB Connection Total/Active/Idle 지표수집에관여합니다. 1.1.1.14. weblogic_pool_enabled false weblogic 데이터소스풀추적을활성화하는기능이다. 실질적으로 weblogic datasource 를추적하고자하는경우 true 로설정한다. JMX 비활용 (datasource connection pool) 정보를수집 ANALYSIS > Daily Counter 의 Resource - DB Connection Total/Active/Idle 지표수집에관여합니다. 1.1.2. 에이전트네트워크설정 1.1.2.1. whatap_server_host 127.0.0.1, 127.0.0.1 수집서버아이피를지정합니다. 콤마 (,) 로분리하여하나혹은 2 개를지정할수있다. 단여기서지정하는서버에는 proxy 서버가리스닝하고있어야합니다. 1.1.2.2. whatap_server_port 6600
수집서버 PORT 를지정합니다. 포트는하나만지정할수있다. 따라서 whatap_server_host 에지정된수집서버들은동일 PORT 를사용해야합니다. 1.1.2.3. tcp_so_timeout 60000 수집서버와통신할때 TCP 세션의 idle 타임아웃값을지정합니다. 1.1.2.4. tcp_connection_timeout 5000 수집서버와통신세션을연결할때연결지연가능시간을지정합니다. 1.1.2.5. net_send_max_bytes 5242880 에이전트가데이터를수집하고네트웍으로한번에전송할수있는최대 byte 크기이다. 1.1.2.6. net_send_queue1_size 512 에이전트는두개의네트워크큐를사용합니다. 1 번큐에는프로파일과액티브스택을제외한모든데이터전송시사용됩니다. 1.1.2.7. net_send_queue2_size 1024
에이전트는두개의네트워크큐를사용합니다. 2 번큐에는프로파일과 액티브스택을전송하는데사용됩니다. 1.1.3. 트랜잭션처리제한 1.1.3.1. throttle_enabled false 쓰로틀링기능을활성화합니다. 1.1.3.2. throttle_limit 10000 최대동시처리개수를지정합니다. WAS 에서동시처리되는요청 ( 트랜잭션 ) 수가지정한값을넘으면추가로도달하는요청은 reject 됩니다. 1.1.3.3. throttle_passing_url 최대동시처리한계를초과해도 reject 하지않고처리해야할 URL, 만약여러개를지정해야하면콤마 (,) 를사용합니다. 1.1.3.4. throttle_passing_url_prefix 최대동시처리한계를초과해도 reject 하지않고처리해야할 URL 의 prefix, 만약여러개를지정해야하면콤마 (,) 를사용합니다.
1.1.3.5. throttle_blocking_url 무조건블럭킹 ( 처리거부 ) 해야할 URL 을지정합니다. 시스템의장애가나는 URL 를봉쇄하기위해사용할수있다. 1.1.3.6. throttle_blocking_ip 무조건요청을거부해야할 ip 를지정합니다. 디도스공격이나잘못된사용자를 IP 기반으로봉쇄할때사용할수있다. 1.1.3.7. throttle_rejected_message too many request!! 사용자요청이 limit 값을넘어 reject 될때사용자에게전달되는안내메시지 1.1.3.8. throttle_rejected_forward 사용자요청이 limit 값을넘어 reject 될때사용자에게전달되는안내페이지 URL, 주의 ) 안내페이지는 static html 페이지로만들어야합니다. dynamic 페이지로안내를만드는경우에는무한루프에빠져장애를유발할수있다. 1.1.3.9. throttle_rejected_forward_ok
true 사용자요청이 limit 값을넘어 reject 될때사용자에게안내페이지로 forward 할지단순메시지를전송할지를결정함. 1.1.3.10. throttle_blocked_message request blocked!! 사용자요청이 block 되어메세지로안내될때사용될메시지 1.1.3.11. throttle_blocked_forward 사용자요청이 block 되었을때포워드할안내페이지 1.1.3.12. throttle_blocked_forward_ok true 사용자요청이 block 될때안내페이지로포워드할지단순메세지로안내할지를지정함 1.1.3.13. reject_event_enabled false 사용자요청이 block 될때이벤트알림을발행할지를지정함 1.1.3.14. reject_event_interval 30000 사용자요청이 block 될때이벤트알림발행간격을지정함
reject_enabled=true 로설정된경우에한하여유효함 1.1.4. 프로파일링옵션 1.1.4.1. profile_http_header_enabled false http 헤더정보를프로파일에출력하고자할때 헤더수집여부와무관함, 헤더를프로파일에노출할지에대한설정임 1.1.4.2. profile_http_header_url_prefix / http 헤더를프로파일에출력할때대상 URL 에대한 prefix 1.1.4.3. profile_http_parameter_enabled false http 파라미터를프로파일링을활성화합니다. 단파라미터는별도보안키를입력해야조회할수있다. 보안키는에이전트설치경로의 paramkey.txt 파일에 6 자리로지정합니다. paramkey.txt 가존재하지않는경우자동생성되며 random 키가설정됩니다. 1.1.4.4. profile_http_parameter_url_prefix / http 파라미터를프로파일링활성화할때적용될 URL prefix 를설정합니다.
1.1.4.5. profile_connection_open_enabled true DBConnection 오픈정보를프로파일링할때활성화여부를지정합니다. 1.1.4.6. profile_step_normal_count 800 프로파일기본스텝수를제한합니다. 1.1.4.7. profile_step_heavy_count 1000 프로파일의기본스텝을초과하여최대 heavy 스텝수를제한합니다. profile_step_normal_count 에서 profile_step_heavy_count 사이에서는 profile_step_heavy_time 을초과하는스텝만수집됩니다. 1.1.4.8. profile_step_max_count 1024 프로파일스텝의최대수, 수집된프로파일스텝수가이값을초과하면이후수집되는스텝들은모두버려진다. 1.1.4.9. profile_step_heavy_time 100 profile_step_normal_count 에서 profile_step_heavy_count 사이에서는 profile_step_heavy_time 을초과하는스텝만수집됩니다.
1.1.4.10. profile_basetime 500 트랜잭션의처리시간이이값에미치지못하는경우프로파일정보는수집되지않는다. 단 5 분당최초호출된 URL, 에러트랜잭션은수집됩니다. 1.1.4.11. profile_sql_param_enabled false SQL 파라미터를수집을활성화합니다. 단파라미터는별도보안키를입력해야조회할수있다. 보안키는에이전트설치경로의 paramkey.txt 파일에 6 자리로지정합니다. paramkey.txt 가존재하지않는경우자동생성되며 random 키가설정됩니다. 1.1.4.12. profile_sql_resource_enabled false 프로파일에서 SQL 스텝이수집될때트랜잭션이시작부터해당스텝까지사용한 CPU 와메모리사용량을추적합니다. 1.1.4.13. profile_method_resource_enabled false 프로파일에서 METHOD 스텝이수집될때트랜잭션이시작부터해당스텝까지사용한 CPU 와메모리사용량을추적합니다. 1.1.4.14. profile_httpc_resource_enabled false
프로파일에서 HTTP Call 스텝이수집될때트랜잭션이시작부터해당 스텝까지사용한 CPU 와메모리사용량을추적합니다. 1.1.4.15. profile_dbc_close false DB Connection 이 close 될때프로파일스텝으로추가할때설정합니다. 단 open connection 이출력되어야이옵션이동작합니다. trace_dbc_leak_enabled=true 인경우에만활성화됩니다. 1.1.4.16. profile_position_sql 이옵션에서지정한 SQL 이수행되면어디서수행되었는지스택을같이프로파일에출력합니다. 1.1.4.17. profile_position_httpc 알수없는 HTTPC 가프로파일링될때그위치를찾아낼때사용합니다. 1.1.4.18. profile_position_method 프로파일링되는메소드가어떻게호출되는지디버깅하고자할때 true 설정합니다. 1.1.4.19. profile_position_depth
50 position 추적을위해스택을덤프할때스택라인수를지정합니다. 1.1.4.20. profile_update_count false update sql 의건수를프로파일정보에출력합니다. excuteupdate 메소드를호출한경우에한하여출력합니다. 1.1.5. 사용자추적옵션 1.1.5.1. trace_user_enabled true 실시간사용자를추적할지결정합니다. default 가 true 이므로일반적인경우설정하지않는것을추천합니다. 1.1.5.2. trace_user_using_ip false IP 를기반으로실시간사용자를추적합니다. user_header_ticker 와배타적설정으로동시에적용할수없습니다. Realtime User 를 count 하기위한정보로사용됩니다. trace_http_client_ip_header_key 와동시에적용시, 헤더로부터추출한정보를기반으로 Realtime User 및 Client IP 를추적할수있습니다. - ex) x-forwarded-for 1.1.5.3. trace_user_using_jsession false
실시간사용자를추적할때사용자구분을 JSESSION 쿠키값으로합니다. 1.1.5.4. trace_user_cookie_limit 2048 사용자구분을쿠키로하는경우새로운사용자가접속하면 UUID 를쿠키로지정하여사용자를구분합니다. 그런데기존의쿠키가너무많은경우쿠키오버플로어가날수있다. 이것을피하기위해 limit 를지정합니다. 1.1.5.5. user_header_ticket_enabled false 사용자아이디를 http 헤더의특정값으로구분하고싶을때사용합니다. 모바일에서접속할때전달되는경우가많다. 1.1.5.6. user_header_ticket 사용자아이디를 http 헤더의특정값으로구분하고싶을때사용하는키명칭을지정합니다. 설정시, user_header_ticker_enabled 가 true 로설정된것으로간주됩니다. Realtime User 를 count 하기위한정보로사용됩니다. trace_user_using_ip 와배타적설정으로동시에적용할수없다. 1.1.5.7. trace_http_client_ip_header_key 사용자의실제접속아이피가 header 에별도로전달되는경우해당 header key 를지정합니다.
Client IP 를특정하기위한정보로활용됩니다. 취득된값으로 remote address 를대체합니다 1.1.6. 트랜잭션추적옵션 1.1.6.1. trace_auto_transaction_enabled false 프로파일링 ( 메소드스텝 ) 메소드에서트랜잭션이시작되지않았다면무시되는데이때자동으로트랜잭션을시작시키도록함. 프로덕션보다는주로개발환경에서백그라운드트랜잭션의 END POINT 를찾아낼때사용합니다. 1.1.6.2. trace_auto_transaction_backstack_enabled true trace_auto_transaction_enabled=true 상태에서자동으로정의된트랜잭션의시작지점에서스택을남김으로진입점이어디인지를추적하고자할때사용합니다. 1.1.6.3. trace_background_socket_enabled true 소켓 (TCP) 연결이오픈될때트랜잭션이시작된상황에서만오픈을추적하는데트랜잭션이아닌백그라운드쓰레드에의한소켓이오픈될때도추적한다 1.1.6.4. trace_transaction_name_header_key null
트랜잭션의이름을 header 에서전달되는값을 URL 에추가한다 1.1.6.5. trace_transaction_name_key null 트랜잭션의이름을 http request parameter 의값을 URL 에추가합니다. 1.1.6.6. trace_error_callstack_depth 50 트랜잭션에서에러의콜스택을수집할때지정한라인수 (default 50) 라인만수집합니다. (Error 통계에서확인 ) 1.1.6.7. trace_active_callstack_depth 50 액티브스택의수집되는콜스택최대라인수를지정합니다 1.1.6.8. trace_active_transaction_yellow_time 3000 액티브트랜잭션의아크이퀄라이저에서노란색구간의응답기준 1.1.6.9. trace_active_transaction_red_time 8000 액티브트랜잭션의아크이퀄라이저에서빨간색구간의응답기준 1.1.6.10. trace_intertx_enabled
false 멀티티어트랜잭션을연결추적하는기능을활성화합니다. 1.1.6.11. trace_dbc_leak_enabled false DBConnection Leak 을추적하는기능을활성화합니다. Connection Wrapper 를통해서 Leak 을추적하기때문에일부 WAS(ex 웹로직 ) 에서는미리테스트후적용해야합니다. 1.1.6.12. trace_dbc_leak_fullstack_enabled false DB Connection 를사용후반환하지않는트랜잭션의경우 Connection Leak 위치를확인하기위해서 Fullstack 이필요할수있다. 부분적인 CPU 사용량이몇 % 정도증가할수있음으로 CPU 사용량이높은시스템에서는 Peak 타임을피해서활성화하는것을권고합니다. 1.1.6.13. trace_httpc_normalize_urls 트랜잭션이외부 HTTP 호출하는 URL 을정규화합니다. 호출 URL 패턴을파싱하여패스파라미터를제거합니다. ex) /a/{v}/b 라고선언하면 a/123/b => a/{v}/b 로치환한다 여러개를등록할때는콤마 (,) 를사용합니다. 1.1.6.14. trace_httpc_normalize_enabled true
HTTP Call URL 을파싱하여정규화하는기능을활성화합니다. 1.1.6.15. trace_normalize_urls 트랜잭션 URL 을파싱하여정규화합니다. 호출 URL 패턴을파싱하여패스파라미터를제거합니다. ex) /a/{v}/b 라고선언하면 a/123/b => a/{v}/b 로치환한다 여러개를등록할때는콤마 (,) 를사용합니다. 1.1.6.16. trace_normalize_enabled true 트랜잭션 URL 을파싱하여정규화하는기능을활성화합니다. False 로변경시패스파라미터파싱이비활성화됩니다. 다만이경우통계데이터의의미가약화됨으로디버그용도로만잠시사용하는것이좋습니다. 1.1.6.17. trace_auto_normalize_enabled true 트랜잭션 URL 정규화할때패턴값을어노테이션에서추출하여자동으로파싱하는기능을활성화합니다. 1.1.6.18. trace_sql_normalize_enabled true SQL 문에서리터럴부분을축출하여 SQL 문을정규화하는기능을활성화합니다.
1.1.6.19. web_static_content_extensions js, htm, html, gif, png, jpg, css, swf, ico 스태틱컨텐츠를판단하는확장자를설정합니다. 여기에설정된확장자를가진트랜잭션들은프로파일추적과카운팅이제외됩니다. 1.1.6.20. profile_error_jdbc_fetch_max 10000 SQL 수행후패치건수가여기서지정한값을초과하면 TOO MANY 조회에러로처리됩니다. 1.1.6.21. profile_error_sql_time_max 30000 SQL 수행후수행시간이여기서지정한값을초과하면 TOO SLOW 에러로처리됩니다. 1.1.6.22. prepared_sql_max 7001 attach 나 watcher 방식으로추적할때 PreparedStatement 에서수행되는 SQL 을캐싱하는데캐시의크기이다. javaagent 방식에서는설치시사용되지않습니다. 1.1.6.23. mtrace_rate 100
type:% 최초트랜잭션이발생할때발급받는 MTID(Multi Transaction ID) 의발급비율을설정하는옵션이다. MTID 를추적하면등록된모든애플리케이션간의호출을확인할수있습니다. 같은프로젝트에속한애플리케이션은 Caller & Callee 기능을통해트랜잭션의프로파일을바로확인가능합니다. 1.1.6.24. recursive_max 1000000 unit: count 트랜잭션의재귀호출여부검출을위한옵션으로, 단일트랜잭션으로부터파생되는재귀호출횟수를카운트하여이벤트알림을발행하기위한기준을지정합니다. HTTP URL 재귀호출을대상으로함 jsp:forward 를통해재호출되는케이스도카운트에포함됨 1.1.7. 로그옵션 1.1.7.1. log_datasource_lookup_enabled true InitialContext Lookup 시에 DataSource 라 Lookup 되면로깅합니다. 1.1.7.2. log_rotation_enabled true 에이전트로그파일을매일변경합니다. 1.1.7.3. log_keep_days
7 로그파일보관기간을설정합니다. 1.1.8. 바이트코드 INSTRUMENTATION 옵션 1.1.8.1. hook_connection_open_patterns Connection Open 시호출되는메소드를등록합니다. 미리지정되지않는 Connection Pool 의 getconnection 을등록하는것이일반적입니다. ex) hook_connection_open_patterns=mypool.conpool.getconnection 1.1.8.2. hook_method_patterns 특정메소드의응답시간을측정하고싶을때사용합니다. 마지막 (.) 가구분자이며, 그앞쪽은클래스뒤쪽은메소드입니다. ex) hook_method_patterns=a.b.c1.* 1.1.8.3. hook_method_ignore_prefixes get,set 메소드프로파일을설정할때지정한문자열로시작하는메소드들은응답을추적하지않습니다. 1.1.8.4. hook_method_ignore_classes 메소드프로파일을설정할때배제하고싶은클래스들을설정합니다.
1.1.8.5. hook_method_access_public_enabled true 메소드프로파일을설정할때 public 메소드에대해서만별도로대상으로할지를결정합니다. 1.1.8.6. hook_method_access_private_enabled false 메소드프로파일을설정할때 private 메소드에대해서만별도로대상으로할지를결정합니다. 1.1.8.7. hook_method_access_protected_enabled true 메소드프로파일을설정할때 protected 메소드에대해서만별도로대상으로할지를결정합니다. 1.1.8.8. hook_method_access_none_enabled true 메소드프로파일을설정할때 no access indicated 메소드에대해서만별도로대상으로할지를결정합니다. 1.1.8.9. hook_service_access_public_enabled true
Non Http Demon 프로세스의트랜잭션을지정할때 public 메소드에 대해서만 Access 권한을기준으로 on/off 를지정합니다 1.1.8.10. hook_service_access_private_enabled true Non Http Demon 프로세스의트랜잭션을지정할때 private 메소드에대해서만 Access 권한을기준으로 on/off 를지정합니다 1.1.8.11. hook_service_access_protected_enabled true Non Http Demon 프로세스의트랜잭션을지정할때 protected 메소드에대해서만 Access 권한을기준으로 on/off 를지정합니다 1.1.8.12. hook_service_access_none_enabled true Non Http Demon 프로세스의트랜잭션을지정할때 no access indicated 메소드에대해서만 Access 권한을기준으로 on/off 를지정합니다 1.1.8.13. hook_serivce_ignore_methods Non Http Demon 프로세스의트랜잭션을지정할때제외할메소드이름을지정한다, 콤마 (,) 구분자를사용하여멀티로지정합니다. example: hook_serivce_ignore_methods=run,start 1.1.8.14. hook_service_patterns
NON HTTP 트랜잭션의 END POINT 를지정합니다. 1.1.8.15. hook_httpservlet_classes HTTP 트랜잭션의 END POINT 를추가로지정한다메소드의첫번째 2 개의파라미터는 HttpServletRequest 와 HttpServletResponse 만지정가능합니다. 1.1.8.16. hook_httpc_patterns HTTP Call 을수행하는클래스를지정합니다. 1.1.8.17. hook_future_classes java.util.concurrent.future 인터페이스를 implment 한클래스를설정하여비동기클래스를추적하고자할때활용합니다. full package class 명을컴마 (,) 구분자를사용하여복수의클래스를지정할수있습니다. 1.1.8.18. hook_future_prefix java.util.concurrent.future 인터페이스를 implment 한클래스를설정하여비동기클래스를추적하고자할때활용합니다. full package class 명의 prefix 를지정하며, 컴마 (,) 구분자를사용하여복수의 prefix 를지정할수있습니다.
1.1.8.19. hook_runnable_classes java.lang.runnable 인터페이스를 implment 한클래스를설정하여비동기클래스를추적하고자할때활용합니다. full package class 명을컴마 (,) 구분자를사용하여수의클래스를지정할수있습니다. 1.1.8.20. hook_runnable_prefix java.lang.runnable 인터페이스를 implment 한클래스를설정하여비동기클래스를추적하고자할때활용합니다. full package class 명의 prefix 를지정하며, 컴마 (,) 구분자를사용하여복수의 prefix 를지정할수있습니다. 1.1.8.21. hook_jdbc_pstmt_classes example : oracle.jdbc.driver.oraclepreparedstatement 미등록되었던 jdbc PreparedStatement 클래스를설정합니다. 주의할점은생성자파라미터에 SQL 문자열이전달되는구조여야합니다. ex) Derby : org.apache.derby.impl.jdbc.embedpreparedstatement 1.1.8.22. hook_jdbc_stmt_classes 미등록되었던 JDBC Statement 클래스를설정합니다. ex) Derby : org.apache.derby.impl.jdbc.embedstatement 1.1.8.23. hook_jdbc_rs_classes
미등록되었던 JDBC ResultSet 클래스를설정합니다. ex) Derby : org.apache.derby.impl.jdbc.embedresultset 1.1.8.24. hook_jdbc_wrapping_driver_patterns DB2 드라이버처럼난독처리된 JDBC 드라이버는 hook_jdbc_xxx 옵션으로직접 BCI 가어렵다이런경우 Wrapper 방식으로 SQL 추적할수있는데이때 Driver.connect 를지정하여추적하게됩니다. 1.1.8.25. hook_jsp_patterns org.apache.jasper.servlet.jspservlet.servicejspfile ( 자동추가 ) JSP 파일을로딩하는메소드를지정합니다. 트랜잭션호출결과로반환되는 JSP 정보를프로파일에표시합니다. 본옵션을통해추가한설정에 default 설정이자동으로추가됩니다. 1.1.8.26. hook_trace_helper_patterns 메소드실행및종료부분에서프로파일플러그인을삽입할포인트 ( 클래스및메소드명 ) 를지정합니다 * plugin 을활용한커스터마이즈된 profile 정보수집을위한용도로하기 plugin 코드가주입됩니다. - $WHATAP_HOME/plugin/TraceHelperStart.x - $WHATAP_HOME/plugin/TraceHelperEnd.x 1.1.8.27. hook_trace_helper_end_patterns
메소드종료부분에서프로파일플러그인을삽입할포인트 ( 클래스및메소드명 ) 를지정합니다. *plugin 을활용한커스터마이즈된 profile 정보수집을위한용도로하기 plugin 코드가주입됩니다. - $WHATAP_HOME/plugin/TraceHelperEnd.x 1.1.8.28. hook_trace_helper_start_patterns 메소드시작부분에서프로파일플러그인을삽입할포인트 ( 클래스및메소드명 ) 를지정합니다. * plugin 을활용한커스터마이즈된 profile 정보수집을위한용도로하기 plugin 코드가주입됩니다. - $WHATAP_HOME/plugin/TraceHelperStart.x 1.1.8.29. hook_direct_patch_classes 직접적으로특정클래스를로딩타임에바꿔치기하고자할때사용합니다. 클래스를컴파일한후에별도파일로만들고그파일의풀패스를설정합니다. 1.1.9. 운영설정 1.1.9.1. active_stack_second 10
액티브스택을추적하는간격을설정합니다. ( 주의 : 값을바꾸는것을 권장하지않습니다.) 1.1.9.2. boot_redefine_size 100 Attach 방식이나 Watcher 방식으로설치했을때이미로딩된클래스중에추적을위해 BCI 를새로수행하게됩니다. 이때동시 redefine 하는클래스수 1.1.9.3. counter_procfd_enabled false 파일디스크립트수를추적하는기능을활성화합니다. 1.1.9.4. counter_netstat_enabled false NET STAT 상태별건수를모니터링합니다. ESTABLISH, CLOSE WAIT FIN WAIT 등상태별건수를수집합니다. 1.1.9.5. realtime_user_thinktime_max 300000 실시간사용자를측정할때사용자로인정되는호출간격을지정합니다. 1.1.9.6. time_sync_interval_ms 300000
에이전트는이옵션에서지정한시간에한번씩서버와통신하면서시간을 맞춘다. 1.1.9.7. detect_deadlock_enabled false 실행중인쓰레드간 deadlock 이있는지를확인하고이벤트를발생합니다. deadlock 발생여부는 5 초마다체크하지만 deadlock 이벤트는한시간에한번만발생시킨다. 1.1.9.8. text_reset 0 에이전트는한번보낸텍스트는다음날까지는재전송하지않는다. 그런데즉시재전송하고자할때 text_reset 값을임으로지정하면전송기록이리셋되어다시텍스트가전송됩니다. 이전값과다른 int 값을설정하면됩니다. 1.1.9.9. auto_oname_enabled false 에이전트이름 (oname) 을서버로부터자동부여받는기능을활성화합니다. 적용시, -Dwhatap.name, -Dwhatap.oname 옵션은무시됩니다. 수집서버와의통신을통해 oname 을부여받은이후, 에이전트의일반적인동작을개시합니다. 1.1.9.10. auto_oname_prefix agent
에이전트이름을서버로부터자동부여할때에이전트이름의 prefix 보통 업무명을사용합니다. prefix 일련번호 1~) 부여됩니다. 1.1.9.11. auto_oname_reset 0 에이전트이름을자동부여하면 what.oname 이라는시스템환경변수에셋트됩니다. 한번셋트되면자바인스턴스가재기동될때까지유지되는데리셋을원할때 auto_oname_reset 값을수정합니다. * 현재설정값과다른값으로변경하면적용됩니다. 1.1.10. 알림설정옵션 1.1.10.1. 재귀적으로 forward 되는요청에대한경고알림설정 재귀적으로 forward 되는요청에대한경고알림설정트랜잭션의재귀호출여부검출을위한옵션으로, 단일트랜잭션으로부터파생되는재귀호출횟수를카운트하여이벤트알림을발행하기위한기준을지정합니다. HTTP URL 재귀호출을대상으로함 jsp:forward 를통해재호출되는케이스도카운트에포함됩니다. recursive_max = 1000000 (default) 재귀호출카운트임계치 recursive_event_interval = 30000 (default) 이벤트알림발행간격 1.1.10.2. 서비스거절 ( 호출부하제한 / 거절 )) 시 경고
사용자요청이 block 될때이벤트알림발행여부와간격을지정합니다. reject_event_enabled = false (default) 활성화여부 reject_event_interval = 30000 (default) 이벤트알림발행간격 1.1.10.3. 외부 API 호출에서에러발생시경고 외부 API 호출시에러가발생할경우이벤트알림발행여부와간격을지정함 httpc_event_enabled = false (default) 활성화여부 httpc_event_interval = 30000 (default) 이벤트알림발행간격 1.1.10.4. 힙사용량경고 힙사용량임계도달시이벤트알림발행여부와간격을지정합니다. heap_event_enabled = false (default) 활성화여부 heap_event_percent = 90 (default) 임계치 (%) heap_event_duration = 30000 (default) 임계치 ( 지속시간밀리초 ) heap_event_interval = 300000 (default) 이벤트알림발행간격 heap_event_action = 이벤트발생시실행할동적로딩코드 ($WHATAP_HOME/plugin/ActionScript.x 에작성한 Java 코드 ) 에전달할 ID ($id 로전달됨 ) 1.1.10.5. 디스크사용량경고 디스크사용량임계도달시이벤트알림발행여부와간격을지정합니다. disk_event_enabled = false (default) 활성화여부 disk_event_percent = 90 (default) 임계치 (%) disk_event_interval = 3600000 (default) 이벤트알림발행간격
disk_event_action = 이벤트발생시실행할동적로딩 코드 ($WHATAP_HOME/plugin/ActionScript.x 에작성한 Java 코드 ) 에 전달할 ID ($id 로전달됨 ) 1.1.10.6. CPU 사용량경고 CPU 사용량임계도달시이벤트알림발행여부와간격을지정합니다. cpu_event_enabled = false (default) 활성화여부 cpu_event_percent = 90 (default) 임계치 (%) cpu_event_duration = 10000 (default) 임계치 ( 지속시간밀리초 ) cpu_event_interval = 300000 (default) 이벤트알림발행간격 cpu_event_action = 이벤트발생시실행할동적로딩코드 ($WHATAP_HOME/plugin/ActionScript.x 에작성한 Java 코드 ) 에전달할 ID ($id 로전달됨 ) 1.1.10.7. DB Connection 중복할당경고 DB Connection 이중복할당되었을때이벤트알림발행여부와간격을지정합니다. dbc_dup_event_enabled = false (default) 활성화여부 dbc_dup_event_fullstack_enabled = false (default) 중복할당될때 Stack 확보여부를지정합니다. 1.1.10.8. Exception 발생시경고 Exception 발생시이벤트알림발행여부와간격을지정합니다. exception_event_enabled = false (default) 활성화여부 exception_event_interval = 60000 (default) 이벤트알림발행간격 exception_event_set = Exception 을지정합니다. Exception Set 을지정할경우 ',' 로구분자를사용합니다.
exception_event_action = 이벤트발생시실행할동적로딩코드 ($WHATAP_HOME/plugin/ActionScript.x 에작성한 Java 코드 ) 에전달할 ID ($id 로전달됨 ) 1.1.11. 에이전트명명옵션 1.1.11.1. priority 1. [Configuration] auto_oname_enabled 2. [JVM Option] -Dwhatap.name 3. [JVM Option] -Dwhatap.oname 1.1.11.2. JVM Options Only 와탭의에이전트식별자 (oname) 는 whatap.name ( 조합패턴 ) + port, ip 로 구성됩니다. 1.1.11.3. -Dwhatap.name whatap.conf 에 auto_oname_enabled 가설정되어있지않은경우적용됩니다. pattern 으로지정시 port 및 ip 를조합합니다. 조합에사용가능한옵션 parenthesis - {type}, {ip0}, {ip1}, {ip2}, {ip3}, {port}, {cmdn} 패턴으로지정하지않고고정값으로설정하는경우, 지정값으로에이전트가식별됩니다. 패턴옵션설명비고
type ipn port pid cmdn 애플리케이션서버유형 ip address 의 N 번째자리 애플리케이션서비스포트 애플리케이션프로세스 ID Java 명령을통해전달된 N 번째파라미터 TC:Tomcat SB:SpringBoot JB:JBoss WL:WebLogic WS:Websphere JU:Jeus JT:Jetty AP:Application 애플리케이션서버포트식별불가시활용 애플리케이션서버가파라미터를전달받는경우에사용가능 1.1.11.4. -Dwhatap.oname whatap.conf 에 auto_oname_enabled 가설정되어있지않고, Dwhatap.name 미지정시 -Dwhatap.oname 에지정한값이 oname, 즉애플리케이션의식별값으로적용됩니다. 1.1.11.5. 예외적옵션 1.1.11.5.1. object_name whatap.conf 에설정, -Dwhatap.name 과동일한옵션을설정파일에지정하기위한옵션으로 -Dwhatap.name 과동일하게 pattern 을지정할수있습니다. 전제사항 : 1 application server per 1 VM 사용상황 : VM 복제
1.1.12. 부록 1.1.12.1. 데이터베이스관련이슈추적옵션 1.1.12.2. tomcat_ds_enabled / weblogic_ds_enabled - JMX 를통한 datasource pool 정보를수집 1.1.12.3. dbcp_pool_enabled / hikari_pool_enabled - datasource 에접근하여 pool 정보를수집 1.1.12.4. profile_dbc_close - DB 접속 close 시 profile 에스텝노출 1.1.12.5. trace_dbc_leak_enabled - DB connection leak 추적활성화 (staistics > error 에노출 ) 1.1.12.6. trace_dbc_leak_fullstack_enabled - DB connection leak 발생시호출스택수집활성화 (staistics > error 에 노출 ) 1.1.12.7. 에이전트설정분리옵션 1.1.12.8. -Dwhatap.config
2 개이상의애플리케이션서버가동일호스트에탑재되어있고, 와탭에이전트를단일경로에설치하여운영하는경우, 필요에따라에이전트 configuration 을상이하게적용해야할경우가발생합니다. 이와같은경우, -Dwhatap.config 설정을통해와탭설정파일의경로를지정할수있습니다. ex) 와탭에이전트설치경로내에설정파일만추가로위치시키는경우 - -Dwhatap.config=whatap.conf2 절대경로는사용불가하며, 와탭설치경로로부터상대경로상의파일을참조합니다.
Thank you support@whatap.io ( 주 ) 와탭랩스 www.whatap.io 서울특별시강남구테헤란로 69 길 5 유기타워 11F (06160) Tel. 02.565.1803 Fax. 0504.848.1803