설정방법

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

라이선스 및 수집 서버 IP 확인

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

Linux Shell
export WHATAP_LICENSE=xxxx-xxxxxx-xxxxxx
export WHATAP_HOST=xxxx.xxxx.xxxx
export WHATAP_PCODE=xxx
Windows Powershell
$WHATAP_LICENSE=xxxx-xxxxxx-xxxxxx
$WHATAP_HOST=xxxx.xxxx.xxxx
$WHATAP_PCODE=xxx

알림 보내기

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

Windows Powershell
#알림의 심각도를 선택합니다.
$level="{info|warn|fatal}"
#알림의 제목
$title="원하는 알림의 제목"
#알림의 본문
$message="원하는 알림의 본문"
.\focus.exe -license $WHATAP_LICENSE `
    -pcode $WHATAP_PCODE -server.host $WHATAP_HOST `
    -alert -level $level -title $title -message $message
Linux Shell
#알림의 심각도를 선택합니다.
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 의 실행 결과를 시계열로 무기한 수집합니다.

Windows Powershell
#매트릭 카테고리
$CATEGORY="my_category"
#데이터 베이스 드라이버
$driver="{mysql|postgres}"
#데이터베이스 접속 정보
$dburl="아이디:패스워드@tcp(아이피:포트)/데이터베이스"
#Sql Query
$sqlquery="select some, columns from sometable"

.\focus.exe -license $WHATAP_LICENSE `
    -pcode $WHATAP_PCODE -server.host $WHATAP_HOST `
    -category $CATEGORY `
    -rdb $driver -rdb.connect $dburl `
    -rdb.sql $sqlquery
Linux Shell
#매트릭 카테고리
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

로그파일 키워드 매칭시 로그 수집하기

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

Windows Powershell
#매트릭 카테고리
$CATEGORY="my_category"
#로그파일
LOG_FILE=로그파일 경로
#2개 이상의 로그 키워드를 입력할때 키워드 사이에 사용할 구분자
LOG_KEYWORDS_SEPERATOR=,
#로그 키워드를 구분자로 연결하여 입력
LOG_KEYWORDS=keyword1,keyword2

.\focus.exe -license $WHATAP_LICENSE `
    -pcode $WHATAP_PCODE -server.host $WHATAP_HOST `
    -category $CATEGORY `
    -tail $LOG_FILE `
    -tail.keys $LOG_KEYWORDS `
    -tail.seperator $LOG_KEYWORDS_SEPERATOR
Linux Shell
#매트릭 카테고리
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

와탭 로그 분석 서비스

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

Windows Powershell
#카테고리
$CATEGORY="my_category"
#로그파일 wildcard(*), 날짜패턴(http://strftime.org) 포함 가능
$LOG_FILE=로그파일 경로
.\focus.exe -license $WHATAP_LICENSE `
    -pcode $WHATAP_PCODE -server.host $WHATAP_HOST `
    -category $CATEGORY `
    -logsink $LOG_FILE
Linux Shell
#카테고리
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