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

# Visualization types

> Overview of available visualization types for monitoring dashboards.

## Timeseries

What it shows

* A line chart plotting one or more numeric series over time.

When to use it

* Compare several devices, sensors, or metrics on the same time axis.

Interactions and info available

* Hover the chart to see exact values and timestamps in the tooltip.
* Zoom and pan the time range (use the dashboard time picker or, where available, drag to zoom).
* Toggle series visibility using the legend (if enabled) to focus on specific lines.
* When trace exemplars are present, markers are shown on the chart and can be clicked to open the related trace.

<img src="https://mintcdn.com/insaion/dkLh615XOmGRTVSX/assets/monitoring/timeseries.png?fit=max&auto=format&n=dkLh615XOmGRTVSX&q=85&s=b8ac1ee275ce74b733fcaf2fc43f06e0" alt="Timeseries panel screenshot" width="2420" height="722" data-path="assets/monitoring/timeseries.png" />

***

## Logs

What it shows

* A paginated or streaming view of log entries. Each row is a log event with timestamp and structured fields.

When to use it

* Investigate events, errors, or textual traces emitted by devices and services.

Interactions and info available

* Use Log Text Search in panel query settings with: contains, does not contain, or matches regex.
* Severity and level values are surfaced with stronger visual cues to make important lines stand out.
* Tag values are shown inline and in expandable detail rows for faster triage.
* If a trace id is detected in a row, use the Trace action to open that trace immediately.
* Click an entry to expand details and inspect related fields.
* Tail or stream live logs when the dashboard is in live mode.

<img src="https://mintcdn.com/insaion/SPQ_dqrgyz5M8w_s/assets/monitoring/logs.png?fit=max&auto=format&n=SPQ_dqrgyz5M8w_s&q=85&s=f7884ee3aa40acd75d830104de4a1304" alt="Logs panel screenshot" width="984" height="589" data-path="assets/monitoring/logs.png" />

***

## Trace drill-down

What it shows

* A trace waterfall and span details opened from related logs or metric exemplars.

When to use it

* Move from symptoms to root cause by jumping from a log line or timeseries marker into a full trace view.

Interactions and info available

* Open from Logs: click Trace on a row with a detected trace id.
* Open from Timeseries: click a trace exemplar marker.
* Review span hierarchy, timing, and service-level context in the trace drawer.

<img src="https://mintcdn.com/insaion/SPQ_dqrgyz5M8w_s/assets/monitoring/trace-drilldown.png?fit=max&auto=format&n=SPQ_dqrgyz5M8w_s&q=85&s=0c669e7e79fc4039c8bd712e8eacf0b3" alt="Trace drawer screenshot" width="2522" height="1279" data-path="assets/monitoring/trace-drilldown.png" />

Tip:

* Trace discovery is context-driven. If you do not see traces immediately, narrow the time range around an incident and check related logs/metrics first.

***

## Gauge

What it shows

* A single-value radial gauge that highlights the current value relative to configured min/max and thresholds.

When to use it

* Monitor a single key indicator that needs to be visible at a glance, such as CPU usage, battery level, or temperature.

Interactions and info available

* Numeric value and optional progress visualization in the ring.
* Threshold colors indicate normal, warning, or critical ranges.
* Configure min/max, thresholds, units, and number of decimals in the panel settings.

<img src="https://mintcdn.com/insaion/dkLh615XOmGRTVSX/assets/monitoring/gauge.png?fit=max&auto=format&n=dkLh615XOmGRTVSX&q=85&s=17c726b9726242570ceb01ad302a73f7" alt="Gauge panel screenshot" width="2420" height="722" data-path="assets/monitoring/gauge.png" />

***

## Stat

What it shows

* A large single numeric value, optionally with a small sparkline showing a recent mini-trend. Useful for dashboards that need to display many KPIs compactly.

When to use it

* Show totals, averages, counts, or the latest reading for a metric when space is limited.

Interactions and info available

* Optional sparkline to hint at the short-term trend.
* Click or configure to change how the value is aggregated (latest, average, sum, etc.).

<img src="https://mintcdn.com/insaion/dkLh615XOmGRTVSX/assets/monitoring/stat.png?fit=max&auto=format&n=dkLh615XOmGRTVSX&q=85&s=475415889ff0fbdb36effbad011fd565" alt="Stat panel screenshot" width="2420" height="722" data-path="assets/monitoring/stat.png" />

***

## Image

What it shows

* An image pulled from a query (for example, a camera snapshot or an image stored as a metric). The panel shows the latest image for the selected time range.

When to use it

* Visual inspection tasks, camera feeds, or showing pictures associated with events.

