본문으로 건너뛰기

설정하기

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

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

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

SH
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
최종 수정: