Skip to main content
Admin › Monitoring › Guardrail Logs
Guardrail logs record all events detected and processed by guardrails configured on agents.
  • Transparently track which user entered which sensitive info and how which guardrail processed it.
Guardrail logs are also available from Admin > Code Gateway > Guardrail Logs, but that screen shows only logs originating from the Code Gateway and its period and filter setup differs. Use this screen (Monitoring › Guardrail Logs) to see chat-originated events as well.
Guardrail Logs main screen

Guardrail Logs main screen — filter area, log table


What are Guardrail Logs?

When users converse with the AI, guardrails validate inputs and outputs.
  • When sensitive info is detected, the configured strategy (Block, Redact, Mask, etc.) is applied and the result is logged.

Log Entry Structure

These are the elements that make up a guardrail log — check Fields · Action Types · Detection Sources in the tabs below. The list shows only six columns — Time, User, Action, Detection Source, Detail, and Original Content — while the remaining items (Chat ID, Message ID, Processed Content, Metadata, and so on) appear when you expand a row.

Filter Options

If you select only Rule or only LLM in the Detection Source chip, logs recorded as missing_metadata, blocked_repo, or flow are excluded from the list. Keep both selected (the default) to see everything.

Log Detail View

Click the arrow on the right of a log entry to expand that row and show its details.
Guardrail log detail — action, detection source, detection detail, original content

Guardrail log detail — action, detection source, detection detail, original content


Tracing Integration

In guardrail log details, the Trace button lets you see the complete processing of that message.
1

Pick an entry in Guardrail Logs

Expand the log entry for the guardrail event you’re investigating.
2

Click Trace

Click the Trace button at the bottom-right of the expanded detail. The button appears only for events that have a Message ID — events without one (such as Code Gateway logs) do not show it.
3

Review the trace list

A new tab opens on Evaluations › Tracing, showing the trace list automatically searched for that Message ID.
4

View full processing

Click a trace in the list to open the Trace Detail, where the left run tree shows the guardrail step (red GD badge) and the right pane shows per-step input and output.
Trace Detail modal — Run tree with guardrail:pii and test-guardrail GD badges, embedding input/output on the right

Trace Detail — guardrail steps (GD badges) in the left Run tree and per-step input/output on the right


Use Cases

  1. Set a period and view logs by Detection Source
  2. Review log action events to gauge false positive rate
  3. Adjust regex or exclude patterns with many false positives
  4. Add new patterns or blocked words for missed detections
  1. Look up a specific user’s guardrail events via user search
  2. Check repeated Block patterns
  3. Review original content to determine intentional sensitive info leak attempts
  4. Cross-analyze with related audit logs for full context
  1. Select only LLM in the Detection Source filter
  2. Review original content of blocked messages
  3. If excessive blocking, strengthen allow examples in the Judge prompt
  4. If missing blocks, add block examples

Guardrail Settings Integration

Improve guardrail settings based on patterns found in guardrail logs.
See Guardrails for guardrail configuration.