Interactions and info available

* Configure which query supplies the image and the time range used to select the snapshot.
* If no image appears, verify the query is complete in the panel configuration.

<img src="https://mintcdn.com/insaion/6G7kMJ9f-czk-eIb/assets/monitoring/image.png?fit=max&auto=format&n=6G7kMJ9f-czk-eIb&q=85&s=0fdc7601f7183724ca6e46853e2f0fbe" alt="Image panel screenshot" width="2410" height="760" data-path="assets/monitoring/image.png" />

***

## Host Map

What it shows

* A hexagonal (or grid) map of hosts/devices colored by a metric's value. Each tile represents a device or cluster, helping you spot hot/cold areas quickly.

When to use it

* Quickly identify groups of devices that are above or below thresholds (for example, many devices with high CPU or low battery in the same region).

Interactions and info available

* Hover tiles to see the device name and current value.
* Optional labels and cluster names can be toggled in the panel settings.
* Tile size and legend visibility are configurable.

<img src="https://mintcdn.com/insaion/dkLh615XOmGRTVSX/assets/monitoring/hostmap.png?fit=max&auto=format&n=dkLh615XOmGRTVSX&q=85&s=f467d97e32b5d7bb51055854ee006e48" alt="Host map panel screenshot" width="2420" height="722" data-path="assets/monitoring/hostmap.png" />

***

## Map

What it shows

* Geographic or coordinate maps plotting positions from metrics (latitude/longitude) and optional labels. It can also render paths for moving devices.

When to use it

* Visualize locations and movement traces of devices, assets, or vehicles.

Interactions and info available

* Add at least two queries (latitude and longitude); an optional third query can provide labels.
* Pan, zoom, and inspect individual points. Paths can be rendered in the latest or full-mode depending on configuration.

<img src="https://mintcdn.com/insaion/6G7kMJ9f-czk-eIb/assets/monitoring/map.png?fit=max&auto=format&n=6G7kMJ9f-czk-eIb&q=85&s=309035666cc53c1d38ab530226168121" alt="Map panel screenshot" width="2410" height="814" data-path="assets/monitoring/map.png" />

***

## 3D Scene

What it shows

* A 3D visualization of points, paths, or simple scenes derived from up to three numeric series (commonly X/Y/Z coordinates).

When to use it

* Explore spatial data when a flat map is not enough—for example, altitude-aware paths or simple 3D position traces.

Interactions and info available

* Rotate, pan, and zoom the scene to inspect trajectories and points.
* Display a latest marker to highlight the most recent position.

<img src="https://mintcdn.com/insaion/SPQ_dqrgyz5M8w_s/assets/monitoring/3d.png?fit=max&auto=format&n=SPQ_dqrgyz5M8w_s&q=85&s=27a625ca7e761b0d83462f182d36b617" alt="3D scene panel screenshot" width="823" height="318" data-path="assets/monitoring/3d.png" />

***

## Tips for choosing the right visualization

* Use Timeseries for trends and multi-series comparison.
* Use Gauge or Stat for single high-priority KPIs that should be visible at a glance.
* Use Map or Host Map for spatial information and clustering.
* Use Logs when you need to inspect textual events instead of numeric metrics.

If you're unsure, start with a Timeseries or Stat panel and adjust to Gauge or Map once you know which single value or spatial relationship you need to highlight.

***

<div className="insaion-footer" role="contentinfo">
  <div className="insaion-footer__card">
    <div className="insaion-footer__content">
      <span className="insaion-footer__icon" aria-hidden="true">
        <svg viewBox="0 0 24 24" width="20" height="20" aria-hidden="true" focusable="false" className="insaion-footer__svg" role="img">
          <path fill="currentColor" d="M21 6.5A3.5 3.5 0 0 0 17.5 3h-11A3.5 3.5 0 0 0 3 6.5v5A3.5 3.5 0 0 0 6.5 15H8v3l3-3h6.5A3.5 3.5 0 0 0 21 11.5v-5zM7 8.5a1 1 0 1 1 0 2 1 1 0 0 1 0-2zm4 0a1 1 0 1 1 0 2 1 1 0 0 1 0-2zm4 0a1 1 0 1 1 0 2 1 1 0 0 1 0-2z" />
        </svg>
      </span>

      <div>
        If something's unclear or you hit a blocker, contact us on

        <a href="https://discord.gg/ZJMPfMmu3S" target="_blank" rel="noopener">
          Discord
        </a>

        or <a href="mailto:contact@insaion.com">[contact@insaion.com](mailto:contact@insaion.com)</a>
      </div>
    </div>
  </div>
</div>
