메인 콘텐츠로 건너뛰기

​
Opticon에 기록되는 내용

Guardian Bastion은 모든 Guard API 호출에 대해 다음 항목을 Trace로 기록합니다:
  • 사용자가 제출한 원본 입력(text / image / file)
  • 최종 Action과 정책 매칭 결과
  • action == "MASK"인 경우의 마스킹된 Output
  • opticon 필드로 전달한 트레이싱 메타데이터

​
트레이싱 메타데이터 부여

요청 본문에 opticon 객체를 포함합니다: 
{
  "messages": [{ "role": "user", "content": "..." }],
  "opticon": {
    "trace_id": "trace-abc-123",
    "session_id": "chat-session-001",
    "user_id": "end-user-456",
    "metadata": { "environment": "production", "client_version": "2.1.0" },
    "tags": ["chatbot", "customer-service"]
  }
}

​
필드 가이드

Field용도
trace_id애플리케이션 로그와 상관 관계. 생략하면 Guard Server가 자동 생성.
session_id멀티턴 대화의 Trace를 하나의 세션으로 그룹화.
user_id사용자별 분석을 위한 최종 사용자 식별자.
metadata환경, 클라이언트 버전, 리전 등 자유형 key-value.
tagsOpticon 대시보드에서 필터링 가능한 태그.
Credentials는 절대 전달하지 않습니다. Opticon의 public/secret key와 host는 Project 단위로 서버 측에서 관리되며, 클라이언트는 트레이싱 메타데이터만 제공합니다.

​
클라이언트가 제어할 수 없는 항목

  • 보관 기간 (관리자 설정)
  • 마스킹된 Output 저장 여부 (Project 정책에 따름. Input은 항상 저장)
  • Trace 조회 권한 (IAM Policy)