Skip to main content
관리자 › 모니터링 › 가드레일 로그
가드레일 로그는 에이전트에 설정된 가드레일이 탐지하고 처리한 모든 이벤트를 기록합니다.
  • 어떤 사용자가 어떤 민감 정보를 입력했고, 어떤 가드레일이 어떻게 처리했는지 투명하게 추적할 수 있습니다.
관리자 > 코드 게이트웨이 > 가드레일 로그 탭에서도 가드레일 로그를 볼 수 있지만, 그 화면은 코드 게이트웨이에서 발생한 로그만 보여주고 기간·필터 구성도 다릅니다. 채팅에서 발생한 이벤트까지 함께 보려면 이 화면(모니터링 › 가드레일 로그)을 사용하세요.
가드레일 로그 메인 화면 — 필터 영역, 로그 테이블

가드레일 로그 메인 화면 — 필터 영역, 로그 테이블

​
가드레일 로그란?

사용자가 AI와 대화할 때, 가드레일은 입력과 출력을 검증합니다.
  • 민감 정보가 탐지되면 설정된 전략(차단, 삭제, 마스킹 등)에 따라 처리하고, 그 결과를 로그로 기록합니다.

​
로그 항목 구조

가드레일 로그를 구성하는 요소입니다 — 필드 · 동작 유형 · 감지 소스를 탭에서 확인하세요. 목록에는 시간 · 사용자 · 동작 · 감지 소스 · 상세 · 원본 내용 6개 열만 보이고, 나머지 항목(Chat ID · Message ID · 처리된 내용 · 메타데이터 등)은 행을 펼쳤을 때 표시됩니다.

​
필터 옵션

감지 소스 칩에서 규칙 또는 LLM 중 하나만 선택하면 missing_metadata · blocked_repo · flow 로 기록된 로그는 목록에서 제외됩니다. 전부 보려면 둘 다 선택된 기본 상태를 유지하세요.

​
로그 상세 보기

로그 항목 우측 화살표를 누르면 해당 행이 펼쳐지며 상세 정보가 표시됩니다.
가드레일 로그 상세 — 동작·감지 소스·감지 상세·원본 내용

가드레일 로그 상세 — 동작·감지 소스·감지 상세·원본 내용

​
추적 연동

가드레일 로그 상세에서 추적 버튼을 통해 해당 메시지의 전체 처리 과정을 확인할 수 있습니다.
1

가드레일 로그에서 항목 선택

조사하려는 가드레일 이벤트의 로그 항목을 펼칩니다.
2

추적 클릭

펼친 상세 우측 하단의 추적 버튼을 클릭합니다. 이 버튼은 Message ID가 기록된 이벤트에만 표시됩니다(코드 게이트웨이에서 발생한 로그처럼 Message ID가 없는 이벤트에는 나타나지 않습니다).
3

트레이스 목록 확인

새 탭이 열리고 평가 › 추적 화면에 해당 Message ID로 자동 검색된 트레이스 목록이 표시됩니다.
4

전체 처리 과정 확인

목록에서 트레이스를 클릭하면 트레이스 상세가 열려, 좌측 실행 트리에서 가드레일 단계(빨간 GD 배지)와 우측의 단계별 입력·출력을 확인할 수 있습니다.
트레이스 상세 모달 — Run 트리에 guardrail:pii·테스트 가드레일 GD 배지, 우측 embedding 입력·출력

트레이스 상세 — 좌측 Run 트리의 가드레일 단계(GD 배지)와 우측 단계별 입력·출력

​
활용 사례

  1. 기간을 설정하고 감지 소스별로 로그를 조회합니다
  2. log 동작의 이벤트를 검토하여 오탐(false positive) 비율을 파악합니다
  3. 오탐이 많은 패턴은 정규식을 조정하거나 제외합니다
  4. 미탐지 사례를 발견하면 새로운 패턴이나 차단 단어를 추가합니다
  1. 특정 사용자의 가드레일 이벤트를 사용자 검색으로 조회합니다
  2. 차단 동작이 반복되는 패턴을 확인합니다
  3. 원본 내용을 검토하여 의도적 민감 정보 유출 시도 여부를 판단합니다
  4. 관련 감사 로그와 교차 분석하여 전체 맥락을 파악합니다
  1. 감지 소스 필터에서 LLM만 선택합니다
  2. 차단된 메시지의 원본 내용을 검토합니다
  3. 과도한 차단이 있다면 Judge 프롬프트의 허용 예시를 보강합니다
  4. 누락된 차단이 있다면 차단 예시를 추가합니다

​
가드레일 설정 연동

가드레일 로그에서 발견한 패턴을 바탕으로 가드레일 설정을 개선할 수 있습니다.
가드레일 설정 방법은 가드레일 문서를 참고하세요.