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.

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.

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.

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 — add tags, configure multi-axis layouts, and customize colors
Settings & Export — adjust sampling, display options, and download data

Troubleshooting a Model Traces & Axes