어떤 사용자가 어떤 민감 정보를 입력했고, 어떤 가드레일이 어떻게 처리했는지 투명하게 추적할 수 있습니다.
관리자 > 코드 게이트웨이 > 가드레일 로그 탭에서도 가드레일 로그를 볼 수 있지만, 그 화면은 코드 게이트웨이에서 발생한 로그만 보여주고 기간·필터 구성도 다릅니다. 채팅에서 발생한 이벤트까지 함께 보려면 이 화면(모니터링 › 가드레일 로그)을 사용하세요.
가드레일 로그 메인 화면 — 필터 영역, 로그 테이블
가드레일 로그란?
사용자가 AI와 대화할 때, 가드레일은 입력과 출력을 검증합니다.
민감 정보가 탐지되면 설정된 전략(차단, 삭제, 마스킹 등)에 따라 처리하고, 그 결과를 로그로 기록합니다.
로그 항목 구조
가드레일 로그를 구성하는 요소입니다 — 필드 · 동작 유형 · 감지 소스를 탭에서 확인하세요.목록에는 시간 · 사용자 · 동작 · 감지 소스 · 상세 · 원본 내용 6개 열만 보이고, 나머지 항목(Chat ID · Message ID · 처리된 내용 · 메타데이터 등)은 행을 펼쳤을 때 표시됩니다.
필드
동작 유형
감지 소스
필드
설명
시간
탐지 이벤트 발생 시간
사용자
입력한 사용자 (이름, 이메일)
Chat ID
해당 대화 세션
Message ID
해당 메시지 식별자
가드레일
적용된 가드레일 이름
동작
처리 전략 (차단, 삭제, 마스킹 등)
감지 소스
탐지 방식 (규칙 / LLM)
감지 상세
탐지된 구체적 내용 (목록에서는 상세)
원본 내용
원본 입력 텍스트
처리된 내용
전략 적용 후 텍스트
처리 전략별로 기록되는 동작입니다.
동작
설명
차단(block)
메시지 전체 차단
삭제(redact)
민감 정보를 라벨로 대체 (예: [REDACTED_EMAIL])
마스킹(mask)
일부 문자만 표시 (예: j***@***.com)
해시(hash)
해시값으로 변환
log
차단 없이 로그만 기록
warn
차단하지 않고 경고로 기록 (코드 게이트웨이 메타데이터 누락 정책)
log · warn 은 번역 라벨이 없어 한국어 화면에서도 영문 그대로 표시됩니다.
감지 소스는 목록·상세에 개별 소스로 표시되고, 필터 칩에서는 규칙(정규식·패턴 매칭)과 LLM(LLM 기반 판정) 두 그룹으로 묶여 선택합니다.
그룹
감지 소스
설명
규칙
개인정보(pii)
이메일·신용카드·IP 주소 등 개인정보 패턴 탐지
규칙
커스텀 패턴(custom_pattern)
사용자 정의 정규식 패턴 탐지
규칙
차단 단어(blocked_word)
차단 단어/문구 감지
LLM
LLM 기반 탐지(llm_judge)
LLM 기반 콘텐츠 위험도 판정
위 네 가지 외에, 코드 게이트웨이와 에이전트 플로우에서 발생한 이벤트는 missing_metadata(리포지토리 메타데이터 누락) · blocked_repo(차단된 리포지토리 접근) · flow(플로우 실행 중 차단)로 기록되며, 번역 라벨이 없어 목록 뱃지에 이 영문 값이 그대로 표시됩니다.
필터 옵션
필터
설명
기간
최근 1시간 · 6시간 · 1일 · 7일 · 30일 · 전체 · 사용자 정의 (기본 최근 1시간)
동작
실제로 기록된 값만 선택지로 나타납니다(복수 선택). 감지 소스 · 출처 · 사용자 검색을 바꾸면 선택지가 다시 계산되고, 남지 않은 값은 선택에서 자동 해제됩니다.
감지 소스
규칙 / LLM 중 선택 (복수 선택, 기본은 둘 다 선택 = 전체)
사용자 검색
사용자 ID, 이메일 또는 이름으로 검색
Chat ID
Chat ID 전체 또는 앞부분만 입력해도 해당 세션의 로그가 조회됩니다
출처
이벤트가 발생한 경로 — 채팅 / 게이트웨이 중 선택 (복수 선택, 기본은 둘 다 선택 = 전체)
감지 소스 칩에서 규칙 또는 LLM 중 하나만 선택하면 missing_metadata · blocked_repo · flow 로 기록된 로그는 목록에서 제외됩니다. 전부 보려면 둘 다 선택된 기본 상태를 유지하세요.
로그 상세 보기
로그 항목 우측 화살표를 누르면 해당 행이 펼쳐지며 상세 정보가 표시됩니다.
가드레일 로그 상세 — 동작·감지 소스·감지 상세·원본 내용
탐지 상세
컨텍스트
항목
설명
가드레일
적용된 가드레일 이름
감지 소스
탐지된 개별 감지 소스가 뱃지로 표시됩니다 (예: 개인정보)
감지 상세
탐지된 구체적 패턴 또는 항목
원본 내용
사용자가 입력한 원문
처리된 내용
전략 적용 후 결과
항목
설명
사용자
이름, 이메일
Chat ID
대화 세션 식별자
Message ID
메시지 식별자
메타데이터
추가 컨텍스트 정보 (소스 등)
추적 연동
가드레일 로그 상세에서 추적 버튼을 통해 해당 메시지의 전체 처리 과정을 확인할 수 있습니다.
1
가드레일 로그에서 항목 선택
조사하려는 가드레일 이벤트의 로그 항목을 펼칩니다.
2
추적 클릭
펼친 상세 우측 하단의 추적 버튼을 클릭합니다. 이 버튼은 Message ID가 기록된 이벤트에만 표시됩니다(코드 게이트웨이에서 발생한 로그처럼 Message ID가 없는 이벤트에는 나타나지 않습니다).
3
트레이스 목록 확인
새 탭이 열리고 평가 › 추적 화면에 해당 Message ID로 자동 검색된 트레이스 목록이 표시됩니다.
4
전체 처리 과정 확인
목록에서 트레이스를 클릭하면 트레이스 상세가 열려, 좌측 실행 트리에서 가드레일 단계(빨간 GD 배지)와 우측의 단계별 입력·출력을 확인할 수 있습니다.