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

# Monitor Overview

> Monitor is the 'Airtag' for GenAI workflows - it gives you full observability over every generative AI workflow you run. It continuously scores outputs with DeepRails’ Guardrail Metrics; tracks usage, cost, latency, and failure rates in real time; and surfaces regressions before they reach your users.

## Why Monitor Exists

Blind spots in production GenAI cost teams time, money, and trust. Monitor identifies and closes those gaps. It evaluates live traffic with the same research-backed Guardrail Metrics and Extended AI Capabilities used across DeepRails and highlights trends and regressions so you can fix issues fast and improve with confidence.

## Key Definitions

* **Guardrail Metrics:** DeepRails’ General-Purpose Guardrail Metrics for correctness, completeness, adherence (instruction, context, ground truth), and comprehensive safety. Custom Guardrail Metrics are supported on SME & Enterprise plans.
* **Monitor:** A read-only evaluation pipeline for a specific LLM use case or surface. A monitor receives your input/output pairs and model metadata, scores them with selected guardrails, and exposes real-time metrics, trends, and drill-downs. It does **not** remediate outputs (use **Defend** for correction).
* **Nametag:** An optional label you attach to events (e.g., “staging”, “release-2025-09”, “feature-x”) to slice charts, compare cohorts, and run A/B or pre/post analyses.
* **Extended AI Capabilities:** Many LLM applications have to go beyond model knowledge. DeepRails provides access to advanced tools like web and file search and context awareness for evaluations if needed.

## How to Use Monitor

Maximizing Monitor's diagnostic potential is simple when following these steps:

<Steps>
  <Step title="Define a Monitor">
    Name the use case you want to observe and select the guardrail metrics to apply. If the use case being monitored uses tools like file or web search, enable those Extended AI Capabilities for the Monitor.
  </Step>

  <Step title="Stream Events">
    Send each model completion (input/output pair, model used, and optional nametag). Monitor ingests this traffic continuously from staging or production.
  </Step>

  <Step title="Evaluate at Ingest">
    Monitor scores every output against your selected guardrails, associates operational signals (latency, tokens, cost), and indexes the event for search and analysis.
  </Step>

  <Step title="Analyze Trends">
    Dashboards update in real time—track request volume, failure rate, latency, tokens, and cost; examine guardrail distributions; compare cohorts via filters and time windows.
  </Step>

  <Step title="Investigate & Act">
    Drill into any event to see per-metric scores and rationales. Use findings to fix prompts, tune models, adjust thresholds, and more.
  </Step>
</Steps>

## Console Walkthrough

The Monitor Console brings observability to life across three tabs: **Metrics**, **Data**, and **Manage Monitors**.

### Monitor Metrics

The **Monitor Metrics** tab shows real-time operational and quality performance for a selected monitor: request volume, failure rate, latency, tokens, and cost—plus guardrail score distributions that reveal drift and regressions at a glance.

<Frame caption="Operational and economic signals (top) with guardrail score distributions (bottom) help you spot regressions, latency spikes, and quality drift in real time.">
  <img src="https://mintcdn.com/deeprails-479f3a7b/KdzBGLVi0OKvQaB4/images/monitor_api_console.png?fit=max&auto=format&n=KdzBGLVi0OKvQaB4&q=85&s=e67f19b57904f15d3976c9e94553e987" alt="Monitor Metrics dashboard with cost, volume, failure rate, tokens, latency and guardrail histograms" width="2654" height="1457" data-path="images/monitor_api_console.png" />
</Frame>

### Monitor Data

The **Monitor Data** tab lists every evaluated event for deep inspection. Filter by monitor, metrics, status, model, date range, or nametag; search by run ID or prompt; and open any row to view full details.

