---
title: "Trends"
description: "Overview of trends — multi-tag time-series charts for visualizing historical and live data"
source_url: https://ai-ops.com/docs/trends/introduction
---

# Trends

A **trend** in Koios is an interactive time-series chart that plots one or more tag values over time. Use trends to monitor live processes, investigate historical incidents, compare variables side by side, and export data for offline analysis.

## User Trends vs Model Trends

| Type | Created by | Editable | Deletable |
|------|-----------|----------|-----------|
| **User** | You, from the Trends page | Full control over traces, axes, and settings | Yes |
| **Model** | Automatically, when an AI model is enabled | Display settings only — traces and axes are managed by the model | No |

Model trends automatically include the model's bound input and output tags and update when bindings change. You can still customize colors, line styles, and sampling.

## Creating a Trend

Click **Add Trend** from the Trends list. Provide a **name** and optionally a **description** and **X-Axis Span** (the default time window — defaults to 1 hour). After creation, you are taken to the trend detail page to add tags and configure the chart.

> [!TIP] Quick trend from a tag
> You can also create a trend pre-populated with specific tags by navigating from a tag's detail page or the tag list.

## The Trend Detail Page

The detail page has two main areas:

- **Chart area** (left) — the time-series chart with a navigation toolbar
- **Trace panel** (right) — a collapsible sidebar for managing plotted tags and Y-axes

The title and description are editable inline. All changes (traces, axes, settings, name) are held locally until you click **Save**. The browser warns you if you try to leave with unsaved changes.

## Chart Navigation

The toolbar provides date-time pickers, pan/zoom buttons, and a **timespan selector** with presets (1m, 5m, 30m, 1h, 8h, 1d). You can also scroll to zoom, click-drag to pan, and hold **Cmd/Ctrl + drag** to zoom into a specific region.

### Auto-Scroll (Live Mode)

The **Auto Scroll** toggle switches between:

- **On** — the chart scrolls forward in real time with a red **NOW** line marking the current moment. Data updates every second.
- **Off** — the chart stays at the current view so you can freely explore historical data.

The current-moment indicator and the chart's x-axis are anchored to the **server clock**, not the browser clock. If your workstation's wall time is misaligned with the Koios server, the chart still tracks real elapsed time correctly.

> [!TIP] Auto-scroll pauses when you interact
> Zooming or panning while auto-scroll is on automatically pauses it. Toggle the switch back on to resume.

---

## What's Next

- [Traces & Axes](https://ai-ops.com/docs/trends/traces-and-axes.md) — add tags, configure multi-axis layouts, and customize colors
- [Settings & Export](https://ai-ops.com/docs/trends/settings-and-export.md) — adjust sampling, display options, and download data