# Metrics

> Build product analytics for AI applications using natural language

Metrics let you track patterns in conversations that would be impossible to capture with traditional event-based analytics. Define what you want to measure using plain text — just like [policies](https://whitecircle.com/docs/latest/first-steps/policies.md) — and White Circle handles the rest.

## Example Use Cases

### Customer Support Bot

* Was the user's issue resolved?
* How often do users express frustration?
* How often do users ask for help?

### AI Coding Assistant

* How often do users ask for bug fixes vs. new features vs. documentation?
* Are users asking follow-up questions after code generation?
* What programming languages are most requested?

### Educational Tutor

* Did the student understand the explanation?
* How often do users ask for simpler explanations?
* What topics generate the most questions?

### Sales Assistant

* Did the user express purchase intent?
* What objections come up most frequently?
* How often do users ask about pricing?

## How Metrics Work

Metrics let you define what you want to measure using plain language — just like [policies](https://whitecircle.com/docs/latest/first-steps/policies.md).
Unlike Policies, which enforce behavior, Metrics help you analyze and understand it.

Each Metric has two components:

- **Included Content**: Describe what should **count** toward this Metric.
- **Excluded Content**: Describe what should be **excluded**, even if it seems similar.

> [!NOTE]
> Metrics are computed for submitted content that matches the Metric configuration. When you use Events, send stable `run_id`, `event_id`, `external_session_id`, and `metadata` values so analytics can be linked back to your application.

### Example: Feature Request Detection

To track how often users request new features:

* **Included:** "User asks for a new capability, requests functionality that doesn't exist, suggests improvements or additions"
* **Excluded:** "Bug reports, questions about existing features, general feedback without specific feature requests"

## Metrics vs. Policies

While Metrics and Policies use the same definition approach, they serve different purposes:

| Aspect           | Policies                   | Metrics                       |
| ---------------- | -------------------------- | ----------------------------- |
| **Purpose**      | Content moderation         | Product analytics             |
| **Processing**   | Real-time                  | Asynchronous                    |
| **API Response** | Immediate `flagged` result | Results arrive asynchronously |
| **Use Case**     | Block or flag content      | Understand user behavior      |

> [!NOTE]
> Metrics are processed in the background, which allows us to compute a large number of Metrics at scale. There's a delay before results become available in your dashboard.

## Getting Started

Creating a Metric follows the same workflow as Policies:

1. **Open the Metrics Page**

   Go to the [Metrics page](https://eu.whitecircle.com/metrics) in your White Circle dashboard.

2. **Create a New Metric**

   Click **Add Metric** and give it a descriptive name like "Feature Requests" or "User Satisfaction".

3. **Define Your Metric**

   Write what should be included and excluded using plain language.

4. **Save and Start Tracking**

   Once saved, Metrics are computed for matching content sent through your Environment, including Events submitted to [`/api/event`](https://whitecircle.com/docs/latest/events/check-event.md) and [`/api/events`](https://whitecircle.com/docs/latest/events/check-events.md).

## Viewing Analytics

On the platform, you can view analytics for each Metric, including trends over time and matched content.

> [!TIP]
> We recommend sending `metadata.user` with your Events from day one. This lets you segment Metrics by user attributes and get meaningful insights as soon as dashboards with filtering capabilities become available.

***

## Next Steps

- **[Create a Metric](https://eu.whitecircle.com/metrics)**: Open the platform and define your first Metric
- **[Check Events](https://whitecircle.com/docs/latest/events/check-event.md)**: Learn how to send Events with metadata for richer analytics
