> ## Documentation Index
> Fetch the complete documentation index at: https://docs.starfort.io/llms.txt
> Use this file to discover all available pages before exploring further.

# trace 모니터링 (Opticon)

> Opticon → Tracing을 사용하여 모든 Guard 평가와 그 동작, 정책 적중, 메타데이터를 확인합니다.

**Opticon**은 Starfort의 모니터링 앱입니다. 모든 Guard 평가에 대해 **trace**를 기록하므로, 각 요청이 정확히 무엇이었고 Guardian이 어떻게 판단했는지 확인할 수 있습니다.

프로젝트(또는 해당 Guardian)에서 **Opticon** 링크를 통해 Opticon을 연 다음, 왼쪽 내비게이션에서 **Tracing**을 선택합니다.

<Frame caption="Opticon → Tracing">
  <img src="https://mintcdn.com/aimintelligence/A1_c5EL9JAZ7xlFg/images/v1.2/admin/opticon-tracing-list.png?fit=max&auto=format&n=A1_c5EL9JAZ7xlFg&q=85&s=ca3b5350feea43406e2aab333f261552" alt="Tracing 내비게이션 항목이 강조 표시된 Opticon" width="1200" height="626" data-path="images/v1.2/admin/opticon-tracing-list.png" />
</Frame>

## trace 목록

각 행은 하나의 Guard API / Desktop Agent 호출이며, 입력, Guardian의 출력, 지연 시간, **tags**, 그리고 **scores**를 보여줍니다. Desktop Agent 호출의 경우, 트레이스의 **session**은 매칭된 [Control Profile](/ko/v1.2/admin/control-profiles) 이름이고, 그 **metadata**에는 요청의 URL, HTTP 메서드, Content-Type, 헤더가 담깁니다. 입력 호출과 그 출력 호출은 **하나의 Trace ID**를 공유하므로, 전체 요청→응답 주기를 하나의 트레이스로 볼 수 있습니다. API 호출의 경우, session은 호출자의 `session_id`이며, 호출자는 동일한 `trace_id`를 전달하여 두 호출을 연결할 수 있습니다.

tags와 scores를 사용하면 쉽게 필터링하고 집계할 수 있습니다:

* 동작 — `PASS`, `MASK`, `BLOCK`
* 정책 결과 — 예: `PII Masking Policy:MASK`, `TOPIC:BLOCK`
* 호출자 — 예: API 키 이름
* 단계 — `process_type:input`
* **scores** — 정책 이름별로, 정책 유형별로 집계됨

## trace 상세 정보

trace를 열면 전체 내용을 확인할 수 있습니다: 원본 입력, `processed_content`(마스킹된 출력), 결정된 `action`, 감지된 모든 항목, 그리고 호출 **metadata**(API 키, 모델 구성, process type).

<Frame caption="MASK trace 상세 정보 — 동작은 MASK입니다">
  <img src="https://mintcdn.com/aimintelligence/A1_c5EL9JAZ7xlFg/images/v1.2/admin/opticon-trace-detail.png?fit=max&auto=format&n=A1_c5EL9JAZ7xlFg&q=85&s=349507d9af82597115ccd1277cd19920" alt="MASK 동작이 강조 표시된 Opticon trace 상세 정보" width="1200" height="626" data-path="images/v1.2/admin/opticon-trace-detail.png" />
</Frame>

<Tip>
  `BLOCK` 또는 `MASK` 태그로 필터링하여 정확히 무엇이 포착되었고 어떤 정책이 포착했는지 검토하세요 — 정책을 조정하거나 [문제를 해결](/ko/v1.2/desktop/troubleshooting)할 때 매우 유용합니다.
</Tip>

## 보존 기간과 Opticon이 하지 않는 일

Opticon은 런타임 데이터만 보여줍니다. 조직, 프로젝트, 구성원 관리는 모두 Console에 있으며 — Opticon에서는 이를 **생성하거나 삭제할 수 없고**(Starfort가 단일 진실 공급원입니다), Console의 역할이 여기로 이어집니다.

트레이스 \*\*보존 기간(retention)\*\*은 Opticon에서 설정하지만, 트레이스는 **수동으로 절대 삭제되지 않습니다** — 트레이스별 또는 일괄 삭제가 없고, 프로젝트를 삭제해도 그 트레이스가 제거되지 않으며, 오직 보존 주기만이 이를 제거합니다. 기록이 온전하게 유지되도록 의도된 설계입니다. (거버넌스 변경 — 누가 구성을 변경했는가 — 은 별도의 [Audit Log](/ko/v1.2/admin/audit-log)에 있습니다.)