본문으로 건너뛰기

설정하기

와탭 에이전트는 에이전트 별 필요한 설정을 whatap.conf 파일에 작성합니다. 에이전트는 환경변수를 통해 설정 파일의 위치를 파악하고 로딩합니다. whatap.conf 파일을 통해 설정할 수 있는 옵션은 다음과 같습니다.

노트

Telegraf 에이전트는 사용자가 직접 설정해야 합니다.

에이전트 이름 식별

와탭은 모니터링 정보 수집 대상인 인프라 서버 식별을 위해 기본적으로 서버로부터 수집한 정보를 활용합니다.

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

    기본값 {type}-{hostname}-{ip2}-{ip3}-{docker}

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

    명칭설명
    {type}app_name에 설정된 값을 사용합니다. 기본값은 Telegraf입니다.
    {ip#}IP를 나누었을 때 #번째 자리를 사용합니다.
    {hostname}서버 호스트명을 사용합니다.
    {docker}도커 컨테이너 아이디를 사용합니다.
  • app_name String

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

    노트

    whatap-telegraf 서비스를 다시 시작 후 적용됩니다.

에이전트 통신 설정

  • license String

    에이전트를 설치할 때 서버로부터 부여받은 프로젝트 액세스 키를 설정합니다. 프로젝트 액세스 키에는 에이전트가 속한 프로젝트와 보안 통신을 위한 암호 키를 포함하고 있습니다.

  • whatap.server.host ip_address

    기본값 127.0.0.1,127.0.0.1

    에이전트가 수집한 데이터를 전송할 서버를 지정합니다. 수집 서버 이중화로 2개 이상의 IP를 가진 경우 콤마(,)로 분리하여 지정할 수 있습니다. 지정된 IP에는 수집 서버 proxy 데몬이 리스닝 상태로 서비스되어야 합니다.

  • whatap.server.port tcp_port

    기본값 6600

    수집 서버 PORT를 지정합니다. 포트는 하나만 지정할 수 있으므로 whatap_server_host에 지정된 수집 서버들은 동일 PORT를 사용해야 합니다.

  • tcp_so_timeout Millisecond

    기본값 60000

    수집 서버와 통신하는 TCP 세션의 Socket Timeout 값을 지정합니다.

  • tcp_connection_timeout Millisecond

    기본값 5000

    수집 서버와 통신하는 TCP 세션의 Connection Timeout 값을 지정합니다.

  • net_send_max_bytes Byte

    기본값 5242880

    수집 서버로 데이터를 전송할 때 한번에 전송되는 최대 크기를 지정합니다.

  • net_send_buffer_size Byte

    기본값 1024

    데이터 전송을 하기 위해 가지고 있는 최대 바이트 크기입니다.

Telegraf

  • telegraf_tcp_port tcp_port

    기본값 6600

    Telegraf socker_writer output plugin이 연결할 TCP Port입니다.

    노트

    whatap-telegraf 서비스를 다시 시작 후 적용됩니다.

  • telegraf_delta_fields String

    기본값 1024

    누적값을 가지는 필드의 증가 값을 계산하여 별도의 필드를 추가합니다. name.fields 형식으로 지정하고, 여러 개는 콤마(,)로 구분합니다.

    예, nginx.accepts, nginx.requests nginx의 accepts, requests 값의 증가 값을 acceptsDelta, requestsDelta 필드 이름으로 추가 전달합니다.

로그

  • log_keep_days Day

    기본값 7

    로그 파일 보관 기간을 설정 합니다.