Skip to main content
관리자 › 모니터링 › 파일 로그
파일 로그(File Logs)는 가드레일 분석 결과가 있는 파일의 보안 모니터링 기능입니다.
  • 업로드된 파일의 민감도 분류, 차단 여부, 보안 검사 결과를 관리자가 한눈에 확인할 수 있습니다.
파일 로그 메인 화면 — 필터 바, 테이블, 소스/분류 뱃지

파일 로그 메인 화면 — 필터 바, 테이블, 소스/분류 뱃지

모든 업로드 파일이 표시되는 것이 아닙니다. 민감도 분류(classification) 또는 가드레일 차단(guardrail_blocked) 결과가 있는 파일만 로그에 나타납니다.

​
문서 민감도 분류

파일 업로드 시 LLM 기반 분류기가 문서의 민감도를 자동 판별합니다. 각 분류 결과에는 신뢰도(confidence) 점수(0~100%)와 분류 사유가 함께 기록됩니다.

​
가드레일 검사 유형

파일 유형에 따라 여러 보안 검사가 자동 적용됩니다.
LLM 기반 민감도 분류입니다. 문서 텍스트를 분석하여 PUBLIC ~ RESTRICTED 등급을 판정합니다.
  • 대상: 텍스트 추출 가능한 모든 파일 (PDF, DOCX, TXT 등)
  • 결과: 분류 등급 + 신뢰도 + 사유
  • 처리: CONFIDENTIAL은 플래그, RESTRICTED는 차단

​
로그 조회

  • 페이지당 20건 표시
  • 상단에 총 파일 수 표시
  • 20건 초과 시 페이지 이동 컨트롤 표시

​
상세 보기

테이블 행을 클릭하면 파일의 가드레일 분석 결과를 모달로 확인합니다.
파일 상세 모달 — 가드레일 분석 결과

파일 상세 모달 — 파일 정보·업로더·분류 결과·가드레일 상세 JSON

표시 항목:
  • 파일 정보: 파일명, 콘텐츠 타입, 크기(KB)
  • 업로더 정보: 이름, 이메일, 업로드 일시
  • 소스: 업로드 경로 뱃지
  • 분류 결과:
    • 민감도 등급 + 신뢰도(%)
    • 분류 사유
    • 사용된 분류 모델
    • 오류 발생 시 에러 메시지
  • 가드레일 상세 (해당 시):
    • 차단 사유 및 상세 JSON
    • EXIF 제거 결과
    • NSFW 탐지 결과

​
파일 처리 흐름

​
활용 사례

  1. 분류 필터를 CONFIDENTIAL로 설정
  2. 플래그된 파일 목록을 검토
  3. 상세 모달에서 분류 사유와 신뢰도 확인
  4. 필요 시 가드레일 설정에서 정책 조정
  1. 소스 필터로 Chat / Knowledge / Project별 업로드 현황 확인
  2. 특정 소스에서 차단이 많은 경우 해당 워크플로우 점검
  3. Knowledge 업로드의 분류 결과를 검토하여 RAG 데이터 품질 관리
  1. 상태 필터를 Blocked로 설정
  2. 차단된 파일의 업로더와 사유 확인
  3. 상세 모달에서 가드레일 상세 JSON 검토
  4. 오탐(false positive)인 경우 가드레일 규칙 수정 검토

​
모범 사례

  • 정기 모니터링: 주 1회 이상 파일 로그를 검토하여 이상 패턴을 탐지하세요
  • 가드레일 연동: 차단/플래그가 빈번한 경우 가드레일 설정을 검토하세요
  • 오탐 관리: CONFIDENTIAL/RESTRICTED 분류의 신뢰도가 낮은 경우 분류 모델 변경을 고려하세요
  • 소스 분석: 특정 소스에서 민감 파일이 집중되는 패턴을 주시하세요