관리자 › 모니터링 › 가드레일 로그
- 어떤 사용자가 어떤 민감 정보를 입력했고, 어떤 가드레일이 어떻게 처리했는지 투명하게 추적할 수 있습니다.
관리자 > 코드 게이트웨이 > 가드레일 로그 경로에서도 동일한 가드레일 로그를 조회할 수 있습니다.
가드레일 로그 메인 화면 — 필터 영역, 로그 테이블
가드레일 로그란?
사용자가 AI와 대화할 때, 가드레일은 입력과 출력을 검증합니다.- 민감 정보가 탐지되면 설정된 전략(차단, 삭제, 마스킹 등)에 따라 처리하고, 그 결과를 로그로 기록합니다.
로그 항목 구조
가드레일 로그를 구성하는 요소입니다 — 필드 · 처리 액션 · 탐지 방식을 탭에서 확인하세요.- 필드 (10)
- 액션 유형
- Detection Pattern
필터 옵션
로그 상세 보기
로그 항목 우측 화살표를 누르면 해당 행이 펼쳐지며 상세 정보가 표시됩니다.
가드레일 로그 상세 — 동작·감지 소스·감지 상세·원본 내용
- 탐지 상세
- 컨텍스트
추적 연동
가드레일 로그 상세에서 추적 버튼을 통해 해당 메시지의 전체 처리 과정을 확인할 수 있습니다.1
가드레일 로그에서 항목 선택
조사하려는 가드레일 이벤트의 로그 항목을 펼칩니다.
2
추적 클릭
펼친 상세 우측 하단의 추적 버튼을 클릭합니다. 이 버튼은 채팅에서 발생해 Chat ID가 기록된 이벤트에만 표시됩니다(API 직접 호출 등 Chat ID가 없는 이벤트에는 나타나지 않습니다).
3
전체 처리 과정 확인
트레이스 상세 화면이 열려, 해당 메시지의 가드레일 체크를 포함한 전체 처리 과정(Run 트리)을 확인할 수 있습니다. 가드레일 단계는 빨간색 GD 배지로 표시됩니다.
트레이스 상세 — 좌측 Run 트리의 가드레일 단계(GD 배지)와 우측 단계별 입력·출력
활용 사례
가드레일 정책 튜닝
가드레일 정책 튜닝
- 기간을 설정하고 Detection Pattern 별로 로그를 조회합니다
log액션의 이벤트를 검토하여 오탐(false positive) 비율을 파악합니다- 오탐이 많은 패턴은 정규식을 조정하거나 제외합니다
- 미탐지 사례를 발견하면 새로운 패턴이나 금지 단어를 추가합니다
보안 인시던트 대응
보안 인시던트 대응
- 특정 사용자의 가드레일 이벤트를 사용자 검색으로 조회합니다
block액션이 반복되는 패턴을 확인합니다- 원본 내용을 검토하여 의도적 민감 정보 유출 시도 여부를 판단합니다
- 관련 감사 로그와 교차 분석하여 전체 맥락을 파악합니다
LLM Judge 효과 분석
LLM Judge 효과 분석
- Detection Pattern을
LLM-based로 필터링합니다 - 차단된 메시지의 원본 내용을 검토합니다
- 과도한 차단이 있다면 Judge 프롬프트의 허용 예시를 보강합니다
- 누락된 차단이 있다면 차단 예시를 추가합니다
가드레일 설정 연동
가드레일 로그에서 발견한 패턴을 바탕으로 가드레일 설정을 개선할 수 있습니다.가드레일 설정 방법은 가드레일 문서를 참고하세요.