VSync (벡터 동기화 서비스)
경로: Admin → System Management → Settings → VSyncManage vsync service endpoints and document loader configurations.
개요
Storage 파일이 업로드되면 자동으로 청킹 → 파싱(VisionParse) → 임베딩 → 벡터 DB(Table) 마이그레이션 이 수행되는 서비스입니다. 운영자가 이 화면에서 전역 설정을 관리합니다.4개 탭 구성
| 탭 | 값 | 용도 |
|---|---|---|
| LOADERS | loaders | Global VisionParse 로더 관리 + 스토리지별 할당(override) |
| SERVICES | services | VSync / VisionParse 서비스 엔드포인트 URL·상태 관리 |
| EXTENSIONS | extensions | 지원 파일 확장자 조회 (37종, 읽기 전용) |
| DASHBOARD | dashboard | 테넌트별 문서 처리 현황 모니터링 |
LOADERS — Global VisionParse 로더
역할: 문서 파싱에 사용되는 VisionParse 로더 의 글로벌 정의·스토리지별 할당 관리.계층 구조
- Global Loader: 모든 스토리지의 기본 파싱 어댑터 — 운영자가 정의
- Storage-specific Loader: 특정 스토리지에만 할당된 별도 로더 (글로벌 재정의)
- Default 로더: 스토리지에 특별 할당이 없을 때 사용되는 기본값
필드
| 필드 | 설명 |
|---|---|
| Name | 로더 이름 |
| File Extensions | 해당 로더가 처리할 파일 확장자 |
| Description | 로더 설명·용도 |
| Enabled | 활성/비활성 토글 |
| Source | default / custom / override |
| Scope | global / storage-specific |
| Updated At | 수정일 |
액션
- + 글로벌 로더 추가 → 로더 생성
- 행 클릭 → 로더 상세
- 수정 → 로더 수정
- 삭제 → 로더 삭제 (기본 로더 삭제 불가)
- 기본값으로 설정 — 글로벌 기본 로더 지정
- 재정의만 표시 필터
- 스토리지별 로더 할당 — 테넌트 선택 → 스토리지에 로더 할당/해제
글로벌 로더는 모든 스토리지에서 기본으로 사용됩니다. 특정 스토리지에 다른 파싱 전략이 필요하면 스토리지별 할당 으로 override.
SERVICES — VSync 서비스 엔드포인트
역할: VSync 처리를 수행할 외부 서비스 엔드포인트(URL) 관리.서비스 타입
| Type | 설명 |
|---|---|
| vector_sync | vsync 본체 처리 서비스 |
| vision_parse | VisionParse 문서 파싱 서비스 |
필드
| 필드 | 설명 | 예시 |
|---|---|---|
| Name | 설정 이름 | Production vsync |
| Service Type | vector_sync / vision_parse | |
| Description | 서비스 설명 | |
| Base URL | 서비스 엔드포인트 | http://localhost:8000 |
| Is Active | 활성 여부 | |
| Is Default | 해당 타입의 기본 서비스 지정 | |
| Is Healthy | 헬스 상태 | Healthy / Unhealthy / Unknown |
| Created / Updated At |
액션
통계 (Services 탭 하단)
- 전체 문서 / 오늘 처리됨 / 대기 작업 / 실패 작업 / 평균 처리 시간 / 사용 저장소
빠른 작업
- 동기화 시작 / 일시 중지 / 실패 재시도 / 로그 내보내기 / 설정 편집
EXTENSIONS — 지원 확장자
역할: 파싱 가능한 파일 포맷 목록 조회 (조회 전용, 37종).| 카테고리 | 개수 | 확장자 |
|---|---|---|
| Documents | 11 | .doc .docx .hwp .hwpx .odg .odp .odt .pdf .ppt .pptx .rtf |
| Data | 9 | .csv .json .ods .toml .tsv .xls .xlsx .yaml .yml |
| Images | 8 | .bmp .gif .jpeg .jpg .png .tif .tiff .webp |
| Text & Markup | 9 | .epub .htm .html .markdown .md .text .txt .xhtml .xml |
이 탭은 조회 전용 — 확장자 추가·제거는 운영 DB 또는 서버 측 정책에서 직접 변경해야 합니다.
DASHBOARD — 테넌트별 처리 현황
역할: 전체 및 테넌트별 vsync 처리 통계 시각화 — 장애·부하 모니터링.상단 지표 카드
| 카드 | 설명 |
|---|---|
| Completion Rate | 완료율 (%) |
| Workload | 진행 중 + 대기 비율 |
| Total Documents | 전체 문서 수 |
| Completed | 완료 문서 수 |
| In Progress | 처리 중 |
| Pending | 대기 중 |
| Failed | 실패 |
| Other | 기타 |
테넌트 테이블
Document Processing Status by Tenant — 각 테넌트(Workspace)별 Total / Completed / In Progress / Pending / Failed / Other 카운트.
컨트롤
- Search tenants — 이름 필터
- Refresh — 갱신
관련 문서
VSync 로더 생성
VSync 로더를 생성하는 화면입니다
VSync 로더 삭제
VSync 로더를 삭제하는 기능입니다. 기본 로더는 삭제 할 수 없습니다
VSync 로더 상세
VSync 로더의 상세 정보를 조회하는 화면입니다
VSync 로더 수정
VSync 로더 설정을 수정하는 화면입니다. 현재 설정값이 기본으로 입력되어 있습니다
VSync 서비스 생성
VSync 서비스를 신규 생성하는 화면 — 서비스 이름·설정 입력 후 저장
VSync 서비스 삭제
VSync 서비스를 삭제하는 기능입니다
VSync 서비스 수정
VSync 서비스 설정을 수정하는 화면입니다. 현재 설정값이 기본으로 입력되어 있습니다
VSync 운영 설정
VSync 운영 설정 통합 화면 — Loaders / Services / Supported Extensions / Dashboard 4개 탭 한눈에 관리