설정하기
와탭 에이전트는 에이전트 별 필요한 설정을 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
로그 파일 보관 기간을 설정 합니다.