수집 서버 설치
플로우캣 에이전트와 통신하며 데이터를 수집할 수 있는 서버를 설치합니다.
수집 서버 설정 예제
flowkat.conf
$ cd /app/flowkat/collect.server/conf
$ vi flowkat.conf
object_inactive_alert_level=0
object_deadtime_ms=8000
net_tcp_listen_port=6100
net_udp_listen_port=6100
db_dir=./database
logs=./logs
수집 서버 설정 파일은 /app/flowkat/collect.server/conf/flowkat.conf 파일이고, key=value 양식으로 추가합니다.
네트워크 설정값
| Key | 기본값 | 실시간 설정 지원 여부 | 설명 |
|---|---|---|---|
| net_udp_listen_port | 6100 | X | UDP Port |
| net_tcp_listen_port | 6100 | X | TCP Port |
디렉터리 설정값
| Key | 기본값 | 실시간 설정 지원 여부 | 설명 |
|---|---|---|---|
| db_dir | ./database | X | 데이터베이스 저장 경로 |
| log_dir | ./logs | X | Log 저장 경로 |
데이터베이스 파일 관리 설정값
| Key | 기본값 | 실시간 설정 지원 여부 | 설명 |
|---|---|---|---|
| mgr_purge_enabled | true | O | 데이터베이스 파일 자동 삭제 여부 |
| mgr_purge_disk_usage_pct | 80 | O | 파일시스템 임계치 이상 적재 시 데이터 삭제 |
| mgr_purge_xlog_keep_days | 30 | O | xlog 정의 데이터 보존 기간 |
| mgr_purge_profile_keep_days | 10 | O | 프로파일 데이터 보존 기간 |
| mgr_purge_counter_keep_days | 70 | O | 5분 간격 카운터(선 그래프의 값) 보존 기간 |
| mgr_purge_realtime_counter_keep_days | 70 | O | 2초 간격 (선 그래프의 값) 보존 기간 |
| mgr_purge_visitor_counter_keep_days | 70 | O | 방문자 수 정보 보존 기간 |
| mgr_purge_daily_text_days | 140 | O | Text 데이터 보존 기간 |
기타 설정값
| Key | 기본값 | 실시간 설정 지원 여부 | 설명 |
|---|---|---|---|
| server_id | hostname | X | 플로우캣 수집 서버 이름 |
| object_deadtime_ms | 8000 | O | 에이전트 정지 임계치 시간(ms) |
object_deadtime_ms 수집 서버에 접속하는 모든 에이전트의 정지 여부를 체크하는 임계치입니다. 에이전트에서 주기적으로 HeartBeat를 보내며 8초간 수집 서버에 들어오지 않으면 정지로 인식합니다.
수집 서버 기동
수집 서버 실행 파일 위치로 이동
$ cd /app/flowkat/collect.server/bin
Java 설치 홈디렉터리 설정을 권장합니다. Java 홈디렉터리 미설정 시 시스템 기본 Java 버전으로 기동합니다.
환경 변수 파일 설정
/app/flowkat/collect.server/bin/setenv.sh
$ vi setenv.sh
if [[ -z "$JAVA_HOME" ]];then
export JAVA_HOME=/app/java/jdk1.8.0_301
fi
if [[ -z "$FLOWKAT_COLLECTOR_SERVER_HOME" ]];then
export FLOWKAT_COLLECTOR_SERVER_HOME=/app/flowkat/collect.server
fi
export JAVA_OPTS="$JAVA_OPTS -Xmx1024m -Xms1024m"
export JAVA_OPTS="$JAVA_OPTS -Dflowkat.collect.server.home=${FLOWKAT_COLLECTOR_SERVER_HOME}"
export JAVA_OPTS="$JAVA_OPTS -Dflowkat.config.home=${FLOWKAT_COLLECTOR_SERVER_HOME}/conf/"
export JAVA_OPTS="$JAVA_OPTS -Dflowkat.config=${FLOWKAT_COLLECTOR_SERVER_HOME}/conf/flowkat.conf"
export JAVA_OPTS="$JAVA_OPTS -Ddb_dir=${FLOWKAT_COLLECTOR_SERVER_HOME}/database"
export JAVA_OPTS="$JAVA_OPTS -Dlog_dir=${FLOWKAT_COLLECTOR_SERVER_HOME}/logs"
export JAVA_OPTS="$JAVA_OPTS -Dplugin_dir=${FLOWKAT_COLLECTOR_SERVER_HOME}/plugin"
export JAVA_OPTS="$JAVA_OPTS -Dtemp_dir=${FLOWKAT_COLLECTOR_SERVER_HOME}/temp"
export JAVA_OPTS="$JAVA_OPTS -Dclient_dir=${FLOWKAT_COLLECTOR_SERVER_HOME}/client"
파일 설정 완료 후 기동
/app/flowkat/collect.server/bin/startup.sh
$ ./startup.sh
nohup: redirecting stderr to stdout
_____ _ _ __ _
| ___| | _____ _| |/ /__ _| |_
| |_ | |/ _ \ \ /\ / / ' // _` | __|
| _| | | (_) \ V V /| . \ (_| | |_
|_| |_|\___/ \_/\_/ |_|\_\__,_|\__|
FlowKat Monitoring Solution
FlowKat version 5.0.0
System JRE version : 1.8.0_301
15:05:56,575 |-INFO in ch.qos.logback.classic.LoggerContext[default] - Could NOT find resource [logback-test.xml]
TCP 6100 포트 LISTEN 확인
$ netstat -an | grep 6100
tcp6 0 0 :::6100 :::* LISTEN
udp6 0 0 :::6100 :::*
수집 서버 중지
수집 서버 실행 파일 위치로 이동
$ cd /app/flowkat/collect.server/bin
수집 서버 실행 파일 위치에서 shutdown.sh를 실행
$ ./shutdown.sh
수집 서버가 정상적으로 중지되면 아래와 같이 로그 출력
/app/flowkat/collect.server/logs/server-${오늘날짜}.log
20240424 13:56:16 [Graceful shutdown] starting
20240424 13:56:16 [S178] Server Shutdown
20240424 13:56:16 [S179] Shutdown flowkat.server.db.DBCtr$$anon$1@650a362e ...
20240424 13:56:16 [S179] Shutdown flowkat.server.core.CoreRun$$anon$1@32b62cdb ...
20240424 13:56:16 [S179] Shutdown flowkat.server.tagcnt.core.CountEnv$$anon$1@1d29eb55 ...
20240424 13:56:16 [Graceful shutdown] end
수집 서버 업데이트
- 수집 서버를 중지합니다.
- 업데이트 전 수집 서버의 lib 디렉터리를 백업합니다.
mv /app/flowkat/collect.server/lib /app/flowkat/collect.server/lib.20240425 - 업데이트 할 버전의 파일을 서버에 업로드합니다.
- 압축 해제 후 새로운 lib 디렉터리를 수집 서버에 복사합니다.
cp -R flowkat/collect.server/lib /app/flowkat/collect.server/lib - 수집 서버를 다시 기동합니다.
로그 위치
/app/flowkat/collect.server/logs
- server-${오늘날짜}.log : 수집 서버 로그
- request-${오늘날짜}.log : API 서버에서 들어온 요청 로그
로그 파일 보관 개수는 31개입니다.
수집 서버 백업 및 복구
제품이 설치된 /app 아래의 특정 디렉터리를 복사하여 백업 및 복구가 가능합니다.
수집 데이터 백업 예시
# tar -cvf collect.tar /app/flowkat/collect.server/database
수집 데이터 복구 예시
# tar -xvf collect.tar -C /app/flowkat/collect.server/database
수집 서버 삭제
- 수집 서버를 중지합니다.
- 설치한 수집 서버 디렉터리를 삭제합니다.
API 서버 삭제 예시
rm -rf /app/flowkat/collect.server