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

# Events

> Timeline annotations you create to mark moments in time on charts and correlate metric movements with product or business changes.

**Events** in Nebuly are timeline annotations you create to mark moments in time on charts. They appear as vertical lines on time-series visualizations and let you correlate metric movements with product, marketing, or business changes: a model rollout, a prompt update, a marketing push, an incident, a release.

Events are not user data and are not ingested through the [Interaction API](https://docs.nebuly.com/tracking/api-reference/events/post-events-interaction-with-trace-v2). They are configuration objects, scoped **per project**, that you create and manage directly in the platform.

## When to use events

* **Mark releases.** Tag the day you shipped a new model version, prompt, or RAG pipeline so you can see whether sentiment, error rate, or task completion changed afterwards.
* **Mark marketing or onboarding pushes.** When you run a campaign that drives new users to the AI product, an event helps explain spikes in conversation volume.
* **Mark incidents.** A model provider outage or a backend bug becomes much easier to investigate when it is annotated on the chart.
* **Mark business milestones.** Quarter ends, fiscal-year boundaries, or compliance deadlines.

## Create an event

**From a chart**: click on the chart's time axis at the moment you want to annotate. This is the fastest way to capture an event in the flow of analysis.

<Frame caption="Creating an event directly from a chart's time axis">
  <img className="rounded-xl" src="https://mintcdn.com/nebulyai/G04Jo9hLv86JYsPM/images/events-create-1.png?fit=max&auto=format&n=G04Jo9hLv86JYsPM&q=85&s=7636ddfa13d9df876586206e7ce9db15" alt="Creating an event from a chart" width="1266" height="694" data-path="images/events-create-1.png" />
</Frame>

<Frame caption="The event creation dialog">
  <img className="rounded-xl" src="https://mintcdn.com/nebulyai/G04Jo9hLv86JYsPM/images/events-create-2.png?fit=max&auto=format&n=G04Jo9hLv86JYsPM&q=85&s=1ac4a194b101de8bbc8b8264b889c7b5" alt="Event creation dialog" width="1086" height="472" data-path="images/events-create-2.png" />
</Frame>

When creating an event you can specify:

* A **title** (e.g. `Model upgraded to GPT-4o`).
* A **timestamp**.

## Visualize events

Once created, events show up as vertical reference lines on every time-series chart in the project. You can hover an event to see its title and description.

In most chart configurations there is a toggle to **show or hide events** on a per-chart basis, which is useful when you want a clean export or are presenting a single metric without the visual noise of multiple annotations.