고객 용어 vs 기술 용어 대조표
고객이 UI에서 부르는 이름과 기술지원 엔지니어가 실제로 확인하는 컴포넌트/기술 용어를 대응한다. 에스컬레이션 전 의사소통 오류를 방지하기 위해 항상 이 테이블을 기준으로 확인한다.
1. UI 화면 용어 vs 기술 컴포넌트
| 고객 용어 (UI) | UI 경로 | 기술지원 확인 위치 | 벤더 용어 (기술 스택) |
|---|---|---|---|
| 대시보드 | /dashboard/main | dashboard-server 로그, H2 DB | DashBoardController, H2 Database, dashboard-server 컨테이너 |
| 센트리 | /availability/uptime | collect-server 연결 상태, WebSocket | SentryPlugin, UptimeKat, WebSocket 연결 |
| 수집 서버 | 센트리 화면 연결 상태 표시 | docker logs flowkat-collect-server | collect-server, TCP 6100 |
| 트랜잭션 익스플로러 | /tx-mining | tx-mining-api 로그, PostgreSQL | tx-mining-api, PostgreSQL 16, Valkey, XLog 테이블 |
| 추적 | /tracking | collect-server XLog 수집, PostgreSQL | XLog Plugin, tracking feature, xlog_* 테이블 |
| 성능 조회 | /analysis/performance | api-server, counter 데이터 | API Server, counter_* 테이블, CounterManager |
| 오브젝트 | 설정 > 오브젝트 관리 | dashboard-server 설정, H2 DB | 에이전트 등록 데이터, ServerId, obj_name 파라미터 |
| 사용자 관리 | 설정 > 사용자 | dashboard-server 권한 설정 | User entity, RBAC, role 테이블 |
| 알람 | 설정 > 알람 규칙 | collect-server AlertPlugin 로그 | XLogAlertPlugin, AlertRule, SENTRY_ADDRESS |
| 에이전트 | 센트리 > 에이전트 목록 | collect-server 연결 목록 | Java Agent, Host Agent |
| 호스트 | 센트리 > 호스트 목록 | agent.host 연결 상태 | agent.host, HostAgent, obj_host_name |
| 파드 / 컨테이너 | 센트리 > 컨테이너 | agent.host.container 연결 | agent.host.container, K8s Pod, oshi-core |
| 프로파일 | XLog 클릭 > 상세 | collect-server profileStep | ProfileStep, profile_step_max_count, StackTrace |
| Active Thread | 대시보드 > Active Thread | collect-server ActiveService | ActiveService, trace_activeservice_red_time |
| TPS | 대시보드 > TPS 그래프 | api-server counter 집계 | TPS Counter, CounterManager.getCounterValues() |
| 응답시간 | 대시보드 > 응답시간 | api-server, XLog 집계 | elapsed_time, XLog.elapsed, CounterManager |
2. 인프라 용어 vs 기술 컴포넌트
| 고객 용어 | 기술 용어 | 컨테이너명 | 포트 | 비고 |
|---|---|---|---|---|
| 수집 서버 / 컬렉터 | collect-server | flowkat-collect-server | 6100 (TCP) | 에이전트 데이터 수신 |
| API 서버 | api-server | flowkat-api-server | 6188 (내부) | REST API, 내부 전용 |
| 웹 서버 / 대시보드 서버 | dashboard-server | flowkat-dashboard-server | 6600 (내부) | Spring Boot + H2 |
| 화면 / UI / 프론트 | ui-server | flowkat-ui-server | 6300 (외부) | Next.js + PM2 |
| 트랜잭션 익스플로러 / 마이닝 | tx-mining-api | flowkat-tx-mining-api | 8090 | Spring Boot 3.x, JDK 17 |
| 캐시 / Redis | valkey | flowkat-valkey | 6380 (외부) | Valkey 9.0 (Redis-compatible) |
| DB / PostgreSQL | postgres | flowkat-postgres-txmining | 5433 (외부) | PostgreSQL 16 + pgvector |
| 자바 에이전트 | Java Agent | (고객 서버) | - | JVM 바이트코드 계측 |
| 호스트 에이전트 | agent.host | (고객 서버) | - | OS 메트릭 (sigar JNI) |
| 컨테이너 에이전트 | agent.host.container | (K8s Pod) | - | K8s 메트릭 (oshi-core) |
3. 핵심 파라미터 용어 (P0 — 고객 환경마다 반드시 확인)
| 고객 표현 | conf 파라미터 키 | 기본값 | 확인 명령 |
|---|---|---|---|
| "수집 서버 주소" | net_collector_ip | 127.0.0.1 | grep net_collector_ip /opt/flowkat/agent.java/conf/flowkat.conf |
| "수집 서버 포트" | net_collector_tcp_port | 6100 | grep net_collector_tcp_port /opt/flowkat/agent.java/conf/flowkat.conf |
| "에이전트 이름" | obj_name | "" (자동: tomcat1 등) | grep obj_name /opt/flowkat/agent.java/conf/flowkat.conf |
| "에이전트 타입" | obj_type | "" | grep obj_type /opt/flowkat/agent.java/conf/flowkat.conf |
| "호스트 이름" | obj_host_name | "" (자동: 시스템 호스트명) | grep obj_host_name /opt/flowkat/agent.java/conf/flowkat.conf |
| "모니터링 그룹" | monitoring_group_type | "" | grep monitoring_group_type /opt/flowkat/agent.java/conf/flowkat.conf |
4. 환경 설정 파라미터 용어 (.env 파일 기준)
| 고객 표현 | .env 변수 키 | 예시 값 | 비고 |
|---|---|---|---|
| "UI 접속 주소" | NEXTAUTH_URL | http://192.168.1.100:6300 | 브라우저에서 접근하는 실제 URL |
| "배포 환경 종류" | DEPLOYMENT_ENV | production, development, aircap, demo | 환경별 힙/네트워크 설정 자동 변경 |
| "트랜잭션 익스플로러 활성화" | TX_MINING_ENABLED | true / false | 비활성화 시 mining-server 기동 안 함 |
| "알림 수신 주소" | SENTRY_ADDRESS | http://127.0.0.1:6300 | HTTP 콜백 URL, UI 서버 주소 입력 |
| "PostgreSQL 비밀번호" | POSTGRES_PASSWORD | (운영 환경 변경 필수) | 기본값 txmining — 운영 시 반드시 변경 |
| "수집 서버 네트워크 모드" | NETWORK_MODE_COLLECT | host / bridge | host: 라이선스 IP 검증 필요 |
| "XLog DB 연결 IP" | COLLECT_POSTGRES_HOST | 127.0.0.1 (host 모드) / 172.17.0.1 (bridge 모드) | 네트워크 모드에 따라 다름 |
5. 장애 상황별 용어 대응 예시
| 고객이 말하는 것 | 기술 확인 포인트 | 참조 문서 |
|---|---|---|
| "대시보드가 안 열려요" | ui-server → dashboard-server → api-server 연결 체인 확인 | 30.troubleshooting-flow.md 플로우 2 |
| "에이전트가 연결이 안 돼요" | net_collector_ip 설정, 방화벽 6100 포트 | 30.troubleshooting-flow.md 플로우 3 |
| "트랜잭션 데이터가 없어요" | XLog Plugin 설치 여부, COLLECT_POSTGRES_HOST 설정 | 30.troubleshooting-flow.md 플로우 4 |
| "센트리 화면이 빨간색이에요" | collect-server 연결 상태, WebSocket 연결 | layer3-agent-connection.md |
| "알람이 안 와요" | SENTRY_ADDRESS 설정, AlertRule 활성화 | layer3-alert-malfunction.md |
| "로그인이 안 돼요" | NEXTAUTH_URL 설정, USE_SECURE_COOKIES | layer3-auth-access.md |
| "업그레이드 후 이상해요" | 볼륨 마이그레이션, DB 스키마 변경 여부 | layer3-upgrade-issues.md |
관련 문서: *30.troubleshooting-flow.md* (진단 플로우), *spec/architecture-draft.md* (전체 아키텍처)