본문으로 건너뛰기

에이전트 이름 식별

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

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

주의
  • 에이전트 이름은 프로젝트 단위로 고유해야 합니다.
  • 에이전트 아이디/이름을 변경하면 이전 데이터와 연결되지 않습니다.
노트
  • 와탭 모니터링 서비스에서는 모니터링 대상을 오브젝트 또는 에이전트로 혼용해서 사용합니다.

기본 이름 결정 방식​

JVM 옵션으로 whatap.oname 설정이 없는 경우 에이전트 이름을 다음과 같은 우선 순위로 자동 부여합니다.

  1. whatap.type을 식별합니다.
  2. whatap.type이 서블릿 컨테이너면 애플리케이션이 사용하는 포트를 식별합니다.
  3. 포트를 식별할 수 없다면 process ID(PID)를 검색합니다.
  4. 식별한 정보에 IPv4 주소 3, 4번째를 추가해 최종 이름을 결정합니다.

예를 들어, IP 주소가 10.11.12.13인 서버에서 Tomcat이 8080 포트로 시작한 경우 TC-12-13-8080 명칭으로 에이전트 이름을 자동 부여합니다.

에이전트 이름 변수​

사용할 수 있는 이름 변수를 다음과 같이 제공합니다.

변수설명
문자열입력한 문자열을 사용합니다.
{type}컨테이너 타입을 자동 식별해 부여합니다.
자동 식별 대상: JAVA, TOMCAT, JBOSS, RESIN, SPRINGBOOT, JETTY, JEUS, WEBLOGIC, WEBSPHERE, UNDERTOW, PLAY
{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)
{pid}Java의 Process ID(PID)를 사용합니다.
{port}애플리케이션이 Listen 하는 포트를 사용합니다.

에이전트 이름 설정​

시작 스크립트에 JVM 옵션을 추가해 자동으로 부여한 이름 대신 직접 이름을 설정할 수 있습니다.

옵션설정 위치설명
-Dwhatap.nameJVM Options에이전트 이름을 패턴으로 설정합니다.
기본값 {type}-{ip2}-{ip3}-{port}
-Dwhatap.onameJVM Options에이전트 이름을 고정값으로 설정합니다.
-Dwhatap.oname=java-sales-01
옵션을 설정하지 않으면 -Dwhatap.name 옵션에 설정된 패턴으로 적용됩니다.
팁

IP 주소가 10.11.12.13이고, 포트 번호가 8000인 환경에서

  • -Dwhatap.oname 옵션을 적용하지 않은 경우: whatap.oname은 -Dwhatap.name에 설정된 패턴에 따라 JAVA-12-13-8000으로 기본 설정됩니다.

  • -Dwhatap.oname 옵션을 적용한 경우: -Dwhatap.name 옵션을 무시하고 -Dwhatap.oname 옵션에 설정한 값으로 에이전트 이름이 적용됩니다.

노트
  • 클라우드의 Scale Out 환경에서는 VM이 복사되어 사용될 수 있습니다. 따라서 오브젝트 이름이 자동 부여되는 것이 중요합니다.
  • 만약 2개의 VPC 환경을 만들고 동일한 private IP를 사용하도록 네트워크를 구성한 경우 두 개의 VPC가 중복되면 안 됩니다. 예를 들어, 별도의 프로젝트로 분리하거나 -Dwhatap.name 옵션과 이름 변수를 서로 다른 방식으로 조합해 설정할 수 있습니다.

다음은 whatap.conf 파일에 에이전트 이름으로 적용할 수 있는 옵션입니다.

  • whatap.name String

    기본값 {type}-{ip2}-{ip3}-{port}

    에이전트 이름을 패턴으로 설정합니다.

  • whatap.okind String

    에이전트가 속한 그룹 단위를 설정합니다. 여러 에이전트를 같이 설정해 해당 그룹명으로 토폴로지를 확인할 수 있습니다.

  • whatap.onode String

    에이전트가 속한 노드 단위를 설정합니다.

  • auto_oname_enabled Boolean

    기본값 false

    서버에 등록할 에이전트 이름(whatap.oname)을 서버로부터 자동 부여받는 기능을 활성화합니다. 해당 옵션 적용 시 JVM 옵션으로 설정한 -Dwhatap.name, -Dwhatap.oname 값은 무시합니다. 수집 서버와의 통신을 통해 whatap.oname 값을 부여 받은 다음 에이전트의 일반적인 동작을 시작합니다.

  • auto_oname_prefix String

    기본값 agent

    에이전트 이름을 서버로부터 자동 부여할 때 에이전트 이름의 prefix, 보통 업무명을 사용합니다. prefix 일련번호 '1~)'을 부여합니다.

    노트

    에이전트 이름을 자동으로 부여하는 auto_oname_enabled 옵션이 활성화 상태여야(true) 해당 옵션을 사용할 수 있습니다.

  • auto_oname_reset Int

    기본값 0

    서버로부터 새로운 에이전트 이름을 부여받기 위해 수정합니다. 에이전트 이름을 자동 부여하면 whatap.oname이라는 시스템 환경 변수로 설정됩니다. 한번 정해진 시스템 환경 변수는 자바 인스턴스가 다시 시작할 때까지 유지합니다. 리셋을 원할 때 auto_oname_reset 값을 수정하세요. 현재 설정 값과 다른 값으로 변경하면 적용됩니다.