본문으로 건너뛰기

에이전트 이름 식별

에이전트 이름 식별​

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

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

주의
  • 에이전트 이름은 프로젝트 단위로 고유해야 합니다.
  • 에이전트 아이디/이름을 변경하면 이전 데이터와 연결되지 않습니다.

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

Default pattern
NODE-{ip2}-{ip3}
Cluster environment
NODE{cluster}-{ip2}-{ip3}

에이전트 이름 변수​

변수설명
{type}애플리케이션 유형 이름(NODE)입니다.
{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}애플리케이션 Process Id 입니다.
{hostname}호스트 이름입니다.
{cluster}한 서버에 여러 Node.js가 동작할 때의 클러스터 id입니다.

에이전트 이름 패턴 변경​

환경 변수를 통해 와탭 에이전트 이름을 변경할 수 있습니다. 애플리케이션의 메인 모듈 파일의 최상단에 다음과 같이 코드를 추가하세요.

process.env.WHATAP_NAME = "NODE-{ip2}-{ip3}";
var whatap=require('whatap').NodeAgent;
...

서버에서 에이전트 네이밍​

에이전트 환경을 기반으로 이름을 결정하는 것이 아니라 서버에서 이름을 자동 부여하는 방식입니다. Node.js 서버가 컨테이너나 PaaS 환경에서 동작하는 경우에 활용합니다.

whatap.conf
auto_oname_enabled=true
auto_oname_prefix=nodejs
Set the .env(app.js)
process.env.WHATAP_LICENSE='x46n3226be1ah-z2rsecfcvlq2ph-z11bc81gfhqpgg';
process.env.WHATAP_SERVER_HOST='52.78.209.94/52.78.224.235';

process.env.auto_oname_enabled=true;
process.env.auto_oname_prefix='mynode';

var whatap=require('whatap').NodeAgent;
...
노트
  • env에 설정하려면 require('whatap')보다 먼저 선언되어야 합니다.
  • Heroku 환경에서는 서버를 다시 시작할 때마다 IP 주소를 변경하기 때문에 새로운 이름으로 변경됩니다.

auto_oname_prefix 옵션은 에이전트 이름의 prefix입니다. 와탭 서버는 auto_oname_prefix 옵션에 설정한 이름과 일련 번호를 합하여 에이전트 이름을 부여합니다.

부여한 에이전트 이름 예시, mynode1

에이전트 이름 설정 옵션​

Node.js 에이전트 이름 설정에 관한 자세한 설명은 다음 문서를 참조하세요.

  • whatap.okind String

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

  • whatap.onode String

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

  • auto_oname_enabled Boolean

    기본값 false

    서버에 등록할 에이전트 이름을 서버로부터 자동 부여받는 기능을 활성화합니다.

  • auto_oname_prefix String

    기본값 agent

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

  • auto_oname_reset Int

    기본값 0

    서버로부터 새로운 에이전트 이름을 부여받기 위해 수정합니다. 한번 정해진 에이전트 이름은 Node.js가 다시 시작할 때까지 유지합니다. 리셋을 원할 때 auto_oname_reset 값을 수정하세요. 현재 설정 값과 다른 값으로 변경하면 적용됩니다.