본문으로 건너뛰기

에이전트 이름 식별

와탭은 모니터링 정보 수집 대상인 애플리케이션 서버 식별을 위한 정보로 기본적으로 애플리케이션 서버로부터 수집한 정보를 활용합니다. 기본 활용 정보는 애플리케이션 서버의 종류, IP 주소 등을 조합해 애플리케이션 서버를 고유 식별자로 사용합니다. 필요에 따라 사용자가 설정한 명칭을 이용하거나 패턴을 변경해 고유한 값으로 변경해 이용합니다. 에이전트의 이름은 반드시 고유한 값이어야 합니다.

애플리케이션 서버로부터 추출한 정보를 활용하는 이유는 애플리케이션 서버 정지 또는 네트워크 단절, 에이전트 문제로 인한 수집 서버와 에이전트의 통신 두절 상태가 복구되었을 경우, 재접속된 에이전트로부터 송신되는 정보가 기존 에이전트로부터 송신된 정보와의 연속성을 유지하기 위해서입니다.

에이전트 이름 결정 방식​

와탭 에이전트가 애플리케이션 서버를 식별하기 위해 사용하는 기본 패턴은 다음과 같습니다.

Default pattern
{type}-{ip2}-{ip3}-{cmd}-{cmd_full}

기본 패턴 값을 변경하려면 whatap.conf 파일을 다음과 같이 수정하세요.

whatap.conf
object_name={type}-{ip2}-{ip3}-{process}-{dockerid}-{ips}

에이전트 이름 변수​

변수설명
{type}애플리케이션 서버의 이름(app_name)입니다.
{ip0}IPv4 주소 중 첫 번째 단위를 사용합니다. (예시, 10.11.12.13 중 10)
{ip1}IPv4 주소 중 두 번째 단위를 사용합니다. (예시, 10.11.12.13 중 11)
{ip2}IPv4 주소 중 세 번째 단위를 사용합니다. (예시, 10.11.12.13 중 12)
{ip3}IPv4 주소 중 네 번째 단위를 사용합니다. (예시, 10.11.12.13 중 13)
{process}애플리케이션 서버의 프로세스 이름(app_process_name)입니다.
{hostname}호스트 이름입니다.
{dockerid}도커 컨테이너의 아이디입니다.
{ips}전체 아이피 정보입니다. (ip4, ip6)
{cmd}프로세스 이름입니다. 실행 args[0] 값입니다.
{cmd_full}실행 명령어의 모든 라인을 해시값으로 처리합니다. 실행 args 전체입니다.

에이전트 이름 설정​

  • object_name String

    기본값 {app_name}-{ip2}-{ip3}-{cmd}-{cmd_full}

    애플리케이션을 식별하기 위한 에이전트 이름(ONAME) 구성 방식입니다. ONAME을 토대로 OID가 생성됩니다.

  • app_name String

    애플리케이션을 식별하기 위한 에이전트 이름(ONAME)의 구성 요소입니다. object_name 옵션 중 {type}에 해당합니다.