대시보드 관련 문의 대응
고객이 대시보드 관련 문제를 신고할 때의 대응 가이드다. UI 화면 기준 증상 → 기술 원인 → 해결 경로 순으로 진행한다.
1. 증상 목록
| # | 고객이 말하는 증상 (UI 기준) | 섹션 |
|---|---|---|
| S-1 | "대시보드에 데이터가 안 보입니다" | 2.1 |
| S-2 | "대시보드 저장이 안 됩니다" | 2.2 |
| S-3 | "대시보드 위젯 배치가 깨졌습니다" | 2.3 |
2. 증상별 대응 가이드
2.1 S-1: 대시보드에 데이터가 안 보인다
증상: 대시보드 화면에 접속했으나 특정 위젯 또는 전체 위젯에 데이터가 표시되지 않는다.
고객에게 확인
- 어떤 대시보드인가? (시스템/관리자/운영/사용자 정의)
- 언제부터 안 보이는가? (특정 시각 이후 전체, 또는 처음부터)
- 특정 위젯만인가, 전체인가?
- 다른 브라우저나 다른 PC에서도 같은 증상인가?
기술지원 확인
- 브라우저 DevTools > Network 탭에서 빨간 요청 확인
- 센트리 화면(
설정 > 에이전트 목록)에서 에이전트 연결 상태 확인 - Collect 서버 로그 확인:
docker logs flowkat-collect-server --tail 100 | grep -i "error\|warn"
- DB 시퀀스 불일치 확인 (대시보드 생성 오류 시):
docker compose logs dashboard-server | grep "시퀀스"
# 예상 출력: ⚠️ DASH_BOARD 시퀀스 불일치 감지!
확인 포인트:
| 확인 항목 | 정상 상태 | 비정상 상태 |
|---|---|---|
| 에이전트 연결 | 녹색 아이콘 | 빨간 아이콘 또는 미표시 |
| Network 요청 | 200 OK | 4xx/5xx |
| Collect 서버 | 로그 정상 흐름 | error 반복 |
벤더 에스컬레이션 시 전달 정보
- Collect 서버 로그:
$COLLECT_HOME/logs/(증상 발생 전후 1시간) - Dashboard 서버 로그:
docker logs dashboard-server출력 - 브라우저 Network 탭 캡처 (빨간 요청 포함)
- 에이전트 버전 및 연결 IP/Port 정보
- 증상 발생 시각 (YYYY-MM-DD HH:mm:ss 타임존 포함)
2.2 S-2: 대시보드 저장이 안 된다
증상: 대시보드 편집 모드에서 저장 버튼 클릭 시 저장되지 않거나 23505 에러가 발생한다.
고객에게 확인
- 신규 대시보드 생성 중 오류인가, 기존 편집 중 오류인가?
- 화면에 어떤 에러 메시지가 표시되는가?
- 여러 번 시도해도 같은 현상인가?
기술지원 확인
# H2 시퀀스 불일치 확인
docker compose logs dashboard-server | grep "23505\|DASH_BOARD\|시퀀스"
# 서버 재시작으로 시퀀스 자동 복구
docker compose restart dashboard-server
확인 포인트:
| 확인 항목 | 정상 상태 | 비정상 상태 |
|---|---|---|
| 23505 에러 | 없음 | Unique index or primary key violation |
| 시퀀스 상태 | ✓ DASH_BOARD 시퀀스 정상 로그 | 불일치 감지 로그 |
벤더 에스컬레이션 시 전달 정보
- Dashboard 서버 로그 (에러 발생 전후 30분)
- 에러 발생 시 브라우저 콘솔 전체 출력
- DB 복원 또는 수동 데이터 삽입 이력 여부
- 재현 단계 (어떤 순서로 클릭하면 발생하는지)
2.3 S-3: 위젯 배치가 깨진다
증상: 대시보드 위젯의 크기나 위치가 저장 후 다시 접속 시 다르게 표시된다.
고객에게 확인
- 특정 브라우저(화면 크기)에서만 발생하는가?
- 배치 저장 직후에도 깨지는가, 재접속 후 깨지는가?
기술지원 확인
# GridLayout 관련 오류 확인
docker logs flowkat-ui-server --tail 50 | grep -i "grid\|layout"
브라우저 DevTools > Application 탭 > Local Storage에서 grid/layout 관련 키를 확인한다.
또는 DevTools > Console 탭에서 React Developer Tools 확장을 활용하여 컴포넌트 상태를 점검한다.
벤더 에스컬레이션 시 전달 정보
- 화면 해상도 및 브라우저 줌 레벨
- 재현 단계 (어떤 위젯을 어디로 이동했는지)
- 브라우저 콘솔 에러 캡처
3. 관련 문서
| 모듈 | 관련 trouble-shooting | 핵심 이슈 |
|---|---|---|
| 시퀀스 복구 | 024-dashboard-sequence-sync | H2 시퀀스 불일치, 23505 에러 |
| GridLayout | 165-dashboard-gridlayout | 위젯 배치 최적화 |
| 편집 모드 저장 | 080-dashboard-edit-mode-save | 저장 버튼 오동작 |