본문으로 건너뛰기

설정하기

와탭 프로젝트에서 임의의 수집 데이터를 업로드할 수 있습니다. Focus는 해당 프로젝트의 기본 에이전트가 설치되지 않아도 사용할 수 있습니다.

프로젝트 액세스 키 및 수집 서버 IP 확인​

선택한 프로젝트의 관리 > 에이전트 설치 메뉴에서 프로젝트 코드, 수집 서버 IP와 프로젝트 액세스 키를 확인합니다.

export WHATAP_LICENSE=xxxx-xxxxxx-xxxxxx
export WHATAP_HOST=xxxx.xxxx.xxxx
export WHATAP_PCODE=xxx

필터를 위한 특정 태그 추가​

사용자가 필터를 위한 특정 문자열을 태그로 설정할 수 있습니다. 설정을 통해 와탭 모니터링 서비스 화면에서 수집된 데이터를 해당 태그의 이름 및 값으로 필터링할 수 있습니다.

SH
# -tag.[사용자 태그 키 이름][공백][사용자태그 값]

./focus -license $WHATAP_LICENSE \
    -pcode $WHATAP_PCODE -server.host $WHATAP_HOST \
    -tag.CustomTagName CustomTagValue \
    -tag.MyServer1 server_01 \
    ...

알림 보내기​

사용자 정의 알림을 즉시 보낼 수 있습니다. 알림을 보낸 후 Focus는 종료합니다.

SH
#알림의 심각도를 선택합니다.
level={info|warn|fatal}
#알림의 제목
title=원하는 알림의 제목
#알림의 본문
message=원하는 알림의 본문
./focus -license $WHATAP_LICENSE \
    -pcode $WHATAP_PCODE -server.host $WHATAP_HOST \
    -alert -level $level -title $title -message $message

SQL Query 결과 수집​

사용자 정의 SQL Query의 실행 결과를 시계열로 무기한 수집합니다.

SH
#매트릭 카테고리
category=my_category
#데이터 베이스 드라이버
driver={mysql|postgres}
#데이터베이스 접속 정보
dburl="아이디:패스워드@tcp(아이피:포트)/데이터베이스"
#Sql Query
sqlquery="select some, columns from sometable"
./focus -license $WHATAP_LICENSE \
    -category $category \
    -pcode $WHATAP_PCODE -server.host $WHATAP_HOST \
    -rdb $driver -rdb.connect $dburl \
    -rdb.sql $sqlquery

로그 파일 키워드 매칭 로그 수집​

지정한 텍스트 로그 파일에서 로그 발생 시 키워드를 포함하면 해당 로그 라인을 수집합니다.

SH
#매트릭 카테고리
category=my_category
#로그 파일
LOG_FILE=로그 파일 경로
#2개 이상의 로그 키워드를 입력할때 키워드 사이에 사용할 구분자
LOG_KEYWORDS_SEPERATOR=,
#로그 키워드를 ,로 연결하여 입력
LOG_KEYWORDS=keyword1,keyword2
./focus -license $WHATAP_LICENSE \
    -category $category \
    -pcode $WHATAP_PCODE -server.host $WHATAP_HOST \
    -tail $LOG_FILE \
    -tail.keys $LOG_KEYWORDS \
    -tail.seperator $LOG_KEYWORDS_SEPERATOR

와탭 로그 분석 서비스​

지정한 텍스트 로그 파일에서 로그 발생 시 와탭 로그 분석 서비스로 실시간 업로드합니다.

SH
#카테고리
category=my_category
#로그 파일 wildcard(*), 날짜패턴(http://strftime.org) 포함 가능
LOG_FILE=로그 파일 경로
./focus -license $WHATAP_LICENSE \
    -category $category \
    -pcode $WHATAP_PCODE -server.host $WHATAP_HOST \
    -logsink $LOG_FILE

OS 자원 사용량 수집​

Focus가 작동 중인 서버의 자원 사용량을 수집합니다.

Linux Shell
#매트릭 카테고리
category=my_category
#디스크 모니터링 활성화 여부
diskenabled=true|false
#모니터링할 디스크 마운트
diskmount=/mypartition
#NIC 모니터링 활성화 여부
nicenabled=true|false
#모니터링할 NIC
nic=eth0

./focus -license $WHATAP_LICENSE \
    -category $category \
    -pcode $WHATAP_PCODE -server.host $WHATAP_HOST \
    -sys \
    -sys.disk.enabled $diskenabled \
    -sys.disk $diskmount \
    -sys.net.enabled $nicenabled \
    -sys.net $nic

임의 프로그램 및 스크립트 실행 결과 수집​

임의의 프로그램 및 스크립트를 실행하고 stdout으로 출력되는 결과를 지속적으로 수집합니다. 와탭 Focus는 json dictionary 형식으로 stdin으로 입력되면 해당 dictionary의 key, value를 수집합니다. 입력 수단으로 파이프를 사용하게 되므로 버퍼링을 사용하지 않도록 설정하는 것이 필요합니다.

노트
  • 지속적으로 수집하는 것이 아니라 일회성으로 수집하기 원하면 다음 옵션을 적용할 수 있습니다. -onetime
  • 수집 시간을 지정하고 싶으면 다음 옵션으로 지정할 수 있습니다. -now {unix epoch time(second)}
Linux Shell
#매트릭 카테고리
CATEGORY="my_category"


프로그램 혹은 스크립트 | \
json dictionary 형태로 재가공 | \
./focus -license $WHATAP_LICENSE \
    -category $category \
    -pcode $WHATAP_PCODE -server.host $WHATAP_HOST

다음 예시는 top 명령을 실행하여 특정 프로세스의 CPU, memory 사용량을 계속하여 수집합니다.

Linux Shell
#매트릭 카테고리
CATEGORY="my_category"

export PID=수집하기 원하는 프로세스의 PID
top -b -p $PID | awk '/'$PID'/{ printf "{\"pid\": %s, \"cpuPercent\": %s, \"memoryPercent\": %s, \"cmd\": \"%s\"}\n",$1, $9, $10, $12}; system("")' | \
./focus -license $WHATAP_LICENSE \
    -pcode $WHATAP_PCODE -server.host $WHATAP_HOST \
    -category $CATEGORY