<Frame caption="Event table with flexible filters for monitor, metrics, status, model, and time window. Use nametags to compare releases and cohorts.">
  <img src="https://mintcdn.com/deeprails-479f3a7b/KdzBGLVi0OKvQaB4/images/monitor_data.png?fit=max&auto=format&n=KdzBGLVi0OKvQaB4&q=85&s=156afa4ccadd8113edd3cacf5d927e39" alt="Monitor Data table of evaluated runs with filters and guardrail score columns" width="2505" height="1438" data-path="images/monitor_data.png" />
</Frame>

<Frame caption="Event details show per-metric scores and rationales, status, processing time, and the original input/output for precise debugging.">
  <img src="https://mintcdn.com/deeprails-479f3a7b/KdzBGLVi0OKvQaB4/images/monitor_data_details.png?fit=max&auto=format&n=KdzBGLVi0OKvQaB4&q=85&s=856c57fa73f0fbbeae5ca4700cc2d163" alt="Monitor Data event detail panel with evaluation metrics and rationales" width="2650" height="1457" data-path="images/monitor_data_details.png" />
</Frame>

### Manage Monitors

The **Manage Monitors** tab is where you create and maintain all monitors associated with your account. See when each monitor last received traffic, how many outputs it has evaluated, and more.

<Frame caption="Create a new monitor with a name and description, and manage existing monitors with last-used status and total outputs evaluated.">
  <img src="https://mintcdn.com/deeprails-479f3a7b/KdzBGLVi0OKvQaB4/images/manage_monitors.png?fit=max&auto=format&n=KdzBGLVi0OKvQaB4&q=85&s=a7ba159fa77c8cf270334e4ade41633e" alt="Manage Monitors screen with create form and active monitors list" width="2540" height="1456" data-path="images/manage_monitors.png" />
</Frame>

#### Creating a Monitor

The creation wizard walks you through three simple steps to define how Monitor will analyze outputs:

<Steps>
  <Step title="Step 1 — Basic Information">
    Start by naming your monitor and (optionally) describing what it protects against. This helps keep monitors organized and clear for your team.

    <Frame caption="Provide a monitor name and optional description to define the purpose of your new monitor.">
      <img src="https://mintcdn.com/deeprails-479f3a7b/KdzBGLVi0OKvQaB4/images/create_a_monitor_1.png?fit=max&auto=format&n=KdzBGLVi0OKvQaB4&q=85&s=6a921a3959a83c4af738456a78c0e33e" alt="Monitor creation step 1 basic information" width="1365" height="832" data-path="images/create_a_monitor_1.png" />
    </Frame>
  </Step>

  <Step title="Step 2 — Select Metrics">
    Choose which guardrail metrics the monitor should analyze. Multiple guardrails can be combined, including correctness, completeness, adherence, and safety.

    <Frame caption="Select one or more guardrail metrics such as correctness, completeness, adherence, and comprehensive safety.">
      <img src="https://mintcdn.com/deeprails-479f3a7b/KdzBGLVi0OKvQaB4/images/create_a_monitor_2.png?fit=max&auto=format&n=KdzBGLVi0OKvQaB4&q=85&s=59ba3b544ae0a02d76d73673227c29c8" alt="Monitor creation step 2 select metrics" width="1366" height="1149" data-path="images/create_a_monitor_2.png" />
    </Frame>
  </Step>

  <Step title="Step 3 — Extended AI Capabilities">
    Choose which additional tools will be needed to complete evaluations for your workflow. Each will add cost, so only select a tool if your initial model uses it.

    <Frame caption="Select one or more extended capabilities such as file search or web search.">
      <img src="https://mintcdn.com/deeprails-479f3a7b/KdzBGLVi0OKvQaB4/images/create_a_monitor_3.png?fit=max&auto=format&n=KdzBGLVi0OKvQaB4&q=85&s=196ca962676608598c1ff64331dc6661" alt="Monitor creation step 3 select metrics" width="1369" height="1096" data-path="images/create_a_monitor_3.png" />
    </Frame>
  </Step>
</Steps>
