에이전트 설정
와탭 에이전트는 에이전트 별 필요한 설정을 whatap.conf 파일에 작성합니다. 에이전트는 환경변수를 통해 설정 파일의 위치를 파악하고 로딩합니다.
별도 설정이 없는 경우 에이전트는 자기 자신(whatap.agent-X.Y.Z.jar)이 위치한 디렉터리에서 whatap.conf 파일을 찾도록 구현했습니다. 5초에 한번씩 whatap.conf 파일의 변경 여부를 체크하고 리로딩합니다.
사용자의 편의성을 위해 와탭 모니터링 서비스에서도 에이전트 설정 기능을 제공하고 있습니다.
기본 설정
whatap.home=.
whatap.config=whatap.conf
-
whatap.home
: 기본값은 whatap.agent.jar 파일의 경로를 입력하세요. -
whatap.config
: 파일명만 입력할 것을 권고합니다. 상대 패스를 같이 입력할 수는 있습니다.
에이전트가 데이터를 수집하고, 서버로 데이터를 전송하기 위해서는 최소한 액세스 키와 서버 주소는 설정돼 있어야 합니다.
license=x220g160hgd29-x3qpff0garcus7-z4p0kao58un11a
whatap.server.host=10.10.0.1
와탭 에이전트는 최초 실행시 다음과 같이 어떤 jar 파일이 에이전트로 사용됐는지, 어떤 경로에서 whatap.conf 파일을 로딩하는지 확인할 수 있습니다.
서버 연결 및 데이터전송
와텝 에이전트는 whatap.conf 파일에 설정한 서버 주소로 연결합니다.
whatap.server.host=10.10.1.1
whatap.server.port=6600 # 기본값
- TCP 세션을 연결하면
license
를 이용해 서버로부터 통신키를 전달 받습니다. 잘못된license
를 설정하면 서버는 세션을 종료합니다. - TCP 연결이 반복적으로 종료되면 방화벽 문제 확인하거나
license
값이 올바른지 확인하세요. - TCP 세션을 연결하면 서버로부터 받은 비밀키를 기반으로 보안 통신으로 데이터를 전송합니다.
여러 애플리케이션 서버의 설정 파일 관리
한 서버에 여러 애플리케이션을 운영할 경우, 각 애플리케이션 별 설정 파일을 별도로 관리하려면 whatap.conf 파일명을 변경하고 시작 스크립트에 JVM 옵션을 추가하세요.
-Dwhatap.config=whatap_Aservice.conf
-Dwhatap.config=whatap_Bservice.conf
whatap.conf 설정 파일은 반드시 ${WHATAP_HOME}
경로에 위치해야 합니다.
서비스 화면에서 에이전트 설정하기
홈 화면 > 프로젝트 선택 > 관리 > 에이전트 설정
모니터링 대상 서버에 위치한 whatap.conf 파일을 직접 수정하지 않고 와탭 모니터링 서비스에서 에이전트 설정 옵션을 추가하거나 수정, 삭제할 수 있습니다.
-
이 기능은 수정 권한을 가진 멤버만 이용할 수 있습니다. 수정 권한이 없는 멤버는 설정 내용을 조회만 할 수 있습니다.
-
옵션 값으로 설정할 수 있는 형식은 다음과 같습니다.
- Boolean 형식의 값은
true
또는false
를 선택하세요. - 숫자 형식의 값은 숫자만 입력할 수 있습니다.
- 텍스트(String) 형식의 값을 입력 또는 수정할 경우 옵션 셜명을 자세히 확인하세요.
- Boolean 형식의 값은
-
수정할 수 없는 옵션은 선택할 수 없습니다. (예,
license
) -
추가 또는 수정, 삭제한 옵션에 따라 에이전트를 재시작해야할 수 있습니다.
-
애플리케이션 종류 및 에이전트의 버전에 따라 적용할 수 있는 옵션 키는 다를 수 있습니다.
옵션 추가하기
-
에이전트 목록에서 옵션을 추가하려는 에이전트를 선택하세요.
-
옵션 작성에서 추가할 옵션 항목을 선택하세요.
- 검색에서 추가할 옵션을 찾을 수 있습니다. 텍스트를 입력하면 일치하는 옵션을 필터링합니다.
- 직접 입력을 선택하면 옵션 키와 값을 입력할 수 있습니다.
-
선택한 옵션 키에 대한 설명과 기본값을 확인한 다음 설정값을 입력하세요.
- 선택한 옵션을 취소하려면 버튼을 선택하세요.
- 옵션을 추가 설정하려면 + 추가하기 버튼을 선택하고 2번의 과정을 반복하세요.
-
원하는 모든 옵션을 추가했으면 화면 오른쪽 위에 적용 버튼을 선택하세요.
선택한 옵션 및 설정값을 에이전트에 적용합니다.
- 수정 중인 내용을 초기화하려면 화면 오른쪽 위에 버튼을 선택하세요.
- 옵션값으로 아무것도 입력하지 않은 상태에서 적용 버튼을 선택하면 해당 옵션을 삭제합니다.
- 이미 추가한 옵션은 옵션 목록에서 선택할 수 없습니다.
- 애플리케이션 종류 및 에이전트의 버전에 따라 적용할 수 있는 옵션 키는 다를 수 있습니다.
- 예시로 제공한 이미지는 애플리케이션 종류 및 에이전트에 따라 다를 수 있습니다.
옵션 수정 또는 삭제하기
-
화면을 위 또는 아래로 스크롤하거나 왼쪽의 옵션 목록에서 수정 또는 삭제하려는 옵션을 선택하세요.
-
변경하려는 옵션에서 원하는 값을 선택하거나 수정하세요. 옵션을 삭제하려면 버튼을 선택하세요.
-
변경한 사항을 적용하려면 적용 버튼을 선택하세요.
-
화면 가장 위로 이동하려면 옵션 추가로 이동 버튼을 선택하세요.
-
옵션값으로 아무것도 입력하지 않은 상태에서 적용 버튼을 선택하면 해당 옵션을 삭제합니다.
여러 에이전트에 동시 적용하기
프로젝트에 소속된 여러 개의 에이전트에 변경한 옵션을 동시에 적용할 수 있습니다.
-
화면 오른쪽 위에 다중 에이전트 적용 체크박스를 선택하면 각 옵션 항목에 체크박스가 생성됩니다.
-
동시에 적용하길 원하는 옵션의 체크박스를 선택하세요. 여러 개를 선택할 수 있습니다.
-
화면 오른쪽 위에 적용 버튼을 선택하세요.
-
에이전트 적용 창이 나타나면 변경한 옵션을 적용할 에이전트를 선택하세요. 모두 선택하려면 전체 선택 체크박스를 선택하세요.
-
적용 버튼을 선택하세요.
에이전트 기본값 설정하기
프로젝트에 새로운 에이전트를 추가할 경우 기존의 설정값을 반복해서 적용하는 번거로움을 피하고 싶다면 프로젝트별, 업무별 기본 설정값을 만들어 적용할 수 있습니다.
업무 디폴트: whatap.conf 파일에서
whatap.okind
항목으로 분류한 에이전트들에 옵션을 공통 적용할 수 있고, 적용된 옵션을 확인할 수 있습니다.프로젝트 디폴트: 프로젝트에 소속된 모든 에이전트들에 옵션을 공통 적용할 수 있고, 적용된 옵션을 확인할 수 있습니다.
-
업무 디폴트 또는 프로젝트 디폴트 탭을 선택한 다음 옵션을 적용하는 것은 에이전트를 공통으로 관리하는 데 유용합니다.
-
옵션의 적용 우선 순위는 업무 디폴트, 프로젝트 디폴트, 에이전트 설정 순입니다.
- 프로젝트 디폴트에서 b 옵션값을 1000을 적용하고, 업무 디폴트에서 b 옵션값을 2000으로 적용하면, 업무 디폴트에서 설정한 옵션값 2000을 우선 적용합니다.
- 프로젝트 디폴트에서 b 옵션값을 아무것도 입력하지 않았고 업무 디폴트에 b 옵션값에 2000이 적용된 경우에도 업무 디폴트에서 설정한 옵션값을 우선 적용합니다.
에이전트 설정 공유하기
에이전트 설정 내용을 json 형식의 파일로 저장하고 파일을 불러와 다른 에이전트에 적용할 수 있습니다.
-
에이전트 목록에서 설정 내용을 json 파일로 내보낼 에이전트를 선택하세요.
-
화면 오른쪽 위에 버튼을 선택하세요.
-
json 파일을 다운로드하세요.
-
에이전트 목록에서 다른 에이전트를 선택하세요.
-
화면 오른쪽 위에 버튼을 선택하세요.
json 파일을 통해 가져온 에이전트 설정을 확인하세요.
에이전트 설정 옵션 안내
다음 링크를 통해 설정할 수 있는 옵션들에 대한 설명을 제공합니다.
에이전트 이름 식별
모니터링 대상을 구별하기 위한 애플리케이션 서버의 고유 식별자 설정에 대해 안내합니다. 모니터링 대상 시스템 내에서 애플리케이션 서버를 정확히 구분하는 데 필수적입니다. 서버 유형, IP 등의 정보를 기반으로 한 자동 이름 지정 방식과 사용자가 직접 whatap.conf 파일이나 JVM 옵션을 통해 에이전트 이름을 설정하는 방법을 확인할 수 있습니다.
에이전트 기능 제어
자바(Java) 애플리케이션 서버의 모니터링을 위한 에이전트 기능을 세밀하게 조정하는 방법을 안내합니다. 에이전트의 활성화/비활성화, 트랜잭션 및 성능 카운터 추적, OS 정보 수집 등의 기능을 포함하며, 각 기능을 제어하는 다양한 설정 옵션들에 대해 확인할 수 있습니다.
CPU/메모리/디스크 사용량 수집
자바(Java) 에이전트가 CPU, 메모리, 디스크 사용량을 수집하는 방법을 안내합니다. 자바(Java)의 JMX 라이브러리를 기본적으로 활용하며, 필요에 따라 Linux의 proc 디렉터리나 oshi, sigar 라이브러리를 통한 성능 지표 수집 방법을 확인할 수 있습니다.
에이전트 통신 설정
자바(Java) 에이전트가 애플리케이션 서버로부터 수집한 데이터를 서버로 전송하기 위한 네트워크 설정 방법을 안내합니다. 주요 설정 옵션으로는 수집 서버 호스트, 포트, 타임아웃 값, 네트워크 전송 크기, 데이터 전송 큐 크기 등이 있으며, 에이전트의 효율적인 데이터 관리 및 안정적인 서버 통신을 보장하는 데 중요합니다.