---
title: "Dashboard"
description: "Create customizable dashboards with live widgets for monitoring tags, devices, and AI models"
source_url: https://ai-ops.com/docs/dashboard/introduction
---

# Dashboard

The dashboard is the landing page of Koios — a customizable grid of live widgets for at-a-glance monitoring. You can create multiple dashboards, each with its own set of widgets tailored to a specific process, area, or role.

## Managing Dashboards

Use the **dropdown** at the top of the page to switch between dashboards. The dropdown menu also provides options to create a new dashboard, rename the current one, or delete it. When you create a dashboard, you can mark it as the **default** so it loads automatically on login.

## Customize Mode

Click **Customize** to enter edit mode. In this mode:

- Widgets show drag handles and resize grips
- You can **drag** widgets to reposition them on the grid
- You can **resize** widgets by dragging the bottom-right corner
- Edit, duplicate, and delete icons appear on each widget
- The **Add Widget** button becomes available

Layout changes are saved automatically. Click **Done** to exit edit mode.

## Adding a Widget

In customize mode, click **Add Widget** to open the widget configuration modal:

1. **Choose a widget type** from the grouped dropdown (Tags, Devices, or Models)
2. **Select the entity** — the tag, device, or model the widget will display
3. **Set a title** (optional — defaults to the widget type name)
4. **Configure display settings** using the tabs (varies by widget type)

The widget is placed at the first available position on the grid. You can drag it to a different spot after adding.

## Widget Types

### Tag Widgets

| Widget | Description |
|--------|-------------|
| **Tag Value** | Displays a single tag's live value with an optional ring gauge showing where the value falls within its configured range |
| **Tag Chart** | Plots one or more tags over time as a live-updating line chart |

### Device Widgets

| Widget | Description |
|--------|-------------|
| **Device Status** | Shows the device's connection state (Running, Stopped, or Failed) with optional error message |
| **Device Uptime** | Bar chart showing historical uptime segments |
| **Device Execution** | Bar chart of recent scan cycle durations |

### Model Widgets

| Widget | Description |
|--------|-------------|
| **Model Status** | Shows the model's inference state with optional error message |
| **Model Uptime** | Bar chart showing historical uptime segments |
| **Model Execution** | Bar chart of recent inference cycle durations |

## Widget Configuration

Each widget type has its own display settings, accessible when adding or editing a widget.

### Tag Value

| Tab | Settings |
|-----|----------|
| **Text** | Font size (sm / md / lg / xl), font weight, text color (auto or fixed) |
| **Labels** | Decimal places override (-1 to 6, or auto from tag config), show units, show tag name |
| **Ring** | Show ring gauge, ring color, ring size (60–200 px), ring thickness (1–20 px) |

When set to **auto**, text and ring colors follow the tag's live status — teal for running, red for failed, gray for stopped.

### Tag Chart

| Tab | Settings |
|-----|----------|
| **Time** | History period: 5 min, 10 min, 30 min, 1 hour, 8 hours, or 24 hours |
| **Line** | Line width, line smoothing, point size |
| **Fill** | Fill area under lines, fill opacity |
| **Display** | Show X-axis, show Y-axis, show legend |

Multiple tags can be added to a single chart widget. Each tag gets a unique color automatically.

### Status Widgets (Device & Model)

| Tab | Settings |
|-----|----------|
| **Text** | Font size, font weight, text color (auto or fixed) |
| **Labels** | Show entity name, show error message |

Uptime and Execution widgets require only an entity selection — no additional display settings.

## Editing & Duplicating Widgets

In customize mode, click the **gear icon** on a widget to edit its title, entity, or display settings. Click the **copy icon** to duplicate a widget with all its settings. The duplicate is automatically placed at the next available position.

## Grid Layout

The dashboard uses a 12-column responsive grid. Widgets snap to grid cells and cannot overlap. On smaller screens the grid reduces to fewer columns (6 on tablets, 4 on large phones, 2 on small phones) and widgets reflow accordingly.