VSync 운영 설정
경로: Admin → System Management → Settings → VSync
Manage vsync service endpoints and document loader configurations.
VSync 서비스의 운영 설정을 상단 4개 탭으로 전환하며 관리합니다.
4개 탭 요약
| 탭 | 용도 |
|---|
| LOADERS | 파일 타입별 파싱 어댑터(Loader) 관리 |
| SERVICES | 임베딩·요약 등 외부 처리 서비스 엔드포인트 연결 |
| SUPPORTED EXTENSIONS | 처리 허용 파일 확장자 정책 (37종) |
| DASHBOARD | 테넌트별 문서 처리 현황 모니터링 |
LOADERS 탭
PDF·DOCX·이미지 등 파일 타입별 파싱 방식 을 정의하는 어댑터를 관리.
- 기본 로더(built-in)는 수정·삭제 불가
- 커스텀 로더 추가 가능 (예: 특정 포맷 전용 파서)
하위 페이지:
SERVICES 탭
VSync 가 호출할 외부 처리 서비스 엔드포인트 관리. 임베딩·요약·정규화 등.
하위 페이지:
SUPPORTED EXTENSIONS 탭
처리 허용 파일 확장자 목록. 기본 37종 (Documents 11 / Data 9 / Images 8 / Text & Markup 9). 자세한 목록은 Storage 상세 — Support Extension.
이 탭은 조회 전용 이며 별도 설정 없이 바로 확인 가능합니다.
DASHBOARD 탭
실시간 테넌트별 문서 처리 현황 을 모니터링합니다.
상단 전체 지표 카드
| 카드 | 설명 |
|---|
| Completion Rate | 전체 문서 중 완료율 (%) |
| Workload | 진행 중 + 대기 중 비율 (%) — 현재 시스템 부하 |
| Total Documents | 전체 문서 수 |
| Completed | 완료 문서 수 (%) |
| In Progress | 처리 중 (%) |
| Pending | 대기 중 (%) |
| Failed | 실패 (%) |
| Other | 기타 상태 |
상단 컨트롤
- Search tenants… — 테넌트 이름으로 필터
- Refresh — 최신 수치 갱신
Document Processing Status by Tenant 표
| 컬럼 | 설명 |
|---|
| Tenant | 테넌트 이름 (Workspace) |
| Total Documents | 테넌트의 총 문서 수 |
| Completed | 완료 문서 수 |
| In Progress | 처리 중 |
| Pending | 대기 중 |
| Failed | 실패 |
| Other | 기타 |
운영 가이드
| 현상 | 가능한 원인 | 대응 |
|---|
| Failed 급증 | 특정 파일 포맷 처리 오류 / API Key 차단 / 외부 서비스 장애 | Blocked API Keys 확인 → 원인 해결 후 해제 |
| Pending 누적 | VSync Service 용량 부족 / 처리량 한계 | Service 수 증설 · 리소스 한도 상향 |
| Completion Rate 낮음 | 특정 테넌트의 대량 업로드 | 해당 테넌트 모니터링, 필요 시 쿼터 조정 |
| 특정 테넌트만 Failed 높음 | 해당 테넌트 파일 품질 문제 | 파일 내용·포맷 확인, 로그 분석 |
대시보드 수치는 Refresh 버튼 누를 때 갱신됩니다. 실시간 반영이 필요하면 운영 로그 에서 Loki 로 스트리밍 확인 권장.
탭별 주의
- 탭 전환: 상단 4개 탭 버튼으로 전환
- 지원 확장자 탭: 별도 설정 없이 조회만 가능
- 대시보드: 운영 장애 감지의 1순위 화면
관련 문서
