Skip to main content

Panels & visualizations

A panel is a single tile on a dashboard. Each panel contains modules — a search box, fields, and a data visualization — and is usually connected to a search that supplies its data.

How a panel gets its data

A panel's search can come from a few places:

Backing searchWhen to use
Inline searchQuick one-off panels; the SPL lives in the panel.
Saved reportReuse one saved search across panels/dashboards.
Base + post-processMany panels share one base search and slice it differently.

Whatever the source, the panel runs SPL and renders the result — so the search pipeline is what shapes it. A panel that shows "errors per host" is just:

index=web status>=500 | stats count by host

…with a visualization wrapped around it.

Choosing a visualization

The shape of your search results determines which visualizations make sense:

Result shapeGood visualizations
A single number (stats count)Single value, gauge
Values by one field (stats count by host)Bar / column, pie, table
A series over time (timechart)Line / area chart
Two dimensions (chart … over X by Y)Stacked column, heatmap
Geographic fieldsChoropleth / cluster map
Shape the data for the chart you want

A line chart needs a timechart; a bar chart needs a stats … by. If a visualization looks wrong, the fix is usually the report stage of the panel's search, not the chart settings.

Completed vs. real-time panels

Panels can display the results of completed searches (the common case — run on a schedule or on load) or real-time searches that update continuously. Real-time panels are powerful but expensive; prefer scheduled/completed searches unless you genuinely need live data.

Next: inputs & tokens — make the panels interactive.