> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloosphere.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# 데이터 보존
> 로그·트레이스 데이터의 자동 정리 보존 기간을 설정하고, 백그라운드 태스크 큐 상태를 확인합니다.
관리자 › 설정 › 데이터 보존
사용량·감사·트레이스 등 누적되는 로그 데이터의 **보존 기간**을 정하고, 기간이 지난 데이터를 자동으로 정리합니다.
* 저장 공간을 관리하고 데이터 보존 정책을 준수하는 데 사용합니다.
***
## 자동 정리
**자동 정리 활성화**(기본 꺼짐)를 켜면 설정한 보존 기간이 지난 데이터가 매일 자동 삭제됩니다.
* 토글을 켜면 **정리 시간** 드롭다운이 함께 나타납니다. 정리 작업을 돌릴 시각을 정시 단위로 고르며, 기본값은 `03:00`입니다.
보존 기간을 **`0`으로 설정하면 영구 보존**됩니다(자동 삭제하지 않음). 정리하려면 1 이상의 일수를 지정하세요. **모든 유형의 기본값이 `0`** 이므로, 값을 넣기 전까지는 자동 정리를 켜도 삭제되는 데이터가 없습니다.
### 보존 대상
각 데이터 유형별로 보존 기간(일)을 개별 설정합니다.
* 유형 이름 아래에는 현재 **누적 건수와 차지하는 용량**이 함께 표시되므로, 어디부터 줄일지 판단할 수 있습니다.
| 데이터 | 설명 |
| ----------- | ---------------------------- |
| **사용량 로그** | 토큰·요청 사용량 기록 |
| **감사 로그** | 관리자·사용자 행위 감사 기록 |
| **가드레일 로그** | 가드레일 차단/통과 기록 |
| **트레이스** | AI 요청이 처리되는 과정을 단계별로 기록한 데이터 |
| **트레이스 분석** | 트레이스를 집계·요약한 분석 데이터 |
| **자동 평가** | 자동 평가 결과 |
***
## 수동 정리
**지금 정리 실행**을 누르면 현재 설정을 저장하고, 보존 기간이 지난 데이터를 **즉시** 삭제합니다.
보존 기간이 전부 `0`이면 실행되지 않고 "정리 실행 전 최소 하나의 로그 유형에 보존 기간을 설정하세요" 안내가 표시됩니다.
***
## 태스크 큐
파일 처리 등 무거운 작업을 백그라운드에서 처리하는 작업 큐의 상태를 확인합니다.
* 설명 옆에 큐 백엔드가 표시됩니다 — Redis에 연결되어 있으면 **Redis**, 아니면 **직접 처리**(서버 프로세스 안에서 처리)입니다.
| 항목 | 설명 |
| -------- | ------------- |
| **대기** | 처리 대기 중인 작업 수 |
| **처리 중** | 현재 실행 중인 작업 수 |
| **워커** | 작업을 처리하는 워커 수 |
### 컨슈머 & 정체 메시지
`▶ 컨슈머 & 정체 메시지`를 펼치면 **컨슈머 (N)** 목록과 **가장 오래된 Pending 메시지 (N)** 목록이 나타나고, 다음 두 버튼을 쓸 수 있습니다.
| 버튼 | 동작 |
| --------------- | --------------------------------------------------------- |
| **좀비 정리** | 1시간 넘게 놀고 있으면서 처리 중인 메시지가 하나도 없는 컨슈머만 제거합니다. 데이터 손실이 없습니다 |
| **정체 복구 (>5분)** | 5분 넘게 멈춰 있는 처리 중 메시지를 강제로 완료 처리합니다 |
**정체 복구는 해당 작업을 실행하지 않고 버립니다.** 큐가 막혔을 때만 쓰고, 어떤 작업이 사라지는지 먼저 목록에서 확인하세요.