> ## 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.

# トレースのモニタリング（Opticon）

> Opticon → Tracing を使って、すべての Guard 評価を、そのアクション、ポリシーヒット、メタデータとともに確認します。

**Opticon** は Starfort のモニタリングアプリです。すべての Guard 評価について**トレース**を記録するため、各リクエストが何であったか、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>

## トレース一覧

各行は 1 件の Guard API ／ Desktop Agent 呼び出しを表し、入力、Guardian の出力、レイテンシ、**タグ**、そして**スコア**を表示します。Desktop Agent 呼び出しの場合、トレースの **session** は一致した [Control Profile](/ja/v1.2/admin/control-profiles) の名前であり、その **metadata** にはリクエストの URL、HTTP メソッド、Content-Type、ヘッダーが含まれます。入力呼び出しとその出力呼び出しは**1 つの Trace ID** を共有するため、リクエスト→レスポンスの完全なサイクルを 1 つのトレースとして確認できます。API 呼び出しの場合、session は呼び出し元の `session_id` であり、呼び出し元は同じ `trace_id` を渡すことで 2 つの呼び出しをリンクできます。

タグとスコアにより、フィルタリングと集計が簡単になります:

* アクション — `PASS`、`MASK`、`BLOCK`
* ポリシー結果 — 例: `PII Masking Policy:MASK`、`TOPIC:BLOCK`
* 呼び出し元 — 例: API キー名
* ステージ — `process_type:input`
* **スコア** — ポリシー名ごと、ポリシータイプで集約

## トレースの詳細

トレースを開くと全体像を確認できます: 元の入力、`processed_content`（マスクされた出力）、解決された `action`、検出されたすべての項目、そして呼び出しの**メタデータ**（API キー、モデル設定、プロセスタイプ）。

<Frame caption="MASK トレースの詳細 — アクションは 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 トレースの詳細" width="1200" height="626" data-path="images/v1.2/admin/opticon-trace-detail.png" />
</Frame>

<Tip>
  `BLOCK` または `MASK` タグでフィルタリングすると、何が検出され、どのポリシーが検出したかを正確に確認できます — ポリシーのチューニングや[トラブルシューティング](/ja/v1.2/desktop/troubleshooting)の際に非常に役立ちます。
</Tip>

## 保持期間と Opticon が行わないこと

Opticon はランタイムデータのみを表示します。組織、プロジェクト、メンバーの管理はすべてコンソールに存在します。Opticon からそれらを**作成・削除することはできません**（Starfort が信頼できる唯一の情報源です）。コンソールのロールはここでも引き継がれます。

トレースの**保持期間**は Opticon で設定されますが、トレースが**手動で削除されることはありません** — トレースごとの削除も一括削除もなく、プロジェクトを削除してもそのトレースは削除されません。削除されるのは保持サイクルによってのみです。これは記録を完全な状態に保つための設計です。（ガバナンス変更 — 誰が設定を変更したか — は、別途の[監査ログ](/ja/v1.2/admin/audit-log)にあります。）
