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 to open the create dialog. It has three tabs: General (name, description, X-Axis Span), Sampling, and Display. The Sampling and Display tabs expose the same window, aggregate, and chart-style options as the settings drawer, so you can set them at creation or accept the defaults and tune them later.

The X-Axis Span toggle sets the chart's default time window. Auto (the default) remembers your last zoom level between sessions. Fixed sets an explicit window that starts at 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

How edits are saved depends on whether the trend already exists:

New trend: all changes (traces, axes, settings, name, description) are held locally until you click Save Trend, and the browser warns you if you try to leave with unsaved changes. The name and description are edited inline in the header.
Existing trend: every trace, axis, color, setting, and name change auto-saves immediately, optimistically, and reverts if the save fails. There is no Save button and no leave warning. Edit the name and description from the pencil (Edit Details) modal in the header.

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.

Managing Trends

From the Trends list, right-click a row (or use its actions menu) to duplicate or delete a trend. Duplicating copies its traces, axes, and display settings into a new trend. You can also duplicate the open trend from the copy icon in the detail-page header.

To delete several trends at once, select them with the row checkboxes and choose Delete from the bulk actions menu. Model-managed trends cannot be deleted; they are controlled by their AI model.

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 Tag Traces & Axes