Release Notes WhaTap Support support@whatap.io 2020-02-22 1.0.1
본 문서는 WhaTap Release Notes 입니다.
Service Release Notes
Service 1.12.0
1.12.0
2020-02-05
공통
대시보드 탬플릿 모달에서 프로젝트 목록 선택 시 프로덕트 타입에 맞는 목록만 나타나도록 수정
태그 대시보드 바차트 기능 제거
프로젝트 목록 파이어폭스에서 스타일 깨짐 현상 수정
통합대시보드 이퀄라이저 차트에서 위젯 사이즈에 따라 일부 데이터가 영역을 벗어나 표시되지 않는 버그를 수정
태그 대시보드 위젯에 지표 추가 시 미동작 버그 수정 [1.10.0에 기 반영]
태그 대시보드 기존 위젯 수정 시에 문제 발생 버그 수정
태그 대시보드 시리즈 차트 옵션 설정 문제 버그 수정
애플리케이션
탑스택 특정 스택을 기준으로 호출, 피호출 스택 파악이 가능한 기능을 추가 (다이어그램 표시상태에서만 사용 가능) [1.10.0에 기 반영]
PHP 에이전트 프로젝트 대시보드 에 액티브 스테이터스 위젯 추가
탑스택/유니크스택 하단 스택 비율 차트를 제거
태그 카운트 조회 조회 방식 수정
Service 1.10.0
1.10.0
2020-01-23
고객 요청 사항
알림 기록 CSV파일 다운로드 기능 추가
SQL 통계 최소 시간 항목 추가
통합대시보드 위젯에서 차트 유형 추가 (이퀄라이저 차트, 시리즈 텍스트 차트)
공통
계정 사용량 확인 기능 추가
통합대시보드 위젯 추가 시, 프로젝트 항목 중 제한 상태의 프로젝트는 나타나지 않도록 기능 수정
회원가입 절차 개선 및 간소화
프로젝트 목록 화면 스타일 개선 및 신규 프로젝트 생성 후 안내 기능 개선
에이전트 설치 화면 스타일 개선
통합대시보드 시리즈 비교 위젯이 자정 이후 차트 나오지 않은 버그 수정
애플리케이션
트랜잭션 프로파일 에러 발생 스텝에 에러 마크 추가
트랜잭션 프로파일 요약 태그를 클릭하여 태그 성능 지표 조회 연계 기능 추가
에이전트 업데이트 에이전트 별칭 노출
python 대시보드 액티브 스테이터스 차트 추가
알림 기록 CSV파일 다운로드 기능 추가
SQL 통계 최소 시간 항목 추가
성능지표 카운트 차트 액티브 스테이터스 지표 항목 추가
에이전트 설정 도움말 닫기 기능 추가
트랜잭션 검색 트랜잭션 ID로 검색 가능하도록 기능 개선
트랜잭션 프로파일 SQL문 1,000건 이상인 경우 성능 개선
트랜잭션 프로파일 ID 클릭 시 태그카운트 데이터 조회 화면으로 이동할 수 있도록 개선
액티브 트랜잭션 목록 조회한 상태에서 상세 내용 리프레쉬가 가능하도록 기능 개선
에이전트 설정 설정 항목이 없는 경우, 신규 설정이 추가되지 않는 버그 수정
에이전트 설정 설정 입력 시, html tag가 삽입되는 버그 수정
액티브 스택 차트 시간축이 반대 방향으로 표시되는 버그 수정
멀티 서버 트랜잭션 테이블 표시 시, 호출 순으로 정렬되지 않는 버그 수정
멀티 서버 트랜잭션 차트가 화면 전체 영역으로 표시되지 않는 버그 수정
Service 1.8.0
1.8.0
2019-12-27
공통
사이트맵 메뉴 이름 마우스 호버 시 메뉴 설명 기능 추가
상단 계정 메뉴 그룹에 과금 관리 메뉴 링크 추가
프로젝트 대시보드 화면 Safari 브라우저 스타일 개선
프로젝트 목록의 리스트뷰 모드 중 컨테이너 프로젝트에서 수집 중인 주요 지표를 표시하도록 개선
일부 화면에서 상단 문의하기 기능이 작동하지 않는 현상을 수정
애플리케이션
에이전트 목록 쓰레드 목록/덤프 에서 쓰레드 조회 새로고침 기능 추가
프로젝트 대시보드 내 액티브트랜잭션 차트를 클릭하여 조회한 애플리케이션 선택 사항을 새로고침 후에도 유지하도록 개선
트랜잭션 프로파일 화면 크기에 맞게 프로파일 다이어그램 차트 크기 갱신
트랜잭션 프로파일 내 통계 링크 클릭 시 트랜잭션 시작 시간 기준 해당일의 동일 서비스(URL) 트랜잭션 통계 분석 화면 제공
Chrome 최신 버전(79.0+)에서 트랜잭션 프로파일이 나타나지 않는 현상을 수정
트랜잭션 검색 에서 타 메뉴 이동 후 애플리케이션 선택 시 전체 선택 범위에서 변경되지 않는 현상을 수정
성능 추이 에서 액티브 트랜잭션 차트의 지표 단위가 byte로 표시되는 버그를 수정
에이전트 목록 쓰로틀링 설정 에서 후보 URL 검색시 편집 중인 쓰로틀링 설정 내용이 사라지는 버그 수정
에이전트 목록 쓰레드 목록 에서 상세화면 조회시 리프레시 버튼이 없는 문제 수정
Service 1.6.0
1.6.8
2019-12-11
애플리케이션 모니터링
1.6.7
2019-12-04
공통
계정 수정
-
계정 수정 페이지에 결제 정보 입력 페이지가 추가되었습니다.
계좌이체를 통한 결제 수단을 선택할 경우 본 화면을 통해 결제 정보를 입력하실 수 있습니다.
신용카드 결제의 경우 기존과 동일하게 링크를 통해 전환되는 페이지를 통해 등록하실 수 있습니다.
Figure 12. Edit Account Menu프로젝트의 소유 권한이 있는 계정의 경우, 계정 정보 수정 화면에서 결제 정보를 입력할 수 있습니다.
Figure 13. Payment Info in Account Info유상전환 목록 화면에서 프로젝트의 유상전환 상태 정보를 확인할 수 있으며, 유상 전환 및 구매 이력을 확인 할 수 있습니다.
Figure 14. Projects Subscription지불 현황 페이지를 통해 청구서 및 청구금액, 지불 내역 현황을 확인할 수 있습니다.
Figure 15. Payment Status청구서 미리보기 화면을 통해 해당월 1일 ~ 현시점 까지의 청구금액 산출 내역을 활인할 수 있습니다.
Figure 16. Invoice Preview
프로파일 상세
-
프로파일 상세 화면에 대한 UI 및 스타일을 대폭 개선하였습니다.
-
가로와 세로길이를 최대한으로 넓혀 내용을 보는데 최대한 사용할 수 있도록 변경하였습니다.
-
기본 표기 데이터 중 시작시간 지표대신 IP주소로 변경되었습니다.(아래 테이블에서 맨 위에있는 데이터가 시작시간으로 함께 볼 수 있어서)
-
멀티 트랜잭션을 여는 버튼이 멀티 트랜잭션 차트의 오른쪽 버튼으로 이동하였습니다.
-
멀티 트랜잭션이 있는 경우 가볍게 연관목록을 파악할 수 있는 테이블이 추가되었습니다.
-
스크롤이 범위를 초과하여 여러개의 스크롤이 생기는 현상을 개선했습니다.
-
구형 에이전트와 하위호환성을 향상시켰습니다.
-
모바일 버전에서의 반응형페이지 전환을 지원하여 화면깨짐 없이 보실수 있습니다.
Figure 17. Profile Detail V2
1.6.6
2019-11-27
1.6.5
2019-11-20
공통
1.6.4
2019-11-13
애플리케이션
사용자 권한 제어
사용자 권한의 유저에 대하여 다음 기능이 제한되었습니다.
-
대상 화면 - 애플리케이션 에이전트 목록 및 애플리케이션(사이트맵) 하위 메뉴
-
버튼 - 에이전트 기능 실행, 에이전트 옵션 변경을 위한 버튼이 표시되지 않습니다.
-
입력 - 옵션 설정을 위한 입력창 대신 문자열이 표시됩니다.
Figure 32. Button is hidden for User
비활성 애플리케이션 표시
애플리케이션이 중지 되었거나, 수집 서버와 통신이 불가한 애플리케이션을 표시할 수 있도록 기능을 보완하였습니다.
-
비활성 애플리케이션의 상태가 (기본) 1일 이상 지속될 경우 에이전트 조회 대상에서 제외됩니다.
-
비활성 애플리케이션 삭제 또는 유지 기간 변경은 [에이전트 설정 > 설정] "inactive_oid_keep_time" 항목을 통해 수정이 가능합니다.
-
기능을 활성화하기 위해 아래 모양의 아이콘을 클릭합니다.
Figure 33. 비활성 애플리케이션 표시 -
아크이퀄라이져 차트 유형
Figure 34. Show inactive application -
막대 차트 유형
Figure 35. Show inactive application
1.6.3
2019-11-06
공통
1.6.2
2019-10-30
애플리케이션 모니터링
플렉서블 모달
-
리사이징(우측 하단 꺽쇄를 드래그하여 사이즈 조절), 이동(검정색 타이틀 부분을 드래그하여 이동) 가능한 모달의 기능을 추가하였습니다.
-
프로파일 상세의 세부 모달 전부와 에이전트 목록의 시그니처 클래스 모달에서 만나보실 수 있습니다.
Figure 40. DashboardDetailSubModal
Figure 41. ClassSignitureModal
1.6.0
2019-10-16
사이트 맵
광범위한 모니터링 기능 중 활용성이 높은 기능과 활용성이 낮은 기능을 구분하여 사용자 편의성을 제공하고자 사용성이 높은 기능은 기존의 좌측 메뉴에 노출하고, 전체 메뉴는 사이트맵을 통해 접근이 가능하도록 개편하였습니다.
기본 구성으로 좌측 메뉴는 다음과 같이 분류됩니다.
-
대시보드 - 실시간 대시보드를 제공하는 메뉴로 구성됩니다.
-
분석 - 상세 분석을 위한 메뉴로 구성됩니다.
-
통계/리포트 - 통계 및 리포팅 기능을 위한 과거 데이터 조회 용도의 메뉴를 제공합니다.
-
성능 태그 데이터 - 태그 기반의 카운트 정보를 기반으로 하는 데이터 조회, 대시보드, 알림 설정 등의 메뉴로 구성됩니다.
-
경고 알림 - 알림 설정을 위한 알림 조건 설정, 알림 수신 설정, 알림 이력 메뉴를 제공합니다.
-
관리 - 프로젝트 관리 및 사용자 초대, 에이전트 목록 확인 및 옵션 변경, 알림 억제를 위한 정비 계획 등의 기능을 제공합니다.
-
빌링 링크 - 프로젝트의 유상 전환을 위한 빌링 시스템에의 링크를 제공합니다.
-
사이트맵 - 간략화 된 메뉴에 대해, 기존에 사용하던 기능의 메뉴 및 전체 메뉴에 대한 목록 및 간략한 안내를 제공하기 위한 메뉴를 제공합니다.
Application Monitoring Site Map
주요 변경 사항
-
다수의 고객으로부터 공통적으로 자주 사용되지 않는 기능은 사이트맵을 통해서만 제공됩니다.
-
실시간 모니터링과 관련한 메뉴는 대시보드 하위로 이동되었습니다.
-
스택, 큐브 메뉴가 분석 하위로 이동되었습니다.
-
로그인 트랜잭션, 트랜잭션 리퍼러 메뉴는 사이트맵을 통해서만 제공합니다.
-
서버 메뉴 명칭이 애플리케이션 에이전트로 변경되었으며, 관리 메뉴 하위로 이동되었습니다.
-
에이전트 설치 및 업데이트 메뉴가 관리 메뉴 하위로 이동되었습니다.
Server Monitoring Site Map
주요 변경 사항
-
실시간 모니터링과 관련한 메뉴는 대시보드 하위로 이동되었습니다.
-
에이전트 설치 메뉴가 관리 메뉴 하위로 이동되었습니다.
Database Monitoring Site Map
주요 변경 사항
-
다수의 고객으로부터 공통적으로 자주 사용되지 않는 기능은 사이트맵을 통해서만 제공됩니다.
-
실시간 모니터링과 관련한 메뉴는 대시보드 하위로 이동되었습니다.
-
분석 용도로 활용되는 기능을 분석 메뉴 하위로 이동하였습니다. (락 트리, 병렬 쿼리 트리, 데드락, 주간/월간 카운트, 데이터베이스 파라메타)
-
직관적이지 않은 일부 메뉴의 명칭을 변경하였습니다. (지표 추이, 지표 장기 추이, 지표 추이 비교)
-
테이블 스페이스 용량 증감, SGA 용량 증감 메뉴는 사이트맵을 통해서만 제공됩니다.
-
에이전트 설치, 에이전트 목록, 스크립트 실행 메뉴가 관리 메뉴 하위로 이동되었습니다.
Container Monitoring Site Map
주요 변경 사항
-
다수의 고객으로부터 공통적으로 자주 사용되지 않는 기능은 사이트맵을 통해서만 제공됩니다.
-
너무 많은 메뉴들로 인해 메뉴 단계를 조정하였습니다.
-
쿠버네티스 마스터 메뉴를 마스터 메타 정보로 변경하였습니다.
-
구성 토폴로지 메뉴를 마스터 메타 토폴로지로 변경하였습니다.
-
로그인 트랜잭션, 트랜잭션 리퍼러 메뉴는 사이트맵을 통해서만 제공합니다.
-
에이전트 설치 및 목록 메뉴를 관리 메뉴가 관리 메뉴 하위로 이동되었습니다.
URL Monitoring Site Map
주요 변경 사항
-
다수의 고객으로부터 공통적으로 자주 사용되지 않는 기능은 사이트맵을 통해서만 제공됩니다.
Service 1.5.0
1.5.9
2019-10-09
1.5.7
2019-09-18
1.5.6
2019-09-11
애플리케이션 모니터링
프로젝트 대시보드 > 액티브 트랜잭션 모달
-
프로젝트 대시보드의 원형 액티브 트랜잭션 차트를 클릭하면 액티브 트랜잭션 모달이 나타납니다.
-
차트에서 선택한 에이전트를 조회하며 조금 더 간편하게 액티브 트랜잭션을 조회합니다.
-
새 창 열기를 통해 모달이 아닌 페이지로 전환하여 데이터를 더 크게 보실 수 있습니다.
-
액티브 트랜잭션 모달은 아래 형태로 이루어져 있습니다.
Figure 65. Active Transaction Modal
-
토폴로지 > 애플리케이션, 그룹, 인스턴스, Integration > 통합 토폴로지
-
평균응답시간, 에러 건수 기반 강조 기능이 추가되었습니다.
Figure 66. Emphasis Rule -
화면 상단의 응답시간(밀리초) 지정을 통해 호출 관계의 평균 응답 시간 임계치를 지정할 수 있습니다.
-
임계 시간을 초과한 호출의 경우, 호출 링크를 적색으로 강조하여 표시합니다.
Figure 67. Link Emphasis -
화면 상단의 에러 건수 지정을 통해 호출 관계의 에러 건수 임계치 및 피호출 노드의 에러 건수 임계치를 지정할 수 있습니다.
-
임계 에러 건수를 초과한 호출의 경우, 호출 링크를 적색으로 강조하여 표시합니다.
-
특정 노드의 피호출 에러 건수가 임계치를 초과한 경우, 노드 외곽에 적색 링을 추가하여 강조 표시합니다.
Figure 68. Node Emphasis -
노드와 호출이 모두 강조된 이미지는 아래와 같습니다.
Figure 69. Node & Link Emphasis
서버 모니터링
큐브(Beta) 메뉴 추가
-
분석 > 큐브 Beta
-
서버 분석을 위한 메트릭스셋를 제공합니다.
Figure 70. Server Cube-
기능 요약
-
제공 메트릭스셋: 요약, CPU, 메모리 디스크 네트워크
-
서버 필터링 (복수 선택 가능)
-
차트 위젯의 차트유형 선택 기능 : 개별서버-시리즈 / Top10-막대*
-
차트 레이아웃 편집 기능 : 위젯 확대/축소, 위치 변경 및 상태 저장
-
-
이용 방법
-
큐브 캘린더 선택
날짜 선택 > 큐브 구성 지표 선택 > 시간 순으로 정렬된 히트맵 차트-
용도 : 사용자의 관심 지표를 기준으로 이상 트랜잭션이 발생한 시간대을 빠르게 식별하여 상세분석 화면으로 연동하기 위한 기능.
-
사용법 : 히트맵 상의 큐브 마우스 클릭 또는 키보드 방향키 이용
-
-
애플리케이션 선택
-
애플리케이션 이름을 클릭하여 큐브 차트 상의 데이터를 필터링할 수 있습니다.
-
애플리케이션이 비활성 상태인 경우 표시된 애플리케이션 이름의 밝기가 어둡게 표시됩니다.
-
우측 핀 아이콘을 클릭하여 전체 선택/활성 애플리케이션 선택 등 부가 기능을 이용할 수 있습니다.
-
-
차트 위젯
-
차트 위젯 레이아웃 변경
-
제목을 클릭, 드래그 하여 화면 상에서 이동이 가능합니다.
-
위젯 하단 크기 변경 아이콘을 클릭, 드래그 하여 위젯크기 변경이 가능합니다.
-
-
-
-
1.5.5
2019-09-02
애플리케이션 모니터링
트랜잭션 검색 및 멀티 서버 트랜잭션 추적
-
트랜잭션 검색에서 CSV 다운로드 기능을 적용했습니다.
-
멀티 서버 트랜잭션 추적 기능이 새롭게 리뉴얼되었습니다.
-
트랜잭션 목록의 검색버튼 옆에 CSV 데이터 다운로드 버튼이 추가되었고 트랜잭션 상세내용에 간략하게 파악할 수 있는 Tree View가 추가되었습니다.
Figure 72. Transaction Search -
멀티 트랜잭션 버튼을 클릭하면 멀티 서버 트랜잭션 추적 모달이 나타납니다.
Figure 73. MSTT Modal -
테이블 뷰를 클릭하여 관련한 트랜잭션을 확인하실 수 있습니다. 또한 선택된 프로젝트 중 관련된 프로젝트를 확인 및 제외하여 리스트화 할 수 있습니다.
Figure 74. Table View -
새 창으로 열기를 클릭하여 큰 페이지로 이동하여 트랜잭션을 편리하게 확인하실 수 있습니다.
Figure 75. New Window
-
서버 모니터링
서버 목록
-
서버 목록 화면에 서버별 디스크 필터링 기능이 추가되었습니다.
-
서버목록 상단에서 아래 모양의 버튼을 클릭하여 필터링 모드로 전환합니다.
Figure 78. Server List -
서버 목록 상에 서버에 포함된 디스크 디바이스명이 표시됩니다. (아래 초록색 버튼 모양)
Figure 79. Server List Filter -
디바이스명을 클릭하여 서버 목록 상에 해당 디바이스를 숨김/표시 할 수 있습니다. 숨김 처리된 디스크 디바이스는 회색 음영 표시 및 아이콘으로 구분합니다. (오른쪽)
Figure 80. Server List Disk Filter
-
1.5.4
2019-08-26
통합 모니터링
통합 대시보드
-
통합 대시보드(V2)에 이벤트 목록 위젯을 추가하였습니다.
Figure 85. Event List
이벤트 목록 위젯 기능
-
이벤트 목록 위젯은 최근 1시간 동안 발생한 이벤트를 표시하며 15초 간격으로 업데이트됩니다.
-
이벤트는 경고 수준을 구분하여 위험도가 높은 이벤트가 상위 표시되며 이후 발생 시간 순으로 정렬합니다.
Figure 86. Widget(1)
Figure 87. Widget(2) -
그룹화한 이벤트의 경고 수준별 이벤트 개수를 표시합니다.
Figure 88. Widget(3) -
이벤트 그룹화 옵션 선택 기능입니다. 최근 1시간 동안 발생한 전체 이벤트 대상으로 선택 기준을 적용하여 그룹화하며, 해당 그룹에서 가장 최근 발생한 이벤트를 목록에 표시합니다. 마우스 호버 시 해당 그룹에 속한 전체 이벤트 내역을 확인할 수 있습니다.
이벤트제목별
이벤트 제목이란 'FATAL_HIGH_CPU’와 같이, 이벤트 규칙에 의해 부여받은 고유의 이벤트 이름을 의미합니다. 해당 설정을 적용할 경우 이벤트 제목을 기준으로 그룹화하며, 다양한 이벤트 규칙에 의해 발생한 이벤트를 모니터링하기에 용이합니다.
프로젝트별
프로젝트별 가장 최근 발생한 이벤트를 확인하기에 용이합니다.
애플리케이션
애플리케이션별 가장 최근 발생한 이벤트를 확인하기에 용이합니다. -
이벤트 목록 위젯은 15초 주기로 데이터를 조회하여 화면을 갱신합니다. 이때 그룹화한 이벤트 중에서 변경사항이 발생할 경우 아래 이미지와 같이 배경색을 칠하여 깜빡입니다.
Figure 89. Widget(4)
이벤트 목록 위젯 추가 방법은 다음과 같습니다.
-
대시보드 상단 위젯 추가 버튼을 클릭하여 위젯 생성 창을 엽니다.
Figure 90. Event List
Figure 91. Create Widget(1/4) -
위젯 유형 중 이벤트 목록 아이콘을 선택한 후 다음으로 이동합니다.
Figure 92. Create Widget(2/4) -
프로젝트 선택를 선택한 후 다음으로 이동합니다. 모든 제품 종류에 대해 복수 개의 프로젝트를 선택하여 위젯을 생성할 수 있습니다.
Figure 93. Create Widget(3/4) -
데이터 유형 단계에서 지금까지 선택한 프로젝트를 확인 한 후 완료버튼을 클릭하시면 이벤트 목록 위젯 생성이 완료됩니다.
Figure 94. Create Widget(4/4)
이벤트 ( 알림 )
MMS 다량 발송 제한
-
MMS 알림이 무의미하게 반복되는 케이스를 방지하기 위해, 프로젝트 별 일간 MMS 발송량에 따라 MMS 발송이 제한될 수 있습니다.
-
해당 기능은 사용자가 해제하기 이전까지는 MMS 재수신이 불가능 합니다.
-
[ 이벤트 > 이벤트 수신 설정 ] 페이지에서 차단 상태를 해제할 수 있습니다.
Figure 95. MMS Unblock Menu -
MMS 수신이 제한될 경우 관련 알림을 제공 받으실 수 있으십니다.
알림 메세지는 수신 설정되어있는 모든 알림에 제공됩니다.
Figure 96. MMS Block Alert
| MMS 일간 발송량을 확인할 수 있는 페이지는 추후 등록될 예정입니다. |
애플리케이션 모니터링
통계 > 클라이언트 IP
-
IP 클래스별로 보기 기능을 기존에는 차트만 토글 가능하도록 기능을 제공하였으나, IP 목록 정보도 같이 토글하여 제공하도록 개선하였습니다.
Figure 98. Country and City Count -
IP 클래스별로 보기 버튼 클릭 시, 좌측 다이어그램에 IP 클래스별 비중을 표시합니다.
Figure 99. IP Class Count Diagram -
IP 클래스별로 보기 버튼 클릭 시, 우측 테이블에 클래스별 합산 건수를 표시합니다.
클래스별 합산 건수는 화면상에 로딩된 데이터의 산술합을 제공하며, CSV 다운로드 기능에는 제공되지 않습니다. 
Figure 100. IP Class Count Table
스택 > 탑 스택
-
탑 스택 자동 펼침 기능을 복원하였습니다. 탑 스택 목록을 클릭하면 하위 스택 중 최상위 스택이 5단계 펼쳐집니다.
Figure 101. TopStack Auto Expand
히트맵 또는 트랜잭션 검색 > 트랜잭션 목록 > 트랜잭션 프로파일
-
트랜잭션 프로파일 URL 링크 복사 기능을 추가하였습니다.
사용자가 조회한 트랜잭션 프로파일 화면을 URL 링크 형태로 다른 사용자 또는 와탭 서포트와 공유할 수 있습니다.
Figure 102. Copy Link트랜잭션 프로파일은 트랜잭션이 수행되는 과정중이 스텝들을 추적하는 것입니다. 트랜잭션이 느리거나 오류가 있다면 그 원인을 추적하기 위해서 수행 이력을 스텝별로 추적할 필요가 있는데 이것을 트랜잭션 프로파일링이라고 합니다. 
Figure 103. TX Profile
프로젝트 대시보드 > 액티브 트랜잭션
-
프로젝트 대시보드의 액티브 트랜잭션의 이동이나 차트의 부채꼴을 클릭하면 액티브 트랜잭션 페이지로 이동합니다. (차트의 경우 어플리케이션이 선택되서 이동됩니다.)
Figure 104. Go Active Tx -
어플리케이션 서버 목록에서 선택하면 액티브 트랜잭션 리스트가 나옵니다.
-
트랜잭션을 선택하면, 쓰레드가 실행중인 경우에는 트랜잭션의 정보를, 종료되었다면 프로파일 정보를 찾을 수 있습니다.
Figure 105. Active Tx Select Application -
트랜잭션 정보에서는 쓰레드를 강제로 종료시킬 수 있습니다.
Figure 106. Active Tx Select Running Tx -
종료된 트랜잭션을 조회했다면, 프로파일 보기를 클릭하여 상세하게 확인할 수 있습니다.
Figure 107. Active Tx Select Ended Tx 1 -
프로파일 정보에서는 이전에 호출한 프로파일의 정보를 그대로 받을 수 있습니다.
Figure 108. Active Tx Select Ended Tx 2
1.5.3
2019-08-19
신규 기능 추가
애플리케이션 모니터링
서버 > 설정 탭
-
설정 키 검색 기능이 추가되었습니다.
Figure 110. Keyword Searching-
서버 선택 후 우측 상단 검색창에 찾고자하는 설정키를 입력하시면 해당 설정정보를 필터링하여 화면에 표시합니다.
-
설정이 완료된 설정 키 이름의 경우에는 검색 조건과 일치하는 경우 하이라이트하여 나타냅니다.
-
1.5.2
2019-08-12
신규 기능 추가
애플리케이션 모니터링
분석 > 카운터
-
차트 이미지 내보내기 기능이 추가되었습니다.
-
카운터 위젯 생성 후, 우측 상단의 이미지 내보내기 아이콘을 클릭하여 해당 위젯을 이미지 파일로 다운로드할 수 있습니다.
Figure 116. Counter Widget Capture
-
-
복수 메트릭 일괄 추가 기능이 추가되었습니다.
-
카운터 페이지 화면 상단 '카운터' 선택란에서 카운터 그룹 항목을 선택하고 검색버튼을 누르면 해당 그룹에 속한 하위 메트릭 전체가 위젯으로 생성됩니다.
Figure 117. To select counter group metrics:
-
대시보드 > 히트맵 드래그 > 트랜잭션 목록
-
에러만 선택하기 기능을 개선하였습니다.
-
기존에 에러만을 클릭했을 때, 히트맵만 바뀌고 서버 목록 및 트랜잭션 목록이 바로 바뀌지 않는 현상을 개선하였습니다.
-
에러만 클릭 시, 서버 목록에는 에러 트랜잭션이 발생한 서버 목록만을 표시하며, 트랜잭션 목록에도 바로 필터링이 적용됩니다.
-
서버 - V2 Release
-
이전 버전의 화면으로 전환 할 수 있는 기능을 추가하고, 구 버전의 메뉴를 제거하였습니다.
Figure 120. Server -
서버를 선택한 이후 왼쪽의 서버 목록을 접을 수 있습니다.
-
서버 V2에 Java - 쓰로틀링 기능이 이전 되었습니다.
Figure 121. Server - Throttling Configuration-
후보 URL의 오른쪽 검색버튼을 클릭시 아래에 호출된 URL 목록을 통해 Throttle URL을 설정하실 수 있습니다.
-
PHP - 에이전트 상태
Figure 122. Server - Agent Status -
PHP, Python, Nodejs - 모듈 의존성
Figure 123. Server - Module Dependancy
-
-
1.5.1
2019-08-05
신규 기능 추가
애플리케이션 모니터링
큐브 메뉴 화면 개편
-
기능 요약
-
요약, 서비스, 자원 분석을 위한 데이터세트 탭 기능
-
애플리케이션(복수 선택 가능) 및 에이전트 종류별, 에이전트 노드별 큐브 조회 기능
-
차트 위젯의 차트유형 선택 기능 : 데이터병합-시리즈 / 개별애플리케이션-시리즈 / 상위애플리케이션-막대
-
차트 레이아웃 편집 기능 : 위젯 확대/축소, 위치 변경 및 상태 저장
-
신규 큐브 화면 구성
-
데이터세트 탭
-
Overview : 애플리케이션 분석 개요
-
Service : 트랜잭션 서비스 관련 지표
-
Resource : 애플리케이션 및 시스템 자원 관련 지표
-
| 탭 | 위젯 구성 |
|---|---|
Overview |
히트맵, 국가별 트랜잭션(전체 애플리케이션 선택 시), DB Pool 수(개별 애플리케이션 선택 시), TPS, 인스턴스 응답시간, 사용자 수, CPU, Heap 사용량 |
Service |
TPS, 인스턴스 응답시간, TX Error 건수, HTTPC 시간, HTTPC 건수, HTTPC 에러 건수, 정상 액티브 TX 건수, 느린 액티브 TX 건수, 매우 느린 액티브 TX 건수, SQL 시간, SQL 건수, SQL 에러 건수 |
Resource |
CPU, CPU System 사용률, CPU User 사용률, CPU Wait 사용률, CPU Steal 사용률, Process CPU 사용률, Heap 크기, Heap 사용량, Heap Perm 사용량, Thread 수, GC건수, GC 시간 |
-
큐브 캘린더
-
날짜 선택 > 큐브 구성 지표 선택 > 시간 순으로 정렬된 히트맵 차트
-
용도 : 사용자의 관심 지표를 기준으로 이상 트랜잭션이 발생한 시간대을 빠르게 식별하여 상세분석 화면으로 연동하기 위한 기능.
-
사용법 : 히트맵 상의 큐브 마우스 클릭 또는 키보드 방향키 이용
-
-
-
애플리케이션 선택
-
애플리케이션 이름을 클릭하여 큐브 차트 상의 데이터를 필터링할 수 있습니다.
-
우측 드롭다운 버튼을 클릭하여 에이전트/에이전트 종류/에이전트 노드 옵션을 이용해 선택 목록을 변경할 수 있습니다.
-
애플리케이션이 비활성 상태인 경우 표시된 애플리케이션 이름의 밝기가 어둡게 표시됩니다.
-
우측 핀 아이콘을 클릭하여 전체 선택/활성 애플리케이션 선택 등 부가 기능을 이용할 수 있습니다.
-
-
차트 위젯
-
차트 위젯 레이아웃 변경
-
제목을 클릭, 드래그 하여 화면 상에서 이동이 가능합니다.
-
위젯 하단 크기 변경 아이콘을 클릭, 드래그 하여 위젯크기 변경이 가능합니다.
-
-
-
차트 유형 변경
-
위젯 좌측 상단의 아이콘을 클릭하여 차트 유형을 변경할 수 있습니다.
-
-
제공하는 차트 유형
-
데이터 병합 - 시리즈 차트
-
개별 애플리케이션 - 멀티 시리즈 차트
-
상위 애플리케이션 - 막대차트
-
서버 설정 V2
-
기존 서버설정에서 지원하는 기능들 중 핵심기능들을 구현했습니다.
-
칼럼선택
-
칼럼을 선택해 보여줄 칼럼을 선택합니다. 아래 칼럼선택에서 자세한것을 확인해주세요.
-
-
상위메뉴 3가지
-
모든 비활성화 에이전트 삭제
-
아래 비활성화 에이전트를 전부 삭제합니다.
-
-
비활성 에이전트 삭제 시간
-
서버에서 비활성 상태로 설정된 지난 경우 에이전트를 삭제합니다.
-
-
서버 목록 새로고침
-
서버 목록을 다시 불러옵니다.
-
-
-
비활성화 에이전트 삭제
-
개별적으로 비활성화 상태인 에이전트를 제거합니다.
-
-
칼럼선택 상세
-
현재 보고있는 테이블의 칼럼을 선택해서 볼 수 있습니다.
-
-
탭 마다 새로고침
-
탭 이동시 마다 데이터를 새로 불러올 수 있도록 합니다. 체크를 하지 않더라도 초기 데이터는 불러옵니다.
-
-
선택된 서버를 해제
-
선택된 서버를 해제시키며 서버 목록을 다시 확대시킵니다. (이 기능은 파랗게 색칠된 서버 목록을 다시 눌러도 동작합니다.)
-
액티브스택
액티브스택 플로우를 효율적으로 개선했습니다.
-
기존의 액티브스택 페이지를 확인해 보면 각 데이터를 전체 조회하는 것 보다는 부분적으로 끊어서 에러를 찾는것에 초점을 잡는 방향으로 접근방식을 개선했습니다.
-
날짜 선택
-
기존엔 날짜, 시작시간, 기간을 조합하여 시간을 조회하는 방식에서 날짜 하나만 클릭하는 방식으로 트랜잭션을 조회합니다.
-
-
검색
-
선택된 날짜를 기준으로 차트를 조회합니다. 만약 조회한 날짜가 오늘이라면 가장 최근을 기준으로 5분 데이터를 가져오게 됩니다.
-
-
차트 클릭
-
5분 간격의 시간대를 차트를 클릭하여 지정합니다.
-
-
시간 표현
-
클릭한 시간을 표시합니다.
-
-
위 동작을 통해 액티브스택을 조금 더 쉽게 접근하실 수 있습니다.
기타 버그 수정
애플리케이션 모니터링
-
카운터 > 위젯 추가 : 아래로 계속 추가되고 스크롤바가 생기는 경우 자동으로 스크롤됩니다.
-
통계 > SQL > CSV 내보내기 : SQL의 개행을 지워 CSV 텍스트를 깨지지 않도록 수정했습니다.
1.5.0
2019-07-29
신규 기능 추가
통합대시보드 V2 (DashboardV2)
-
대시보드 전체화면 모드 와 위젯 레이아웃 숨기기 기능을 추가하였습니다.
전체화면 모드 클릭 식
-
통합대시보드 위젯의 차트 유형을 추가하였습니다 : Active Transaction 가로 막대 차트
-
애플리케이션 이름을 길게 설정하여 세로형 막대 차트에서 이름을 확인하기 어려운 경우 유용합니다.
-
Service 1.4.0
1.4.9
2019-07-22
언어설정 개인화
-
회원 가입 페이지에 언어 설정 항목이 추가되었습니다. 서비스 페이지에서 표시할 언어를 지정하여 회원가입 하도록 적용됩니다.
-
화면 우상단 계정 수정 메뉴를 통해 계정의 언어 설정을 변경할 수 있습니다. 본 설정은 서비스 페이지의 언어 표시 설정 기능을 제공합니다. 입력 가능한 정보는 'ko', 'en', 'ja', 'zh' 로 제한됩니다.
-
기존의 언어 변경 기능은 현재 페이지 내의 언어 설정을 변경하는 기능으로만 활용됩니다.
통합대시보드 - 서버모니터링 디스크/네트워크 지표의 디바이스별 추이 차트 제공
-
통합대시보드V2 > 위젯 생성 > 위젯 유형: 시리즈 차트 또는 시리즈 비교 > 프로젝트 선택: Server - 지표 선택
-
디스크 관련 지표: Disk I/O % 등 12개 항목
-
네트워크 관련 지표: Network Traffic 등 8개 항목
-
-
위젯 생성 시 선택된 프로젝트에 등록된 서버에 해당하는, 디바이스별 수집 지표값의 추이를 나타냅니다. (툴팁: 프로젝트명 - 디바이스명 : 지표값)
-
라인 하이라이트: 차트 라인을 클릭하여, 라인에 해당하는 수집 서버의 차트를 강조할 수 있습니다. (하이라이트 기능 이용 시 툴팁에선 수집 서버에 해당하는 디바이스 전체 차트를 표시합니다.)
사이즈 메트릭 유닛 표현
시스템의 지표 표현 단위는 2진 단위가 사용됩니다. killbyte를 megabyte로 변환 시에는 1,024로 나누어 표현하는 방식이 적용됩니다.
용량 지표를 표현하는 방식에 있어서 사용자에게 정확한 정보를 제공하기 위하여, 2진 단위로 나누어 표기하는 방식을 적용하였습니다.
메모리와 같이 byte 단위를 사용하는 지표의 경우, 메비바이트 형식의 표기법으로 일부 차트의 표현을 개편하였습니다.
-
1GiB = 1,024MiB = 2^20B
프로파일
1.4.8
2019-07-15
1.4.7
2019-07-08
통합대시보드V2 히트맵 드래그 모달, 트랜잭션 변경에 따른 로딩문제 수정
-
히트맵 에이전트 선택시 즉각적으로 데이터를 가져오는 동작을 반복적으로 진행했을 때 로딩기능을 넣어 트랜잭션 목록을 정상적으로 가져올 수 있게 수정하였습니다.
애플리케이션 대시보드, 대시보드 상세 Heap/Memory 차트
-
Heap/Memory 차트에서 전체량(Total) 또는 사용량(Used)을 필터링할 수 있는 기능을 추가하였습니다.
-
위젯 상단 [TOTAL/USED] 버튼을 클릭하여, 선택한 지표를 차트 상에서 숨기거나 다시 표시할 수 있습니다.
-
차트 상에 마우스 호버 시, 해당 애플리케이션의 Total값과 Used값을 함께 표시합니다.
-
차트를 확대하여 확인하고 싶으신 경우, 우측 화살표 모양을 클릭하여 '대시보드 상세' 화면으로 진입하여 위와 같은 기능을 이용할 수 있습니다.
1.4.6
2019-07-02
애플리케이션 - 애플리케이션/그룹/통합 토폴로지
-
Inbound 호출, Outbound 호출 노드를 비표시 할 수 있는 옵션이 추가되었습니다.
-
노드선택 뷰에서 지정하는 별칭이 지정되지 않던 버그가 수정되었습니다.
-
애플리케이션 토폴로지에서 별칭 저장 시, 서버 메뉴에서 애플리케이션의 별칭을 부여하는 것과 동일하게 애플리케이션 명이 변경됩니다.
애플리케이션 - 트랜잭션 검색 사용성 개선
-
트랜잭션 프로필 데이터 중 중요 스텝에 대한 식별이 용이하도록 스타일이 개선되었습니다.
-
HTTP-HEADER 정보가 추가되었습니다.
-
SQL, HTTPC URL, 데이터베이스 커넥션 스텝을 마우스 호버하면 복사 기능과 더보기 표시 아이콘을 표시합니다.
-
SQL 및 HTTP 파라미터 바인딩을 위해 사용하는 비밀번호 설정이 'WHATAP’인 경우 자동으로 매핑된 결과를 보여줍니다.
| 파라미터 바인딩을 위한 비밀번호는 에이전트 설치 경로의 [paramkey.txt]에서 편집 및 확인이 가능합니다. |
1.4.5
2019-06-24
애플리케이션 - 통계 - CSV 데이터 다운로드 최대 CSV 라인 수 설정 기능 추가
-
통계 메뉴에서 조회한 데이터를 CSV 포맷의 문서로 다운로드 할 때 최대 출력하는 CSV라인의 수를 설정합니다. (기본값:100000)
통합대시보드, 애플리케이션 대시보드 - 차트 라인 하이라이트 기능 개선
-
복수개의 선형으로 이루어진 차트(멀티 라인)에서 라인 하나를 '클릭’하여 해당 애플리케이션에 해당하는 라인을 강조하는 기능입니다.
애플리케이션 - 통계 - 차트 데이터 시간표시 개선
-
기존에 종료시간 기준으로 시간값을 보여주는 문제가 있는데 이동했을 때 5분이 빠지는 느낌을 주기 때문에 범위의 시간을 표시하도록 개선
애플리케이션 - 큐브 - 키보드 방향키를 이용하여 큐브 캘린더 시간 선택 기능 추가
-
큐브 캘린더 : 분석 지표 선택 - 일자 선택 - 선택한 지표에 해당하는 히트맵이 시간 순으로 표시됩니다. 사용자가 관심있는 지표의 추이 정보를 캘린더 형식으로 표시하여 상세 분석을 연계 위한 탐색 기능을 제공합니다.
-
기존 큐브 캘린더의 시간 구간을 클릭하여 시간을 선택하는 것 외에도, 키보드 방향키를 이용하여 선택 구간을 이동할 수 있도록 기능을 추가되었습니다.
세션 만료 시 로그아웃 안내 메시지 기능 추가
-
브라우저에서 사용자가 아무런 동작 없이 장기간 방치된 경우 세션이 종료됩니다. 세션이 종료된 경우 데이터 조회가 제한되기 때문에, 재로그인을 안내하는 메시지가 화면 상에 표시됩니다.
쿠버네티스 - 컨테이너 구성 토폴로지
-
PersistentVolumeClaim, Job, CronJob, StatefulSet, ServiceAccount, Role, RoleBinding, ClusterRole, ClusterRoleBinding, ConfigMap 선택 버튼이 추가되었습니다.
-
Pod, PersistentVolumeClaim, PersistentVolume 간의 연관 관계를 표시하는 기능이 추가되었습니다.
1.4.4
2019-06-17
토폴로지 개선
-
화면 사이즈 조정 시, 토폴로지를 다시 렌더링 하도록 개선하였습니다.
-
노드 선택 박스의 표시/비표시 방법을 명확히 인지하도록 버튼에 (더블클릭) 문구를 추가하였습니다.
로그인/회원 가입 페이지 버그 픽스
-
하단 언어 선택 변경 시, 언어가 변경되지 않는 버그를 수정하였습니다.
-
국가를 대한민국으로 선택 시, 전화번호 인증 버튼이 노출되지 않는 버그를 수정하였습니다.
Limited 프로젝트 사용 제한 설정 정비
-
Trial 기간이 끝난 후 유상 전환되지 않은 프로젝트의 경우 일부 서비스 사용이 제한됩니다.
-
Application Monitoring : 애플리케이션 대시보드, 이벤트 설정, 이벤트 수신 설정 외 사용 제한
-
Server Monitoring : 리소스보드, 이벤트 설정, 이벤트 수신 설정 외 사용 제한
-
히트맵 차트 기능 추가
-
히트맵 버전 업그레이드를 위해 보류한 좌우(<>)구간 이동 기능을 보완하였습니다.
-
DB 추적 기능 을 보완하였습니다.
-
히트맵 트랜잭션 분포와 DBX 플랫폼별 주요 지표에 대한 추이 정보를 비교 분석 수 있습니다.
-
사용자가 속한 DBX 프로젝트 및 인스턴스를 선택하여 차트 기능을 활성화합니다.
-
성능추이 - 표현데이터 문제 수정
-
시간값 6시로 표시되지만 값은 3시간 데이터로 표현되는 문제 처리
-
하루치 이상의 데이터만 표현하지 않던 오른쪽의 시리즈 데이터를 12시간 에서도 보여주지 못했던 문제를 처리완료
1.4.3
2019-06-10
토폴로지 관련
-
위치 저장 기능이 보완되었습니다.
-
위치 복원 버튼이 라디오 버튼으로 대체되었습니다. 위치 복원 라디오 버튼 체크 시, 차트 갱신 과정에서 추가되는 노드의 위치도 복원합니다.
-
기존의 위치 저장 기능과 별도로 위치 저장(병합) 기능이 추가되었습니다.
-
| 위치 저장(병합) 버튼 클릭 시에는, 현재 노드의 위치에 기존에 저장한 노드의 위치 정보를 병합하여 저장합니다. |
-
별칭 지정 기능이 추가되었습니다.
-
노드 선택 표시 차트 상의 노드에서 우측 마우스 클릭 시, 별칭 입력 팝업이 표시되며 엔터 입력 시 별칭이 저장됩니다. 이후 차트 갱신 타이밍에 별칭이 적용됩니다.
-
-
JAVA 에이전트의 애플리케이션 차트 적용 옵션이 디폴트로 적용됩니다.
| 에이전트 설치 페이지를 통해 다운로드 받으시는 에이전트 패키지의 설정 파일(whatap.conf)에 디폴트로 옵션이 추가됩니다. |
쿠버네티스 프로젝트 추가
대망의 쿠버네티스 모니터링 기능이 추가되었습니다.
-
SaaS 가격 : 쿠버네티스 노드 VM코어 당 월 30,000원
-
데이터 서버 지역 : Korea-AWS-Seoul
대시보드 애플리케이션 선택 기능 개선
대시보드 차트를 구성하는 애플리케이션 선택 옵션을 추가하였습니다.
-
기존 에이전트 단위뿐만 아니라 에이전트 종류 및 에이전트 노드 단위 애플리케이션 선택이 가능합니다.
-
애플리케이션 활성 상태 구분 : 활성 상태(좌측), 비활성 상태(우측)
-
선택 구분 : 선택(좌측), 미선택(우측)
-
핀 모드 전환을 통해 애플리케이션 전체 현황을 대시보드 상단 위치에 고정할 수 있습니다.
-
핀 모드 전환 시 전체 선택 / 활성중인 애플리케이션 선택 / 선택한 것만 보기 기능을 제어할 수 있습니다.
-
-
에이전트 선택의 경우 간편 선택 기능을 이용해 보다 쉽게 애플리케이션 선택이 가능합니다.
-
애플리케이션 이름 순으로 정렬된 테이블에서 상단 열 구분(A, B, ..) 또는 좌측 행 구분(1, 2, ..)을 클릭하면 해당 열 또는 행에 해당하는 에플리케이션을 선택할 수 있습니다.
-
검색 시 입력한 내용을 포함하는 애플리케이션을 강조합니다.
-
통합대시보드 V2 부수적인 안정화
통합대시보드V2는 Beta라는 속성을 가지고 지속적인 오류를 발생시키고 있어 상당한 골칫거리 였습니다. 아래에 현재 수정된 버그들을 나열합니다.
또한 기존 통합대시보드V1에 지원하던 수정기능과 공유기능들을 지원하고 선택된 어플리케이션에 관한 정보를 바로 보여주는 작은 팝업도 추가했습니다.
-
시리즈 지표 입력 오류
-
위젯 추가 사이즈 조절
-
머지타입이 변환되지 않는 이슈
-
템플릿 생성시 프로젝트 동시선택 현상
-
아크이퀄라이저 머지타입 추가에 따른 차트기능 추가 및 데이터 병합으로 인해 수많은 데이터 표현시 값이 잘려 표현되는 문제 인 것들과 추가적으로 부수적인 오류들을 수정해 현재 반영했습니다.
| 통합대시보드는 이젠 하위메뉴가 아닌 메인에서 가장 잘 보이는 위치로 이동해 나갈 예정입니다. |
1.4.0
2019-05-20
Open API 버그 수정
-
Open API를 사용하여 일별 사용자 정보를 취득할 경우, GMT+0 기준으로 사용자 수를 집계하여 반환하던 버그를 수정하였습니다.
-
전달받은 시간 정보를 GMT+0로 보정하던 처리를 폐기하고, 사용자 전달 값 기준으로 조회가 가능하도록 개선되었습니다.
사용 방법
curl -L -w "\n" -H "x-whatap-token: {Project Token}" -H "x-whatap-pcode: {Project Code}" "https://service.whatap.io/open/api/json/visitor_d/{stime}/{etime}"
-
stime , etime은 Unix Epoch Time (millisecond) 을 활용합니다.
-
기존에는 stime을 보정하여 GMT+0시로 보정하여 응답을 반환하던 부분을 아래와 같이 개선하였습니다.
| Open API를 통해 전달된 stime 기준으로 24시간 단위로 사용자 수를 집계한 결과를 응답으로 반환합니다. |
Service 1.3.0
1.3.9
2019-05-06
통합 대시보드 V2 추가
통합 대시보드 V2(이하 대시보드V2)의 베타 버전이 릴리즈 되었습니다.
대시보드V2는 기존 대시보드V1 제품의 안정성 향상 및, 기능적인 측면에서 발전하였습니다.
-
라이브 편집
이제, 대시보드 편집시 모니터링 중인 화면을 정지하지 않아도 됩니다. 라이브 편집 기능을 통해 모니터링을 하는 중에도 끊김없이 새로운 패널을 추가하거나 기존의 패널을 삭제 / 변경할 수 있습니다. -
사용 중인 대시보드를 URL 주소로 접근
모니터링하고자 하는 대시보드를 URL 주소로 접근 할 수 있습니다. 대시보드 진입시 URL에 기록되는 쿼리 값을 이용하여 동일한 대시보드에 다시 진입할 수 있습니다.
1.3.7
2019-04-08
애플리케이션 - Open API 방문자 수 관련 버그 픽스
액티브 사용자 추출 관련 API 버그가 수정되었습니다.
-
액티브 사용자 (5분 단위)의 데이터의 timestamp가 동일하게 출려되던 오류가 수정되었습니다.
-
액티브 사용자 (1시간 단위)의 데이터가 5분 단위 방문자 수로 잘못 추출되던 건을 1시간 단위로 추출되도록 수정되었습니다.
액티브 사용자 (5분 단위)
- command
$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1" "https://service.whatap.io/open/api/json/visitor_5m/1554444000000/1554076800000"
- response
{
"data": [
[
1554444005000, <== 1시간 단위 (5*60*1000)
12
],
[
1554444010000,
12
],
(중략)
],
"pcode": 3000000079,
"stime": 1554444000000,
"etime": 1554444300000,
"total": 59
}액티브 사용자 (1시간 딘위)
- command
$ curl -L -w "\n" -H "x-whatap-token: J************************A" -H "x-whatap-pcode: 1**1" "https://service.whatap.io/open/api/json/visitor_h/1554444000000/1554454800000"
- response
{
"data": [
[
1554444000000, <== 1시간 단위 (60*60*1000)
18
],
[
1554447600000,
16
],
(중략)
],
"pcode": 3000000079,
"stime": 1554444000000,
"etime": 1554454800000,
"total": 3
}1.3.3
2019-03-06
인프라 - 서버 목록 기능을 개편하였습니다.
인프라 수집 서버의 전체 현황을 나타내며 서버 관리기능 및 서버 간 비교기능을 제공합니다.
서버 목록 (테이블)
에이전트가 할당된 전체 서버의 현황을 나타냅니다.
칼럼 추가 및 칼럼 선택 기능 개선
테이블에 표시할 칼럼을 선택할 수 있습니다.
서버목록 상에 표시할 수 있는 지표의 수를 대폭 늘리고 선택 옵션을 추가하였습니다.
선택 옵션 : 전체 선택 / 전체 해제 / (와탭 지정)초기값 설정 / 그룹별 선택
- NOTE
-
선택한 칼럼은 브라우저 쿠키값으로 저장되어 페이지 새로고침 후에도 상태가 유지됩니다. 쿠키 삭제 또는 기타 이유로 설정 간 오류가 발생하면 전체 선택 상태로 초기화합니다.
고급 필터 기능 추가
디스크와 네트워크 칼럼은 디바이스별로 값을 나타냅니다. 디바이스 필터링 옵션을 설정하여 원하는 값만을 표시할 수 있습니다.
-
적용 칼럼 선택 : 필터 기능을 적용할 디스크 또는 네트워크 칼럼을 선택합니다. 복수 설정이 가능합니다.
-
옵션 선택
-
포함 : 전체 디바이스 중 입력값을 포함한 것을 표시합니다.
-
미포함 : 전체 디바이스 중 입력값을 포함하지 않은 것을 표시합니다.
-
일치함 : 전체 디바이스 중 입력값과 일치하는 것을 표시합니다.
-
일치하지 않음 : 전체 디바이스 중 입력값과 일치하는 것을 제외하여 표시합니다.
- NOTE
-
고급 필터링 설정 내용은 사용자 브라우저 쿠키값으로 저장합니다. 페이지 이동 또는 새로고침 시 설정 상태가 유지됩니다. 단, 쿠키 삭제 또는 기타 이유로 에러 발생할 시 필터링을 적용하지 않은 상태로 초기화합니다.
-
1.3.0
2019-02-07
토폴로지(베타)
-
APM 토폴로지 뷰가 추가되었습니다.
-
Java Agent 1.7.0+ 적용을 필요로 합니다.
-
에이전트 옵션에 다음 3가지 옵션을 활용하실 수 있습니다.
-
sql_dbc_meter_enabled
-
httpc_host_meter_enabled
-
tx_caller_meter_enabled
-
-
-
기능 간략 요약
-
화면 갱신 간격: 10초, 갱신 간격 변경 가능, 새로고침 옵션 제공
-
노드 색상
-
바다색: 해당 프로젝트의 Java 애플리케이션
-
연두색: 불특정 외부 모듈
-
하늘색: HTTP 외부 호출
-
주황색: DB 호출
-
-
링크 정보
-
평균 응답시간
-
호출 건수 (합산, 에러 건수 포함)
-
에러 건수 (합산)
-
패치 시간 (합산)
-
패치 건수 (합산)
-
-
이벤트
-
마우스오버: 선택된 애플리케이션 기준으로 링크가 연결된 노드만 하이라이트, 나머지 노드는 dimming
-
마우스아웃: 모든 노드를 하이라이트
-
드래그: 노드를 드래그 하여 위치 이동 가능(위치 고정 기능은 제공하지 않음)
-
변경 사항 반영: 추가된 노드, 삭제된 노드와 연결 정보만 갱신됨
-
-
-
참고 사항
-
베타 테스트 중으로 개선 작업이 진행되고 있으며, 본 문서의 이미지와 운영 반영 이미지가 다소 상이할 수 있습니다.
-
문제 및 개선 사항은 yiseo@whatap.io로 전달주시면 베타 중 개선에 반영하도록 하겠습니다.
-
Service 1.2.0
1.2.9
2018-02-05
APM - DBX 연계 기능 오픈
-
APM 히트맵 트랜잭션 페이지에 DB 추적 기능이 추가되었습니다.
-
히트맵 트랜잭션 분포와 DBX 플랫폼별 주요 지표에 대한 추이 정보를 비교 분석 수 있습니다.
-
히트맵 조회 - 'DB추적'
-
-
기능 간략 요약
-
사용자가 속한 DBX 프로젝트 및 인스턴스를 선택하여 차트 기능을 활성화합니다.
-
플랫폼별 제공하는 DB 추적 지표는 아래와 같습니다.
-
PostgreSQL
-
blks_hit
-
blks_read
-
active sessions
-
total runtime
-
commit count
-
lock wait sessions
-
total sessions
-
long running sessions
-
-
Oracle
-
cpu
-
active sessions
-
total sessions
-
lock wait sessions
-
session logical reads
-
physical reads
-
execute count
-
opened cursors current
-
-
MySQL
-
Innodb_buffer_pool_read_requests
-
Innodb_buffer_pool_reads
-
Threads_connected
-
Threads_running
-
Questions
-
Com_select
-
Writes
-
Bytes_received
-
-
MSSQL
-
cpu
-
active sessions
-
total sessions
-
lock_wait_sessions
-
Page reads/sec
-
Page lookups/sec
-
Range Scans/sec
-
Full Scans/sec
-
-
Tibero
-
cpu
-
active sessions
-
total sessions
-
lock wait sessions
-
total elapse time
-
long running sessions
-
block disk read
-
execute count
-
-
-
1.2.7
2019-01-07
APM 멀티 트랜잭션 추적 (MTID)
-
APM 멀티 트랜잭션 화면에 차트 기능이 추가되었습니다.
-
히트맵 분석 > 히트맵 프로필 > MTID > Chart View
-
-
기능 용약
-
좌측 화면은 애플리케이션 간 트랜잭션 관계를 표현합니다.
-
우측 바 차트를 통해 최초 진입점 기준으로 응답시간의 지연 원인이 된 애플리케이션을 특정할 수 있습니다.
-
-
이벤트
-
마우스 오버 : 해당 서버의 응답시간 바 차트를 강조합니다.
-
애플리케이션 이름 또는 응답시간 바 차트 클릭 : 트리뷰로 이동하여 해당 애플리케이션의 프로필을 확대합니다.
-
마우스 드래그 : 차트를 확대 또는 축소, 이동할 수 있습니다.
-
1.2.6
2018-12-21
사용자 계정 생성
-
계정 생성 페이지가 개편되었습니다.
-
Title(직책/직급) 항목 폐기
-
Phone(전화번호) 입력란에 숫자만 입력 가능하도록 마스킹
-
Name(이름) 입력 정보가 저장되지 않던 버그 수정
-
Email(이메일) 관련 주의 문구 추가 - 사용처 및 스팸 확인
-
Phone(전화번호) 관련 주의 문구 추가 - 사용처
-
관리자 계정 생성
-
관리자 계정 생성 페이지가 개편되었습니다.
-
Title(직책/직급) 항목 폐기
-
Email(이메일), Phone(전화번호) 관련 주의 문구 추가 - 사용처 및 스팸 확인
-
-
관리자 화면 > ACCOUNTS > 계정 추가
사용자 정보
-
관리자 계정 상세 페이지가 개편되었습니다.
-
Title(직책/직급) 항목 폐기
-
최종로그인 시각, 로그인 회수 추가
-
-
관리자 화면 > ACCOUNTS > 계정목록 상세 버튼
수집서버 연관관계
-
수집서버 연관관계 차트가 추가되었습니다.
-
수집서버의 마이크로 어플리케이션 서버, 리전, 프로젝트와 관련한 정보를 표시합니다.
-
type: region으로 표시된 노드 클릭 시, 리전 단위의 어플리케이션 서버 정보와 프로젝트 정보가 추가됩니다.
-
-
관리자 화면 > RELATION
APM 차트
-
각종 통계 정보에 차트가 추가되었습니다.
-
탑 스택 차트 - APM 프로젝트 > 스택 > 턉 스택
-
유니크 스택 차트 - APM 프로젝트 > 스택 > 유니크 스택
-
Dashboard 템플릿
-
사용자 정의 대시보드를 보다 쉽게 만들수 있는 대시보드 템플릿 기능이 추가되었습니다.
-
MY PROJECT > Dashboard > Create Dashboard
-
1.2.5
2018-12-10
통계 차트
-
클라이언트IP 통계 화면에 Bilevel 차트 기능이 추가되었습니다. 국가/도시/IP 기준 카운트 수와 IP 클래스를 기준의 카운트 수를 기준으로 점유율을 원호로 배치하여 비중을 표현하는 2개의 차트를 통해 IP통계를 보다 직관적으로 확인할 수 있습니다.
-
통계 > 클라이언트IP
-
-
통계 기능에 복수 어플리케이션의 시계열 데이터 비교를 위한 비교 차트가 추가되었습니다.
-
통계 > 트랜잭션 통계 > 트랜잭션
-
통계 > 에러
-
통계 > SQL
-
통계 > 원격 HTTP 호출
-
1.2.4
2018-12-03
통계 차트
통계 화면에 로딩된 데이터를 기준으로 연관관계를 용이하게 파악하기 위한 차트가 추가되었습니다.
Edge Bundling Chart로 트랜잭션 URL과 호출 대상 트랜잭션 URL 및 에러, SQL, 원격 HTTP 호출 간의 관계를 표현합니다.
연결선의 두께는 카운트 정보를 토대로 연결선의 두께 및 색상을 차등화하여 표현하고, 각 노드에 마우스오버 시 툴팁으로 상세 정보를 표시합니다.
-
통계 > 트랜잭션 > 호출자
-
통계 > 에러
-
통계 > SQL
-
통계 > 원격 HTTP 호출
Java Agent Release Notes
Java Agent 1.8.6
Java Agent 1.8.1
2019-06-25
JVM을 위한 상세 성능카운트
Java VM을 위한 상세한 성능카운트를 추가로 수집할 수있습니다.
perfx_java_enabled=true
whatap.conf에 perfx_java_enabled=true가 설정되면 다음과 같은 성능정보를 추가로 수집합니다.
- java_memory
-
heap & nonheap에 대한 메모리 사용량
- java_memory_pool
-
영역별 Heap메모리 사용량
- java_gc
-
Java Heap GarbageCollector 수행 건수와 시간
- java_os
-
Java 시스템 영역에서의 성능 지표들
OpenFileDescriptorCount, MaxFileDescriptorCount, ProcessCpuTime ,CommittedVirtualMemorySize, TotalSwapSpaceSize, FreeSwapSpaceSize , FreePhysicalMemorySize, TotalPhysicalMemorySize, SystemCpuLoad, ProcessCpuLoad, SystemLoadAverage, AvailableProcessors
| perfx_java_enabled=true 상태에서 java_gc 수집만 off하고 싶다면 perf_java_gc_enabled=false 를 설정합니다. 마찬가지로 perfx_java_memory_enabled=false perfx_java_memory_pool_enabled=false perfx_java_os_enabled=false 등의 옵션을 사용 할 수있습니다. |
사용자 관심 JMX 성능 카운트
JVM내에서 임의의 JMX path를 지정하여 수집할 수 있습니다. 지정한 Mbean 객체의 Attribute가 성능 카운트 형태로 수집됩니다.
perfx_jmx_enabled=true
perfx_jmx_enabled=true가 설정되면 다음의 Mbean Object 들의 정보가 수집된다. 만약 특정 데이터를 off하려면 해당 옵션을 false로 설정합니다.
Category: tomcat_connector Option: perfx_tomcat_connector_enabled=true ObjectName Query: Catalina:type=Connector,*
Category: tomcat_datasource Option: perfx_tomcat_datasource_enabled=true ObjectName Query: Catalina:type=DataSource,*
Category: tomcat_threadpool Option: perfx_tomcat_threadpool_enabled=true ObjectName Query: Catalina:type=ThreadPool,*
Category: tomcat_executor Option: perfx_tomcat_executor_enabled=true ObjectName Query: Catalina:type=Executor,*
Category: java_nio_bufferpool Option: perfx_java_nio_bufferpool_enabled=true JMX Query: java.nio:type=BufferPool,*
Java Agent 1.7.7
2019-06-11
사용자 정의 추가 성능 모니터링
JAVA,Tomcat에 관련한 추가 성능지표를 모니터링 할수있습니다.
Memory 상세 지표 수집, Jedis Connection Pool건수, Tomcat8에서 컨택스트별 성능지표들을 수집할 수있습니다.
perfx_java_memory_enabled = false perfx_jedis_enabled = false perfx_tomcat8_enabled = false
데이터 수집 주기는 각각 지정할 수있습니다. 기본은 모든 5000ms로 되어있습니다.
perfx_java_memory_interval = 5000 perfx_jedis_interval = 5000 perfx_tomcat8_interval = 5000
Java Agent 1.7.5
2019-04-25
exception 발생시 스택을 프로파일에 보여줌
모든 Exception의 stack을 추적하면 운영시스템의 부담이 될수있습니다. 하지만 디버깅 목적이나 개발 시에는 스택정보를 프로파일에서 보여주는 것이 유용합니다.
profile_exception_stack=true
모든 트랜잭션의 mtid를 추적하고자 할때
log4j와 같은 로깅 시스템과 연계하기 위해서 모든 트랜잭션의 mtid를 추적할수있습니다.
mtrace_alltx_enabled=true
mtrace_rate=100으로 설정해도 비슷한 효과를 얻을 수있습니다.
| mtrace_rate=100은 최초 외부호출이 발생할때 mtid를 생성하기 때문에 log와 연계할때는 부적절 할 수도 있습니다. |
mtrace_alltx_enabled=true하면 너무 많은 로그가 남을 수있습니다. 이때는 프로파일 로깅량을 줄일 필요가 있습니다.
mtrace_basetime=1000
profile_basetime은 mtid==0인 경우에만 적용됩니다. 그래서 모든트랜잭션에 mtid가 부여된 상황에서는 mtrace_basetime을 사용해서 프로파일 량을 줄일 수 있습니다.
Java Agent 1.7.4
2019-04-03
쉘명령어을 이용한 CPU/MEM 모니터링
-Dshell_perf_enabled=true -Dshell_perf_command=iostat 3
유닉스나 혹은 메인 프레임등예외적인 환경인 경우 시스템 CPU사용량을 모니터링하기 위해 쉘을 사용할 수있습니다.
와탭은 shell_perf_enabled=true인 경우에는 shell_perf_command에 등록된 쉘명령을 백그라운드로 실행하여 stdout의 데이터를 수집합니다.
라인 파서를 등록해야 합니다.라인파서는 플러그인으로 등록합니다.
//println($line); String[] tok = tokenizer($line," "); float idl= cfloat(index(tok,5)); cpu(100f-idl);
$line을 파싱하여 값을 등록합니다. 이때 값을 등록하는 api는 다음과 같습니다.
cpu(float) cpu_sys(float) cpu_usr(float) cpu_proc(float) mem(float) swap(float) disk(float)
Java Agent 1.7.2
Java Agent 1.7.0
2019-01-10
Multi-tier Transaction Trace(MTRACE)
mtrace_enabled=false
mtrace_enabled=false 옵션을 추가하였습니다. 이값을 true 설정하면 멀티티어에 대한 트랜잭션 연결 추적을 시행합니다.
meter_enabled
sql_dbc_meter_enabled=false httpc_host_meter_enabled=false tx_caller_meter_enabled=false
호출자 기반의 통계, httpc 관한 통계,sql에 대한 통계를 5초단위로 실시간으로 수집합니다. 그중에서 tx_caller_meter_enabled는 mtrace_enabled=true일때만 동작합니다.
mtrace_rate
mtrace_rate=10
트랜잭션의 프로파일을 연결분석하기 위해서 mtid를 주고 받습니다. mtrace_rate=10이면 트랜잭션중에서 10%를 샘플링하여 caller의 txid와 mtid를 "x-wtap-mst"로 전송합니다.
받는 쪽에서는 별다른 옵션이 없습니다.
_trace_mtrace_poid_key=x-wtap-po _trace_mtrace_caller_key=x-wtap-mst _trace_mtrace_spec_key=x-wtap-sp _trace_mtrace_callee_key=x-wtap-tx
Java Agent 1.6.2
2018-11-23
Non Http Transaction에 대한 이름 옵션
service_name_mode=
full,class,method,string,arg 5가지 옵션을 지정할 수있습니다.
-
full : Full Class이름 사용
-
class : Class 이름 서비스 명으로 사용
-
method : Method이름을 서비스명으로 사용
-
string : 문자열중에서 첫번째 파라미터를 서비스 명으로 사용
-
arg : 파라미터중에서 service_name_index옵션에 지정한 인덱스이 파라미터를 서비스 명으로
Java Agent 1.6.1
Java Agent 1.6.0
SAP3 모니터링 기능 추가
에이전트 옵션 설정 필요 (재기동 필요) .whatap.conf
hook_httpc_sap3_enabled=true
sapjco3-3.0.14.jar를 사용하여 테스트 했습니다.
addin monitor 설정 방법 추가
addin module jar 파일들을 복사합니다.
${WHATAP_AGENT}/addin/.
다음은 addin monitor클래스를 설정하는 방법입니다. 먼저 갯수를 지정합니다. 그리고 갯수 범위(addin_monitor_num)내에서 addin_monitor_x= 형태로 설정합니다.
addin_monitor_num = 10 addin_monitor_0=addin.java7.MemoryMonitor addin_monitor_1=addin.java7.MemoryPoolMonitor addin_monitor_2=addin.java7.MemoryUsageMonitor addin_monitor_3=addin.java7.ThreadingMonitor
|
값이 없으면 무시됩니다. 동일한 클래스가 중복 설정되면 하나는 무시됩니다. |
Java Agent 1.3.1
Sigar disable 처리 가능하게
Sigar는 와탭에서 서버의 물리자원 사용량을 수집하기 위해사용한다. 그런데 siager_enabled=false를 설정하면 JMX를 통해 시스템의 자원 사용량을 추적한다.
sigar_enabled=true
| 주의 할점은 JMX를 통해서 자원 사용량을 추적할때 메모리 사용량이 리눅스의 경우 부정확한 문제가 있다. 리눅스는 OS의 메모리가 여유가 있으면 디스크 버퍼케쉬를 위해 임의로 메모리를 사용한다. 이 공간한 메모리 사용률에서 제외해야하는데 JMX의 그것을 처리할 수있는 API가 제공되지 않는다. |
Java Agent 1.2.8
Custom Leak 추적
custom leak 추적이란 트랜잭션이 수행되는 도중에 open과 close메소드의 짝이 맞는지를 추적하는 기능입니다.
hook_custom_open_patterns="" hook_custom_close_patterns="" profile_custom_leak_enabled=true
profile_custom_leak_enabled=true
옵션에 설정한 메소드들이 프로파일에서 호출내역을 보거나 제거할 수 있다.기본값은 true이다.
사용예
hook_custom_open_patterns=leaktest.T.open hook_custom_close_patterns=leaktest.T.rollback,leaktest.T.commit
T라는 클래스는 open과 commit/rollback 3개의 메소드가 있다. 이때 open이 호출되면 반드시 commit혹은 rollback이 호출되어야 하며 연속으로 2번이상의 open이나 commit이후 rollback이 호출되는 것은 무시된다.
T.open -> T.open -> T.commit : ok T.open ->T.commit -> T.open : leak
Java Agent 1.2.2
DB Pool 카운터 추적
와탭은 DB Connection Pool에서 Active 카운트와 Idle카운트를 추적하고 상태정보를 조회하는 기능을 제공한다. 데이터를 조회하는 방식에는 크게는 JMX와 BCI 두가지 방식을 가지고 있다. JMX 방식은 기동중에 옵션 변경만으로 적용된다. 하지만 BCI방식은 재기동시 옵션이 변경되어있어야 한다.
- JMX방식에는
tomcat_ds_enabled=false weblogic_ds_enabled=false
- BCI방식에는
hikari_pool_enabled=false dbcp_pool_enabled=false weblogic_pool_enabled=false
톰켓과 웹로직은 JMX를 통해 데이터를 조회할수 있지만 버전에 따라서 동작하지 않을 수 있다. 현재 테스트 된 버전은 Tomcat7 버전이다. 웹로직은 weblogic10에서 테스트 되었다. DBCP, Hikari, Weblogic10에서는 컨넥션 풀 클래스를 직접 BCI로 접근하여 데이터를 조회할 수있다.
DB Pool 추적 커스터마이징
- 1.에이전트 옵션에
-
custom_pool_classes=<id>@<pool class name>
custom_pool_classes=dbcp@org.apache.tomcat.dbcp.dbcp.BasicDataSource
만약 여러가지 풀을 사용하고 있으면 콤마(,)로 구분하여 여러개를 지정할 수있다.
- 2.플러그인 추가
-
${WHATAP_HOME}/plugin/CustomPool.x
$result.active(method($pool,"getNumActive")); $result.idle(method($pool,”getNumIdle"));
전달된 $pool에서 리플렉션으로 조회를 할 것이다. $pool의 실제 클래스는 custom_pool_classes에 설정했던 객체가 전달된다. 만약 2개이상이 설정되어있다면 $id 를 참조하여 구분할 수있다.
실시간 혹은 일자별 차트에서 데이터 확인 가능
Java Agent 1.2.1
Java Agent 1.2.0
CPU 과점 쓰레드 덤프
WAS 프로세스의 CPU가 높을때 어떤 쓰레드가 CPU를 많이 사용하는지 찾기 위해 쓰레드 덤프를 연속적으로 수행하는 기능입니다.
debug_cpu_enabled = false; debug_cpu_trigger = 0; debug_cpu_interval = 10000; debug_cpu_dump_count=10;
-
debug_cpu_enabled=true 가 되면 본 기능이 활성화됩니다.
-
debug_cpu_trigger값이 변경되면 그때부터 CPU를 가장 많이 사용하는 쓰레드5개를 ${WHATAP_HOME}/whatap-cpu-(pcode)-(oname)-{time]-{num].wdmp 파일에 기록합니다.
-
덤프 간격은 debug_cpu_interval에 지정됩니다.
-
debug_cpu_dump_count(10) 횟수만큼 덤부를 수행합니다.
덤프내용을 백그라운드 쓰레드를 포함하여 덤프 간격동안 CPU 를 가장 많이 사용하고 있는 쓰레드이고 만약 개별 쓰레드가 사용자 요청(URL)를 처리 중이라면 URL도 같이 로깅한다.
자동 쓰레드 덤프
WAS의 장애가 발생하여 액티브트랜잭션이 증가하면 자동으로 전체 쓰레드를 덤프하여 향후 문제 분석에 활용합니다.
thread_dump_enabled = true thread_dump_interval = DateUtil.MILLIS_PER_HOUR thread_dump_cpu = -1 thread_dump_actx = 300
thread_dump_actx(300)이상의 액티브 서비스갯수가 쌓이거나 thread_dump_cpu(-1:disabled)이상의 CPU사용이 발생할때 JVM내의 모든 쓰레드와 그 스택을 덤프한다. 각 쓰레드가 수행하는 URL정보도 같이 덤프라한다. (값이 -1일때는 동작하지 않는다) 한번 덤프가 발생하면 thread_dimp_interval 이상 시간이 경과되어야 다시 동작합니다.
특정 url 쓰로틀링(Request Throttling)
웹 요청이 폭주할경우 초과 요청을 다른 페이지로 넘길 수있다. 쓰로틀링에서 특정 타겟팅 페이지만 제어하는 기능이 추가되었다.
throttle_enabled = false; throttle_limit = 10000; throttle_target_urls = throttle_passing_url = throttle_passing_url_prefix = throttle_rejected_message = too many request!! throttle_rejected_forward = <static url> throttle_blocking_url = throttle_blocking_ip = throttle_blocked_message = request blocked!! throttle_blocked_forward_ok = true
throttle_enabled=true가 설정되면 쓰로틀링 기능이 활성화된다. 현재 요청된 URL이 블럭킹 대상이면 처리가 거부된다. 그다음은 액티브 트랜잭션 갯수가 throttle_limit에 도달했는지를 확인하고 limit를 초과하면 url을 검사한하다. 만약 throttle_target_urls(이번에 추가됨)이 등록되있으면 해당 URL에 등록된경우는 서비스를 거부하고 포함되지 않았다면 정상 처리한다. throttle_target_urls에는 full url path로 설정한다. 여러개를 설정할때는 ,로 구분한다.
사용자 기본 측정방식 변경
와탭은 웹시스템의 사용자를 측정하기 위해 쿠키를 사용합니다. 그런데 모바일이나 일부 장비에서 쿠키를 원할하게 처리하지 못하는 현상이 예상되어 기본을 ip를 사용하여 사용자를 측정하도록 변경하였습니다.
trace_user_using_ip = true
만약 이전처럼 쿠키를 기반으로 사용자를 측정하고자 한다면 위 옵션을 false로 변경해 주어야 한다.
DB 연결 카운팅
tomcat_ds_enabled = false weblogic_ds_enabled = false hikari_pool_enabled = false dbcp_pool_enabled = false weblogic_pool_enabled = false
xx_ds_enabled와 xx_pool_enabled 두가지 옵션이 있다. ds는 DaraSource에서 데이터를 JMX로 추출하고 _pool_은 BCI 를 통해서 데이터를 추출한다.
따라서 운영중에 xx_ds_enabled=true를 적용하면 바로 적용되지만 xx_pool_enabled는 재기동이 필요하다.
톰켓에서 DBCP를 사용하는 시스템의 경우에는 tomcat_db_enbled혹은 dbcp_pool_enabled를 모두 사용할 수있다. 하지만 SpringBoot에서 DBCP를 사용하는 경우에는 dbcp_pool_enabled를 사용해야 한다.
웹로직의 경웨는 Standalone으로 설치된 경우에는 weblogic_ds_enabled와 weblogic_pool_enabled를 모두 사용할 수 있으나 도메인 구성이되어있는 경우에는 weblogic_pool_enabled를 적용해야 데이터가 추출된다.
메소드 호출 건수 추적
특정 메소드의 호출건수를 추적하고 싶을 때 사용한다. .whatap.conf
hook_method_stat_supers hook_method_stat_interfaces hook_method_stat_patterns
서버 > 더보기 > Method Perfor Stat에서 확인 할 수 있습니다.
에이전트 메모리에서 카운팅을 하고 메뉴에서 현재 통계 정보를 조회할수 있다.
액티브 스택 최적화
액티브 스택을 수집함에 있어 에이전트 폭주시 영향을 최소화 하기 위해 최적화 옵션이 적용되어있다.
- 최대 동시 액티브 스택 지정
-
간혹 시스템에 따라 액티브 트랜잭션이 수천개가 되는 경우들이 있다. 이것은 이미 장애 상황이기 때문에 액티브 스택 수집을 제한하고 있다.
active_stack_count = 100
- 덤프 interval
-
TPS가 높은 시스템에서 (인스턴스당 약400정도)에서는 모니터링 오버헤드를 신경써야 한다. 액티스 스택의 수집주기를 늘려줄 필요가 있다.
active_stack_second=10 (단위 초)
약 60정도 적용하면 무난 할 것이다.
- 스택 depth
-
액티브 스택의 최대 depth이다. 기본은 최대 스택별 50라인을 수집한다.
trace_active_callstack_depth = 50
PHP Agent Release Notes
PHP Agent 0.6.0
2020-02-08
업데이트
공유메모리
PHP extension(whatap.so) 와 whatap-php service 간에 공유메모리를 이용한 IPC 기능을 추가했습니다.
shm_key의 값으로 설정된 키로 생성합니다. 이미 키가 사용되고 있다면 다른 키를 설정할 수 있습니다.
whatap-php service에서 공유메모리 생성 및 삭제를 관리합니다. PHP extension 에서는 조회기능만 수행합니다.
- whatap.shm_enabled
-
Default : true
Type : Boolean
공유메모리 사용 여부를 설정합니다.
| Apache 또는 PHP-FPM의 재시작 후 적용됩니다. |
- whatap.shm_key
-
Default : 6600
Type : Long
공유메모리를 생성할 때 필요한 키 정보입니다.
| Apache 또는 PHP-FPM의 재시작 그리고 whatap-php 서비스도 재시작해야 적용됩니다. |
공유메모리 확인 및 삭제
ipcs 명령어를 통해 공유메모리를 확인할 수 있습니다.
# ipcs ------ Shared Memory Segments -------- key shmid owner perms bytes nattch status 0x000019c8 131074 root 666 80 0 ------ Semaphore Arrays -------- key semid owner perms nsems 0x000019c8 425984 root 666 1 ------ Message Queues -------- key msqid owner perms used-bytes messages
ipcrm 명령어를 통해 공유메모리를 삭제할 수 있습니다.
# -m : remove shared memory by shmid # ipcrm -m 131074 # -s : remove semaphore by semid # ipcrm -s 425984
액티브 스테이터스
공유메모리를 통해 진행중인 요청의 현재 상태를 5초 간격으로 수집합니다.
대시보드 화면에 액티브 스테이터스 그래프가 표기됩니다. 상태는 일반 함수, SQL, DB connection, 외부 HTTP 연결, 소켓 연결이 있으며 각 상태별로 진행중인 요청 개수를 표시합니다.
|
Apache 또는 PHP-FPM가 재시작되면 진행중인 프로세스가 처리 중에 종료되면, 정상적인 액티브 스테이터스 완료 처리가 되지 않아 오차가 발생할 수 있습니다. 액티브 트랜잭션 수와 많은 차이가 발생하는 경우, 설정에서 whatap.active_stat_enabled를 false로 설정한 후, 대시보드에서 0건으로 초기화 되면 다시 true로 설정합니다. |
동적 설정 기능
기존에 사이트 에이전트 설정 메뉴에서 설정을 추가 또는 변경하여도 Apache 또는 PHP-FPM을 재시작해야만 적용되는 설정을 공유메모리를 통해서 재시작 없이 적용가능합니다.
| 옵션 | 설명 |
|---|---|
whatap.ext.error_enabled |
PHP 확장 모듈(PHP Extension module) 에서 오류(Error) 정보를 수집하는 기능을 활성화 합니다. |
whatap.ext.exception_enabled |
PHP 확장 모듈(PHP Extension module) 에서 예외 처리(Exception) 정보를 수집하는 기능을 활성화 합니다. |
whatap.trace_user_enabled |
실시간 사용자 집계 여부를 지정합니다. 이 값을 활성화 하는 경우 아이피 또는 PHP 기본 쿠키(PHPSESSID) 및 프레임워크 쿠키(ci_session, Laravel_session)를 기준으로 사용자를 추적합니다. |
whatap.trace_user_using_ip |
실시간 사용자의 구분을 IP로 하고자 하는 경우 설정합니다. 이 데이터는 Real Time User에서 확인 가능합니다. |
whatap.trace_user_set_cookie |
사용자의 구분을 하기 위해 쿠키에 “WHATAP” 키 이름으로 사용자 구분 값을 설정한다. trace_user_using_ip 설정 되는 경우 반영되지 않습니다. |
whatap.profile_method_enabled |
실행시간이 1초(whatap.profile_method_time)를 초과하는 사용자 함수의 정보를 트랜잭션 상세 정보에서 확인 할 수 있습니다. |
whatap.profile_method_stack_enabled |
사용자 함수의 스택정보를 트랜잭션 상세 정보에서 확인할 수 있습니다. |
whatap.profile_internal_method_enabled |
PHP 내부 함수의 추적 여부를 설정합니다. 실행시간의 기준을 설정합니다. 설정한 시간을 초과하여 실행되는 경우만 정보를 수집합니다. |
whatap.profile_internal_method_param_enabled |
PHP 내부함수에 전달되는 인수의 정보를 같이 출력합니다. 숫자형, 문자형만 값이 출력됩니다. Default: false (true,false) |
whatap.profile_http_header_enabled |
프로파일 내역에 http 헤더 정보를 기록하고자 할 때 사용합니다. |
whatap.profile_http_parameter_enabled |
프로파일 내역에 http 파라미터 정보를 기록하고자 할 때 사용합니다. 파라미터는 별도 보안키를 입력해야 조회 할 수 있습니다. |
whatap.whatap.profile_compile_file_enabled |
compile_file, compile_string 함수의 추적 여부를 설정합니다. |
트랜잭션 리퍼러
통계로 수집되는 referer의 형식을 지정합니다.
도메인 형식으로 지정하면 트랜잭션 리퍼러의 도메인으로 통합된 건수를 확인할 수 있습니다.
- whatap.stat_referer_format
-
Default : 0
Type : Int
| 값 | 설명 |
|---|---|
0 |
전체 (도메인 + 경로 + 쿼리 파라메터) |
1 |
도메인 (http://www.aa.com) |
2 |
도메인 및 경로(http://www.aa.com/aa.php) |
3 |
경로 (/aa.php) |
PHP Agent 0.4.12
2019-11-12
버그
트래픽이 급격히 증가할 경우 Udp 데이터 처리에 부하가 발생하는 부분 수정하였습니다.
Golang Channel은 버퍼가 가득찰 경우 병목현상이 발생할 수 있습니다. Queue를 사용하여 우선 순위별로 처리하고, 버퍼를 초과할 경우 별도 처리합니다.
에이전트 성능을 설정할 수 있는 옵션을 추가합니다.
|
에이전트 성능 옵션은 설정 후에 whatap-php 서비스를 반드시 재시작해야 합니다. 에이전트 성능을 확대할 경우 Cpu, Memory 사용율이 증가할 수 있습니다. |
- whatap.tx_max_count
-
Default : 5000
Type : Int
트랜잭션을 최대 저장하는 개수 입니다. 동시에 처리되는 트랜잭션이 많을 경우 해당 크기를 더 늘려줍니다. - whatap.tx_default_capacity
-
Default : 101
Type : Int
트랜잭션을 저장하는 버퍼의 시작 크기 입니다. - whatap.tx_load_factor
-
Default : "0.75"
Type : String(Float)
트랜잭션을 저장하는 버퍼의 크기를 점차적으로 증가시키기 위한 기준입니다. 101개 에서 75%이상 저장되면 버퍼의 크기를 두배로 증가시킵니다. - whatap.queue_log_enabled
-
Default : false
Type : Boolean
queue 관련 로그를 출력합니다. - whatap.queue_tcp_enabled
-
Default : true
Type : Boolean
Tcp 데이터 송신 처리에 사용하는 Channel을 대신해서 별도의 Queue를 사용합니다.(데이터 우선 순위 Queue를 사용합니다.) - whatap.queue_tcp_sender_thread_count
-
Default : 2
Type : Int
Tcp 데이터 송신을 처리하는 쓰레드의 개수를 지정합니다. 개수를 늘리면 데이터 송신을 좀더 빠르게 처리 할 수 있습니다. - whatap.net_send_buffer_size
-
Default : 1024
Type : Int
Tcp 데이터 처리를 위한 Channel 버퍼를 설정합니다. - whatap.net_send_queue1_size
-
Default : 256
Type : Int
Tcp 데이터 처리를 위한 Queue 버퍼를 설정합니다. 우선순위가 높은 데이터를 위한 Queue 입니다. - whatap.net_send_queue2_size
-
Default : 512
Type : Int
Tcp 데이터 처리를 위한 Queue 버퍼를 설정합니다. 프로파일 데이터를 위한 Queue 입니다. - whatap.queue_udp_enabled
-
Default : false
Type : Boolean
Udp 데이터 수신 처리에 Channel을 대신해서 별도의 Queue를 사용합니다. - whatap.queue_udp_size
-
Default : 2048
Type : Int
Udp 데이터 수신 버퍼를 설정합니다. Channel, Queue 버퍼를 설정합니다. - whatap.queue_udp_read_thread_count
-
Default : 3
Type : Int
Udp 데이터 수신을 처리하는 쓰레드의 개수를 지정합니다. 개수를 늘리면 UDP 버퍼에서 좀 더 빠르게 데이터를 읽어드릴 수 있습니다. - whatap.queue_udp_overflowed_size
-
Default : 4096
Type : Int
Udp 데이터 수신에 Queue를 사용하는 경우, overflowed Queue 버퍼 크기를 설정합니다. - whatap.queue_udp_process_thread_count
-
Default : 1
Type : Int
Udp 데이터를 처리하는 쓰레드의 개수를 지정합니다. 개수를 늘리면 UDP에서 읽은 데이터를 좀 더 빠르게 처리할 수 있습니다. - whatap.queue_profile_enabled
-
Default : false
Type : Boolean
Profile 정보 처리에 Channel 을 대신해서 별도의 Queue 를 사용합니다. - whatap.queue_profile_size
-
Default : 512
Type : Int
Profile 정보 처리를 위한 버퍼를 설정합니다. - whatap.queue_profile_process_thread_count
-
Default : 1
Type : Int
Profile 정보를 처리하는 쓰레드의 개수를 지정합니다. 개수를 늘리면 좀 더 빠르게 처리할 수 있습니다. - whatap.queue_text_enabled
-
Default : false
Type : Boolean
Text 데이터 처리를 위해 Channel 대신에 Queue 를 사용합니다. - whatap.queue_text_size
-
Default : 512
Type : Int
Text 데이터 처리를 위한 버퍼를 설정합니다.
PHP Agent 0.4.9
2019-09-05
업데이트
PHP 내부 함수 프로파일링 추가
PHP 내부 함수를 추적합니다. 함수 실행시간이 지정시간 이상으로 걸리면 수집합니다
; PHP 내부 함수의 추적 여부를 설정합니다. Default: false (true,false)
whatap.profile_internal_method_enabled=true
; 실행시간의 기준을 설정합니다. 설정한 시간을 초과하여 실행되는 경우만 정보를 수집합니다. Default: 1000 Millisecond
whatap.profile_internal_method_time=1000
;PHP 내부함수에 전달되는 인수의 정보를 같이 출력합니다.
;숫자형, 문자형만 값이 출력됩니다. Default: false (true,false)
whatap.profile_internal_method_param_enabled=false| profile_internal_time을 빠르게 설정하면 서버에 부하를 줄 수 있습니다. |
| Apache 및 PHP-FPM의 재시작 후 적용됩니다. |
Error, Exception 제외 기능
사용자가 설정한 Error 또는 Exception 정보를 제외하는 기능을 추가하였습니다.
Exception 의 경우 Custom Exception Class 가 정의되어 있지 않으면, 기본으로 "Exception" 으로 수집됩니다.
특정 Exception을 구분하기 위해서는 Custom Exception Class를 정의하고 해당 이름을 지정하면 제외 시킬 수 있습니다.
;특정 Error 또는 Exception 을 Business Exception으로 지정합니다. 히트맵에서는 에러로 표기되지 않고 통계정보에만 수집됩니다. Default ""
;수집되는 Error Class 명과 동일하게 적용합니다. 콤마를 구분자로 하여 여러개를 등록할 수 있습니다.
whatap.bix_exceptions=CustomException, NotFoundException
; 특정 Error 또는 Exception 을 무시합니다. Default ""
; 수집되는 Error Class 명과 동일하게 적용합니다. 콤마를 구분자로 하여 여러개를 등록할 수 있습니다.
whatap.ignore_exceptions=CustomException, NotFoundExceptionsession 함수 프로파일링 추가
session_start, session_write_close 함수의 실행시간을 수집하는 기능을 추가하였습니다.
; PHP 내부 함수의 추적 여부를 설정합니다. Default: true (true,false)
whatap.profile_session_enabled=true| Apache 및 PHP-FPM의 재시작 후 적용됩니다. |
히트맵 이벤트 알림
프로젝트(사이트)의 이벤트> 이벤트설정 의 히트맵 설정과 동일한 설정을 에이전트단위로 설정할 수 있습니다. 추가로 에러가 발생할 경우만 이벤트 알림을 발행합니다. 이벤트 알림 수신 설정은 이벤트>이벤트수신설정에서 설정 가능합니다.
이벤트 가로 라인
히트맵의 응답시간 분포상, 응답시간이 지정시간(whatap.hitmap_hoirz_event_basetime) 이상인 트랜잭션이 동일 응답시간 구간에 연속하여 지정시간(whatap.hitmap_horiz_event_duration) 동안 발생할 경우 알림이 발생합니다. *연속: X축(5초) 단위의 분포가 연속된 선으로 나타날 경우 (중간에 끊김이 있는 경우는 해당되지 않습니다.)
; 이벤트 가로 라인 활성화 여부를 설정합니다. Default: false (true,false)
whatap.hitmap_horiz_event_enabled=true
; 가로줄 현상의 지속시간 설정합니다. Default: 3000 millisecond
whatap.hitmap_horiz_event_duration=30000
; 응답시간의 기준을 설정합니다. Default: 10000 millisecond
whatap.hitmap_horiz_event_basetime=10000
; 에러가 발생한 경우만 이벤트 알림을 발생합니다. Default: false(true,false)
whatap.hitmap_horiz_event_error_only=false
; 이벤트 알림 발행 시에 중복 이벤트 억제 시간을 지정합니다. 해당 시간 내에는 다시 발행되지 않습니다. Default: 300000 millisecond
whatap.hitmap_horiz_event_interval=300000이벤트 세로 라인
히트맵의 응답시간 분포상, X축 단일 구간(5초)에 세로줄이 나타나는 현상이 지정시간(whatap.hitmap_ver_event_duration)에 해당하는 시간 동안 지속될 경우 알림이 발생합니다. *세로 줄 현상 : 2.5초 ~ 80초를 표현하는 전체 100개 구간 중, 경고 구간이 마킹된 경우 [경고 알림]이 발생하며, 동일한 규칙으로 위험구간이 마킹된 경우 [위험 알림]이 발생합니다
; 이벤트 세로 라인 활성화 여부를 설정합니다. Default: false (true,false)
whatap.hitmap_ver_event_enabled=true
; 세로줄 현상의 지속시간을 설정합니다. Default : 30000 millisecond
whatap.hitmap_ver_event_duration=30000
; 에러가 발생한 경우만 이벤트 알림을 발행합니다. Default : false (true, false)
whatap.hitmap_ver_event_error_only=false
; 세로줄 현상의 경고 구간 시작 지점입니다. 종료지점은 위험구간 시작 지점 전까지 입니다.
whatap.hitmap_ver_event_warning_percent=60
; 세로줄 현상의 위험 구간 시작 지점입니다.
whatap.hitmap_ver_event_fatal_percent=80
; 이벤트 알림 발행 시에 중복 이벤트 억제 시간을 지정합니다. 해당 시간 내에는 다시 발행되지 않습니다. Default: 300000 millisecond
whatap.hitmap_ver_event_interval=300000토폴로지 설정
사용자의 설정 없이도 기본적으로 활성화 되도록 수정하였습니다.
; 트랜잭션 정보로 토폴로지 통계를 생성합니다, Default: true (true,false)
whatap.tx_caller_meter_enabled=true
; Database 연결 정보로 토폴로지 통계를 생성합니다, Default: true (true,false)
whatap.sql_dbc_meter_enabled=true
; Http 외부 호출 정보로 토폴로지 통계를 생성합니다, Default: true (true,false)
whatap.httpc_host_meter_enabled=truePHP Agent 0.4.8
2019-04-18
업데이트
PHP 내부 함수 프로파일링 추가
PHP 내부 함수인 compile_file, compile_string 함수를 추척하는 기능을 추가했습니다.
스크립트 실행 전에 컴파일하는 함수로 Main, include, require 및 autoload 스크립트의 컴파일 시점을 확인할 수 있습니다.
스크립트 파일 경로와 실행시간을 확인할 수 있습니다
; compile_file, compile_string 함수의 추적 여부를 설정합니다. Default: false (true,false)
whatap.profile_compile_file_enabled=true
; 실행시간의 기준을 설정합니다. 설정한 시간을 초과하여 실행되는 경우만 정보를 수집합니다. Default: 200 Millisecond
whatap.profile_compile_file_basetime=200
| whatap.profile_compile_file_basetime을 너무 빠르게 설정하면 서버에 부하를 줄 수 있습니다. |
| Apache 및 PHP-FPM의 재시작 후 적용됩니다. |
PHP Agent 0.4.6
2019-03-14
업데이트
토폴로지 기능 추가
아래 옵션 설정 시 조회 가능합니다. 기본값은 false 입니다.
-
어플리케이션 토폴로지는 모든 에이전트의 관계를 표현합니다.
; 트랜잭션 정보로 토폴로지 통계를 생성합니다, Default: false (true,false)
whatap.tx_caller_meter_enabled=true
; Database 연결 정보로 토폴로지 통계를 생성합니다, Default: false (true,false)
whatap.sql_dbc_meter_enabled=true
; Http 외부 호출 정보로 토폴로지 통계를 생성합니다, Default: false (true,false)
whatap.httpc_host_meter_enabled=true
-
그룹 토폴로지는 에이전트를 통합하여 관계를 표현합니다. whatap.okind 설정 값으로 공통 이름을 설정하면 통합하여 표현합니다.
; 그룹 토폴로지를 위해 에이전트의 그룹명을 임의로 설정합니다.
whatap.okind=PHP-DEMO
멀티 서버 트랜잭션 (트랜잭션 연계 추적) 기능 업데이트
옵션을 세분화 했습니다. 옵션으로 멀티 서버 트랜잭션 추적을 활성화 할 수 있습니다. 별도 설정이 없는 경우 추적하지 않습니다.
; 멀티 서버 트랜잭션에서 Callser&Callee간에 버전별 의존성 통계를 수집합니다. Default: false (true,false)
whatap.mtrace_enabled=true
; 트랜잭션 연계 추적 여부, Default: false (true,false)
whatap.mtrace_callee_txid_enabled=true
; 최초 트랜잭션이 발생할 때 발급받는 MTID(Multi Transaction ID)의 발급비율, Default: 10 (Percent)
; 최대값 100을 설정하면 모든 외부 호출에 대해 MTID를 생성합니다.
whatap.mtrace_rate=10
; Http Caller는 Callee에게 자신의 URL을 넘겨줍니다. 이때 URL길이를 제한합니다., Default: 80 byte
whatap.mtrace_send_url_length=80
; 현 인스턴스의 애플리케이션 버전을 지정합니다.임의의 문자열을 지정할 수 있습니다.
; 이 데이터는 호출통계를 위해 사용됩니다., Default: 공백
whatap.mtrace_spec=| 해당 옵션은 Apache 또는 PHP-FPM을 재시작 하여야 적용됩니다. |
PHP Agent 0.4.5
2018-12-11
업데이트
멀티 서버 트랜잭션 (트랜잭션 연계 추적) 기능 추가
서비스(업무) 별로 분리 되어 있는 애플리케이션 서비스들간의 호출을 추적할 수 있습니다.
와탭에 등록되어 있는 프로젝트라면 프로젝트에 등록된 애플리케이션 서비스들간의 호출에 대한 추적을 말합니다.
멀티서버 트랜잭션 추적 옵션을 설정한 경우에 한하여 트랜잭션 연계 추적이 가능합니다.
외부 호출 시에 지정된 헤더를 추가하는 것으로 트랜잭션 연계 추적이 가능합니다.
/usr/whatap/php/lib/WhaTap.php
/usr/whatap/php/lib/sample_mtrace.php<?php
//==================================================================
// 와탭 라이브러리를 추가합니다.
include_once './WhaTap.php';
//==================================================================
$url = "http://localhost/sample.php";
$ch = curl_init();
$headers = array();
//==================================================================
// 와탭 라이브러리에서 트랜잭션 연계추적에 필요한 헤더 정보를 가져옵니다. key,value 형식의 배열 입니다.
echo "Get Mtrace opt and set curl header(x-wtap-mst, x-wtap-inf, x-wtap-tx) <hr/>";
$whatap_mtrace = WhaTap::whatap_get_mtrace();
// cURL에 추가할 사용자 헤더 배열에 와탭 헤더를 추가합니다.
foreach ($whatap_mtrace as $key => $value){
//echo $key."=".$value."<br/>";
array_push($headers, "$key:$value");
}
unset($value);
//==================================================================
// 헤더를 cURL에 설정하고 외부 호출을 진행합니다.
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_HEADER, TRUE);
$ret = curl_exec($ch);
curl_close($ch);트랜잭션 상세보기에서 확인할 수 있습니다.
PHP Agent 0.4.3
PHP Agent 0.4.1
2018-08-23
업데이트
HTTP 파라메터
Get, Post 파라메터 중 text 타입의 이름 과 값을 수집합니다.
최대 40개 (Get 20개, Post 20개) 를 수집하며 파라메터 이름과 값은 최대 256 byte 까지 수집됩니다.
파라메터 정보는 별도 암호화되어 전송되며, 해당 애플리케이션 서버의 /usr/whatap/php/paramkey.txt 에 있는 키로 복호화하여 볼 수 있습니다.
설정 옵션은 아래와 같습니다.
아래 설정은 모든 url에 대한 파라메터 정보를 수집하는 설정입니다. 특정 url만 수집하기 위해서는 url_prefix 옵션을 변경하여야 합니다.
# 파라메터 수집 여부, Default: false (true,false)
whatap.profile_http_parameter_enabled=true
# 파라메터 수집이 필요한 특정 URL 접두사 설정.
whatap.profile_http_parameter_url_prefix=/| 해당 옵션은 Apache 또는 PHP-FPM을 재시작 하여야 적용됩니다. |
PHP Agent 0.3.7
2018-04-24
업데이트
Goole App Engine 지원
Google App Enging 의 환경(app.yaml)을 flex/ custom 으로 설정 합니다.
env: flex
runtime: customapp.yaml 과 같은 위치에 Dockerfile 을 생성하고 아래 내용을 추가 합니다.
PHP 버전 변경은 FROM 이미지를 변경하시면 됩니다.
# google-appengine php php56, php70, php71
FROM gcr.io/google-appengine/php56
# WhaTap. Install Lib
RUN apt-get install wget -y
# WhaTap. Link php-fpm
RUN ln -s /opt/php/sbin/php-fpm /usr/bin/php-fpm
# WhaTap. Install repository and whatap-php
RUN wget http://repo.whatap.io/debian/release.gpg -O -| apt-key add -
RUN wget http://repo.whatap.io/debian/whatap-repo_1.0_all.deb
RUN dpkg -i whatap-repo_1.0_all.deb
RUN apt-get update
RUN apt-get install whatap-php
# WhaTap. Configure PHP agent
RUN (echo "xxxxxxxx"; echo "1.1.1.1/2.2.2.2")|/usr/whatap/php/install.sh
# WhaTap. Add supervisor/conf.d/whatap.conf. Run whatap-php service
RUN echo "[program:whatap-php]" >> /etc/supervisor/conf.d/whatap.conf
RUN echo "command = /etc/init.d/whatap-php start" >> /etc/supervisor/conf.d/whatap.conf
RUN echo "stdout_logfile = /dev/stdout" >> /etc/supervisor/conf.d/whatap.conf
RUN echo "stdout_logfile_maxbytes=0" >> /etc/supervisor/conf.d/whatap.conf
RUN echo "stderr_logfile = /dev/stderr" >> /etc/supervisor/conf.d/whatap.conf
RUN echo "stderr_logfile_maxbytes=0" >> /etc/supervisor/conf.d/whatap.conf
RUN echo "user = root" >> /etc/supervisor/conf.d/whatap.conf
RUN echo "autostart = true" >> /etc/supervisor/conf.d/whatap.conf
RUN echo "autorestart = true" >> /etc/supervisor/conf.d/whatap.conf
RUN echo "priority = 10" >> /etc/supervisor/conf.d/whatap.conf프로젝트 생성 후 발급받은 수집서버 아이피에 대한 Tcp Outbound 6600 허용해 주세요
변경된 app.yaml 과 Dockerfile 을 Google App Engine에 배포하면 PHP 모니터링 프로젝트 대시보드 또는 서버 화면에서 확인이 가능합니다.
설치
PHP 환경 선택 설치
whatap-php 패키지 설치 후 PHP 환경에 따른 설정을 진행하는 스크립트(install.sh)에 사용자가 환경을 지정하여 설치하는 기능이 추가되었습니다.
-
PHP 버전(-v, –php-version) PHP 설정파일 위치(-i, –php-ini ), 웹서버 또는 PHP-FPM 실행 파일명(-p, –process, 메모리 사용량 수집을 위한 정보), ZTS 지원여부(-z, –php-zts)를 지정하여 설치 가능합니다.
/usr/whatap/php/install.sh -l <license> -s <whatap.server> -v 5.3 -i /etc/php.ini -p php-fpm [-z|--zts]
-
PHP CLI 명령어 위치(-e, –php-exe) , 웹서버 또는 PHP-FPM 실행 파일명(-p, –process, 메모리 사용량 수집을 위한 정보), ZTS 지원 여부(-z, –php-zts)를 지정하여 설치 가능합니다.
/usr/whatap/php/install.sh -l <license> -s <whatap.server> -e /usr/bin/php -p php-fpm [-z|--zts]
PHP Agent 0.3.1
2017-11-23
업데이트
메소드 프로파일
메소드 프로파일 기능이 추가되었습니다.
실행시간이 1초를 초과하는 사용자 함수의 정보를 트랜잭션 상세 정보에서 확인 할 수 있습니다.
기본 설정은 true 입니다.
whatap.ini 에 해당 설정을 추가 합니다. (PHP 컴파일 설치로 php.ini 에 추가해야 할 수도 있습니다. )
whatap.profile_method_enabled=true| 해당 옵션은 Apache 또는 PHP-FPM을 재시작 하여야 적용됩니다. |
PHP 라이브러리
PHP Class 라이브러리가 추가 되었습니다.
PHP 소스코드에 함수를 추가하여 원하는 구간의 실행 시간 및 스택 정보를 확인할 수 있습니다.
<?php
// 라이브러리 위치 /usr/whatap/php/lib/WhaTap
include_once './WhaTap.php';
// 시작 지점 @param name string, stack_enabled boolean
WhaTap::whatap_begin_step("Curl_Setopt_array", true);
// 내부 프로세스
...
// 종료 지점
WhaTap::whatap_end_step();
?>
PHP Agent 0.3.0
2017-10-17
업데이트
지원 환경이 추가 되었습니다.
-
PHP 5.2(NZTS, ZTS) 이상 버전에서 모니터링이 지원됩니다.
-
CentOS 6.x (64bit) 이상, Ubuntu 12.04 (64bit) 이상 버전에서 모니터링이 지원됩니다.
실시간 사용자 수를 측정하는 기능이 보완되었습니다.
PHP 기본 쿠키(PHPSESSID) 및 프레임워크 쿠키(ci_session, laravel_session) 를 기준으로 사용자를 구분합니다. 쿠키 사용을 설정하면 기본 쿠키가 없는 경우에 “WHATAP” 키를 쿠키에 추가하여 사용자를 구분할 수 있습니다.
whatap.trace_user_set_cookie=true쿠키를 사용하지 않는 환경에서 특정 HTTP 헤더 키를 가져와서 사용자를 구분할 수 있습니다.
whatap.trace_user_header_ticket=[HTTP Header Key]whatap.ini 에 해당 설정을 추가하고 서비스를 재시작하면 적용됩니다. (PHP 컴파일 설치로 php.ini 에 추가해야 할 수도 있습니다. )
버그
설치 문제를 보완하였습니다.
PHP 소스를 컴파일 하여 직접 설치하는 경우에, –with-config-file-scan-dir 옵션을 설정하지 않으면 추가 설정 파일(ini)을 로딩하는 기능이 적용되지 않습니다.
이 경우 설정파일(whatap.ini)을 복사하지 못하는 문제가 있습니다.
오류 문구는 다음과 같습니다.
PHP_INI_DIR=(none)
cp: cannot create regular file `(none)/whatap.ini': 그런 파일이나 디렉터리가 없습니다whatap.ini 내용을 분리하여 설정하도록 수정되었습니다. (설치 가이드 내용 중 수동 설치 항목)
PHP Extension 설정 내용은 PHP 기본 설정파일인 php.ini 에 추가되고, 그 외 설정은 /usr/whatap/php/whatap.ini 에 설정 됩니다.
PHP Agent 0.2.6
Python Agent Release Notes
Python Agent 0.1.94
2020-01-30 Agent download: https://pypi.org/project/whatap-python/0.1.94/
Python Agent 0.1.87
2019-09-19 Agent download: https://pypi.org/project/whatap-python/0.1.87/
Python Agent 0.1.81
2019-7-31 Agent download: https://pypi.org/project/whatap-python/0.1.81/
Python Agent 0.1.71
2018-12-10 Agent download: https://pypi.org/project/whatap-python/0.1.71/
SQL파라미터정보 조회 기능 추가
트랜잭션 프로파일 데이터에서 SQL파라미터정보를 보안키를 통하여 조회할 수 있습니다. whatap.conf 에 다음 옵션을 적용하면 외부 호출에 대한 파라미터를 조회할 수 있습니다. 추가된 옵션은 다음과 같습니다.
- profile_sql_param_enabled
-
Default : false
Type : Boolean
SQL 파라미터를 수집을 활성화합니다. 단 파라미터는 별도 보안키를 입력해야 조회할 수 있습니다. 보안 키는 에이전트 설치 경로의 paramkey.txt 파일에 6 자리로 지정합니다. paramkey.txt 가 존재하지 않는 경우 자동 생성되며 random 키가 설정됩니다.
HTTP-PARAMETERS 데이터 수집 기능 추가
트랜잭션 프로파일 데이터에서 HTTP-PARAMETERS 데이터를 수집하는 옵션이 추가되었습니다. whatap.conf 에 다음 옵션을 적용하면 외부 호출에 대한 파라미터를 조회할 수 있습니다. 추가된 옵션은 다음과 같습니다.
- profile_http_parameter_enabled
-
Default : false
Type : Boolean
http 파라미터를 프로파일링을 활성화합니다. 단 파라미터는 별도 보안키를 입력해야 조회할 수 있습니다. 보안 키는 에이전트 설치 경로의 paramkey.txt 파일에 6 자리로 지정합니다. paramkey.txt 가 존재하지 않는 경우 자동 생성되며 random 키가 설정됩니다.
URL의 쿼리 스트링을 함께 수집하는 기능 추가
트랜잭션 프로파일 데이터에서 URL의 쿼리 스트링을 함께 수집하는 옵션이 추가되었습니다. whatap.conf 에 다음 옵션을 적용하면 외부 호출에 대한 파라미터를 조회할 수 있습니다. 추가된 옵션은 다음과 같습니다.
- query_string_enabled
-
Default : false
Type : Boolean
트랜잭션 URL의 쿼리 스트링을 함께 수집하는 기능을 활성화합니다. - query_string_enabled
-
Default : false
Type : Boolean
트랜잭션 URL의 쿼리 스트링을 함께 수집하는 기능을 활성화합니다.
Server Agent Release Notes
Server Agent 1.3.0
Linux Agent Watch Dog 기능 추가
커널버그를 포함한 수집 대상서버의 상태가 일시적으로 비정상적인 경우 /proc/ 디렉토리 아래의 성능정보를 읽어오지 못하여 성능 정보 수집이 중단되는 현상이 있습니다. 일시적인 비정상 상태에서 모니터링 프로세스를 재시작하면 해당 현상이 개선되는 경우가 확인되었습니다. 일시적인 성능 정보 수집 이상에 대처하는 시스템 관리자의 업무부담을 줄이기 위해 Watch Dog 기능을 추가하였습니다. 업데이트 적용시 whatap_infrad 프로세스가 Watch Dog 모드 프로세스 및 데이터 수집모드 프로세스로 각각 작동합니다. Watch Dog 모드 프로세스는 데이터 수집모드 에이전트의 정상 작동 여부를 실시간으로 확인하여 데이터 수집기능에 문제가 발생하면 자동으로 프로세스를 재시작하여 데이터수집을 정상화 합니다. 와탭 서버 모니터링 설치 및 시작, 재시작, 정지 방법은 기존과 동일합니다.
업데이트 혹은 신규 설치시 아래 예시와 같이 Watch Dog 모드인 PID 19165(서버별로 다름) 프로세스 및 데이터 수집모드인 PID 19175(서버별로 다름) 프로세스를 확인하실 수 있습니다.
root 19165 1 0 10:04 ? 00:00:00 /usr/whatap/infra/whatap_infrad root 19175 19165 1 10:04 ? 00:00:00 /usr/whatap/infra/whatap_infrad foreground
두개의 프로세스는 unix socket /var/run/whatap_infrad.sock으로 통신합니다.
