고급 기능

서버명 임의 부여와 관리

에이전트는 애플리케이션 서버 종류와 애플리케이션 서버의 IP, 서비스 포트를 사용하여 자동으로 서버명을 부여합니다.

애플리케이션명 지정 옵션

기본 패턴 변경은 whatap.conf에서 설정 가능합니다.

object_name default: {type}-{ip2}-{ip3}-{process}

애플리케이션명 패턴

프로젝트에 등록된 애플리케이션 서버별로 동일한 이름이 사용되면 안 됩니다. 서버명을 고정으로 사용하지 마세요. Internal ip address로 인해 서버 IP가 중복되는 경우는 애플리케이션 서버명을 그룹 단위로 패턴화하여 적용할 수 있습니다.

패턴 옵션

설정	설명
type	app_name
ip#	Ip를 .으로 나누었을 때 #번째 자리(0부터)
process	app_process_name
hostname	호스트 명

Open File Descriptor 사용량 수집

Python 웹 애플리케이션에서 Open File Descriptor 사용량을 모니터링하는 것은 시스템 자원 관리에 필수적입니다. 파일 디스크립터는 시스템에서 동시에 열 수 있는 파일의 수를 제한하는 중요한 리소스이므로, 사용량이 한계에 도달하면 애플리케이션에서 새로운 파일을 열 수 없게 되어 오류가 발생할 수 있습니다. 이러한 문제는 특히 멀티스레드 및 멀티프로세스 환경에서 빈번하게 발생합니다.

또한 파일 디스크립터 누수 발생 시 자원 고갈로 인해 시스템 성능이 저하되고 안정성이 손상될 수 있습니다. 이 기능은 파일 디스크립터 사용량을 모니터링하여 사용량이 높은 시점을 파악하고, 필요시 파일 디스크립터 한계를 증가시키거나 누수를 해결할 수 있도록 돕습니다.

노트

요구 사항

와탭 Python 에이전트 1.7.2 버전 이상이 필요합니다.

활성화 옵션

다음 예시를 참조하여 whatap.conf 파일을 수정하세요.

#수집 기능 on/off 설정
open_file_descriptor_enabled=true

#수집 주기 설정으로 생략 시 기본값 60초
open_file_descriptor_interval=60

수집 메트릭스

이름	설명
current_nofile_pct	현재 Open File Descriptor 사용량 비율(%)
currnet_nofile	현재 Open File Descriptor 개수
max_nofile	프로세스의 최대 Open File Descriptor 허용 개수
pid	프로세스 ID

AES 256 암호화 적용

와탭 애플리케이션 모니터링 에이전트는 수집된 데이터를 암호화하여 서버로 전송합니다. 데이터의 중요도나 설정에 따라 이를 변경할 수 있습니다.

기본적으로 XOR 연산과 AES 알고리즘을 통한 암호화를 사용합니다. 평문을 128비트 단위로 나누어 암호화, 복호화를 수행합니다. 사용자의 설정에 따라 256비트까지 확장할 수 있습니다.

1. 설정하기

   에이전트가 설치된 디렉터리에서 whatap.conf 파일에 다음과 같은 설정을 추가하세요.

   whatap.conf

   license={액세스 키}
   whatap.server.host={수집 서버 IP}
   cypher_level=256

2. 다시 시작하기

   설정을 추가한 후 WAS를 다시 시작합니다.

제약 사항

복수 리전을 단일 프로젝트로 선택 불가

와탭 모니터링 서비스에서 프로젝트 생성 시 지역(Region)은 중복 선택이 불가하며 복수의 지역을 활용하는 경우 별도의 프로젝트를 생성해야 합니다.

클라우드 환경과 같이 복수의 지역에 서버가 존재한다면, 네트워크 latency 등 성능 정보 수집 상의 제약 사항을 회피하기 위해 지역 단위로 수집 서버를 위치시켜야 합니다. 와탭은 고객 요구 사항에 부응하기 위하여 지역 별로 수집 서버를 구축합니다.

에이전트 이름(ONAME) 중복 사용 불가

와탭 애플리케이션 모니터링은 에이전트의 식별을 위한 용도로 에이전트의 IP 주소와 Port 정보를 활용합니다. 만약 사용자 환경의 모니터링 대상 애플리케이션 서버가 동일 IP, 동일 Port를 사용하는 경우 와탭 서버에서 해당 서버 인스턴스를 구분할 수 없게 됩니다.

서버 인스턴스가 동적으로 확장되는 환경이 아니라면 다음 문서를 참고하여 애플리케이션 식별을 위한 명칭을 직접 지정하는 방식을 통해 우회할 수 있습니다.

모니터링 대상 애플리케이션이 internal address 또는 네트워크 가상화로 인해 중복된 IP를 사용할 경우 다음 문서를 참고하여 별도의 애플리케이션명 패턴을 활용합니다.