본문으로 건너뛰기

설치 후 5분 체크리스트

FlowKat APM을 설치한 뒤, 아래 체크리스트를 따라 5분 안에 정상 동작 여부를 확인합니다. 각 단계를 순서대로 진행하여 수집 서버, 에이전트, 데이터 수집, 핵심 기능, 알람 설정까지 빠르게 점검하십시오.

사전 조건​

다음 조건이 충족되어야 체크리스트를 진행할 수 있습니다.

항목설명
수집 서버 설치FlowKat 수집 서버(Collect Server)가 설치되어 실행 중이어야 합니다
대시보드 서버 설치FlowKat 대시보드 서버가 설치되어 웹 접속이 가능해야 합니다
에이전트 배포최소 1개 이상의 Java Agent 또는 Host Agent가 대상 서버에 배포되어 있어야 합니다
네트워크 연결에이전트에서 수집 서버 TCP 6100 포트로 통신이 가능해야 합니다
에이전트 필수 설정 확인

Java Agent의 net_collector_ip와 net_collector_tcp_port가 수집 서버 주소와 일치하는지 반드시 확인하십시오. 이 설정이 잘못되면 데이터가 수집되지 않습니다. 상세 내용은 Java Agent 설치 및 파라미터를 참고하십시오.

1단계: 서버 접속 확인 (0:00~1:00)​

대시보드에 정상적으로 접속하고 로그인할 수 있는지 확인합니다.

  • 브라우저에서 FlowKat 대시보드 URL에 접속합니다
  • 로그인 페이지가 정상적으로 표시되는지 확인합니다
  • 관리자 계정으로 로그인합니다
  • 로그인 후 통합 대시보드 화면이 표시되는지 확인합니다
로그인이 안 되는 경우

초기 관리자 계정 정보는 시스템 관리자에게 문의하십시오. 계정 관리는 사용자 관리 페이지에서 수행합니다.

2단계: 에이전트 연결 확인 (1:00~2:00)​

배포한 에이전트가 수집 서버에 정상적으로 연결되었는지 확인합니다.

  • 메뉴에서 설정 > 오브젝트 관리로 이동합니다
  • 배포한 에이전트가 목록에 표시되는지 확인합니다
  • 에이전트의 상태가 활성으로 표시되는지 확인합니다
에이전트가 목록에 보이지 않는 경우

다음 항목을 순서대로 확인하십시오.

  1. 에이전트 설정 파일에서 net_collector_ip가 수집 서버 IP와 일치하는지 확인합니다
  2. 수집 서버의 TCP 6100 포트가 방화벽에서 허용되어 있는지 확인합니다
  3. 에이전트 로그 파일($AGENT_HOME/logs/)에서 연결 오류 메시지를 확인합니다
  4. Docker 환경에서는 net_collector_ip를 172.17.0.1(bridge 모드) 또는 127.0.0.1(host 모드)로 설정합니다

3단계: 데이터 수집 확인 (2:00~3:00)​

에이전트에서 수집한 데이터가 대시보드에 정상적으로 표시되는지 확인합니다.

  • 통합 대시보드로 이동하여 실시간 위젯에 데이터가 표시되는지 확인합니다
  • 시스템 대시보드에서 CPU, 메모리, TPS 시계열 차트에 데이터 포인트가 찍히는지 확인합니다
  • 시스템 대시보드의 XLOG 차트에 트랜잭션 응답시간 분포가 나타나는지 확인합니다
데이터가 표시되지 않는 경우
  • 에이전트 배포 후 데이터가 표시되기까지 약 10~30초가 소요될 수 있습니다
  • 모니터링 대상 애플리케이션에 실제 트래픽(HTTP 요청)이 발생해야 트랜잭션 데이터가 수집됩니다
  • 호스트 에이전트의 경우 CPU/메모리 지표는 트래픽 없이도 수집됩니다

4단계: 핵심 기능 동작 확인 (3:00~4:00)​

FlowKat의 핵심 모니터링 기능이 정상적으로 동작하는지 확인합니다.

  • 성능 분석 페이지에서 액티브 서비스 목록이 표시되는지 확인합니다
  • 트랜잭션 통계에서 호출 URL 목록이 표시되는지 확인합니다
  • 가용성 모니터링에서 서비스 가동 상태를 확인합니다
  • 이슈 추적 페이지에 접속하여 이슈 관리 기능이 동작하는지 확인합니다
검색 버튼을 클릭하십시오

트랜잭션 통계 등 일부 페이지는 검색 조건을 설정한 뒤 검색 버튼을 클릭해야 데이터가 조회됩니다.

5단계: 알람 설정 확인 (4:00~5:00)​

알람 규칙과 알람 연동이 정상적으로 동작하는지 확인합니다.

  • 설정 > 수집 서버 관리 페이지로 이동합니다
  • 알람 규칙 목록이 표시되는지 확인합니다
  • 알람 연동(이메일, Webhook 등) 설정 페이지에 접속할 수 있는지 확인합니다
  • 테스트 알람을 발송하여 수신 여부를 확인합니다 (선택)
알람 연동을 나중에 설정하려면

알람 연동은 설치 직후가 아니더라도 운영 중 언제든지 설정할 수 있습니다. 수집 서버 관리의 알람 규칙에서 메트릭 기반 규칙을 생성하고, 알람 연동에서 외부 시스템(이메일, Webhook)을 등록하십시오.

체크리스트 요약​

단계확인 항목소요 시간
1단계대시보드 접속 및 로그인1분
2단계에이전트 연결 상태 확인1분
3단계실시간 데이터 수집 확인1분
4단계핵심 모니터링 기능 점검1분
5단계알람 규칙 및 연동 확인1분

문제가 발생했나요?​

긴급 문제 해결

아래 증상이 발생하면 즉시 확인하십시오.

증상원인해결 방법
대시보드 접속 불가대시보드 서버 미실행대시보드 서버 프로세스 상태를 확인합니다
에이전트 미표시네트워크 연결 실패net_collector_ip, TCP 6100 포트 방화벽을 확인합니다
데이터 미수집에이전트 설정 오류에이전트 로그($AGENT_HOME/logs/)에서 오류를 확인합니다
트랜잭션 데이터 없음애플리케이션 트래픽 없음모니터링 대상에 HTTP 요청을 발생시킵니다

다음 단계​

설치 확인이 완료되었다면 다음 문서를 참고하여 FlowKat을 본격적으로 활용하십시오.