'/%3e%3cpath%20id='cross_2'%20data-name='cross%202'%20class='cls-2'%20d='M20.612,30.43h0a5.361,5.361,0,1,0-10.723,0H0A33.709,33.709,0,0,1,30.569,0V9.75a5.361,5.361,0,1,1,0,10.723V30.43Z'%20transform='translate(67.193%200.007)%20rotate(90)'/%3e%3cpath%20id='cross_3'%20data-name='cross%203'%20class='cls-3'%20d='M20.612,30.43h0a5.361,5.361,0,1,0-10.723,0H0A33.709,33.709,0,0,1,30.569,0V9.75a5.361,5.361,0,1,1,0,10.723V30.43Z'%20transform='translate(67.186%2067.041)%20rotate(180)'/%3e%3cpath%20id='cross_4'%20data-name='cross%204'%20class='cls-4'%20d='M20.6,30.5h0a5.361,5.361,0,1,0-10.723,0H0A33.71,33.71,0,0,1,30.56,0V9.818a5.361,5.361,0,1,1,0,10.723V30.5Z'%20transform='translate(0%2067.041)%20rotate(-90)'/%3e%3c/svg%3e)
백그라운드 서비스
사용자가 체감하는 기능 품질을 받쳐주는 서비스와 정리·유지보수 서비스의 상태를 모니터링하고 조정합니다.
확인 방법
시스템 관리 > 백그라운드 서비스 > 상세 보기를 클릭합니다.
성능 메트릭
조회 기간(1h / 6h / 24h / 7d)을 선택하면 해당 구간의 전체 통계를 확인할 수 있습니다.
| 항목 | 설명 |
|---|---|
| 총 처리량 | 전체 서비스가 처리한 작업 수 |
| 총 오류 | 발생한 오류 수 |
| 총 메모리 사용량 | 전체 서비스의 메모리 합산 |
| 활성 | 현재 실행 중인 서비스 수 |
서비스별로 처리된 작업 수, 처리율, 메모리 사용량, 가동 시간을 목록으로 확인할 수 있습니다.
서비스 목록
서비스는 주요 기능과 보조 운영 두 가지 유형으로 나뉩니다.
주요 기능
사용자가 체감하는 기능 품질을 직접 받쳐주는 서비스입니다.
| 서비스 | 분류 | 설명 |
|---|---|---|
| Knowledge indexer | 지식 인덱싱 | 문서를 읽고 나누어 AI가 검색할 수 있는 데이터로 만듭니다. |
| File indexing scheduler | 파일 검색 | 파일 검색 인덱스를 주기적으로 갱신합니다. |
| Metadata autocomplete | 파일 검색 | 파일 정보에서 자동완성 후보를 준비해 검색어 입력을 돕습니다. |
| Recent files cache | 파일 검색 | 최근 파일 목록을 빠르게 보여주도록 임시 데이터를 유지합니다. |
| Transform ingest | 파일 작업 | 새 파일과 변환된 파일을 확인해 미리보기, 텍스트 추출, AI 검색 작업으로 전달합니다. |
| Realtime chat persistence | 실시간 세션 | 실시간 대화 내용을 저장소에 안전하게 반영합니다. |
| Filespace batch delete | 파일 작업 | 여러 파일을 휴지통으로 옮기고 연결된 정보까지 정리합니다. |
보조 운영
정리·보호·유지보수를 담당하는 운영성 서비스입니다.
| 서비스 | 분류 | 설명 |
|---|---|---|
| Index pruner | 파일 검색 | 오래되었거나 불필요한 인덱스 데이터를 정리합니다. |
| AI request state cleanup | 실시간 세션 | 오래 남은 AI 요청 상태와 응답 액션 캐시를 정리합니다. |
| Session state cleanup | 실시간 세션 | 만료된 세션 상태를 정리해 실시간 연결을 안정적으로 유지합니다. |
| AI pending state cleanup | 정리 작업 | AI 승인 대기, 파일 생성 대기, 작업 계획 상태를 정리합니다. |
| File operation task cleanup | 정리 작업 | 완료된 비동기 파일 작업 상태를 주기적으로 정리합니다. |
| Temporary access cleanup | 정리 작업 | 만료된 임시 접근 상태와 토큰을 정리합니다. |
| Upload state cleanup | 정리 작업 | 오래된 업로드 상태, 충돌 정보, 사용자 선호도를 정리합니다. |
| Memory monitor | 시스템 보호 | 스페이스빌더가 사용하는 메모리를 확인해 서버 과부하를 예방합니다. |
서비스 제어
각 서비스별로 개별 조정이 가능합니다.
- 일시정지: 해당 서비스를 일시적으로 중단합니다.
- 카운터 초기화: 통계 수치를 0으로 초기화합니다. 실제 데이터에는 영향이 없습니다.
- 자동 새로고침: 상태를 실시간으로 갱신합니다.
- 재시작: 전체 백그라운드 서비스를 한 번에 재시작합니다.
서비스 상태
| 상태 | 설명 |
|---|---|
| 정상 | 서비스가 정상 실행 중 |
| 대기 중 | 처리할 작업을 기다리는 정상 상태 |
| 일시정지 | 관리자가 서비스를 잠시 멈춘 상태 |
| 중지 | 서비스가 실행되지 않는 상태 |
| 주의 | 오류가 발생했거나 점검이 필요한 상태 |
주의 상태에서는 마지막 오류와 오류 횟수를 먼저 확인합니다. 오류 횟수가 계속 증가하면 해당 서비스를 다시 시작하고, 같은 문제가 이어지면 서버 로그를 확인합니다.