Skip to content
Tutorials Center
My learning

Topics

Lesson 15 of 37 ยท Panels and Visualizations

Panel Basics: The Editor, Options and Inspect

Learn how Grafana panels work: the panel editor layout, the Query, Transform and Alert tabs, standard options, repeat options, library panels, panel links and the Inspect drawer.

A panel is the basic building block of a dashboard: one visualization fed by one or more queries. Whatever the visualization type, every panel shares the same editor, the same standard options and the same debugging tools. Learning those once pays off for every chart you build later.

Anatomy of the panel editor

When you edit a panel (hover and press e, or use the panel menu > Edit), you see three areas:

  1. Preview at the top with a visualization picker and a table-view toggle.
  2. Query area below with tabs: Queries, Transformations and Alert (create an alert rule from this query).
  3. Options pane on the right: panel title, description, visualization-specific options, and Standard options, Thresholds, Value mappings, Data links and Overrides.

Press Back to dashboard when done, then save the dashboard. Edits are not stored until you save.

Panel title, description and transparency

  • Title: short and specific ("Checkout p95 latency"), and add the unit when it is not obvious.
  • Description: appears as an info icon with hover text; use it to document the query's meaning, for example "Excludes health checks".
  • Transparent background: removes the panel's card background; useful for text or stat-heavy layouts.

Panel links appear in the panel header and send users to another dashboard or URL, carrying variables and the time range (${__url_time_range}, var-host=${host}). Data links (under Options) attach to values: clicking a point opens a link built from that point's labels, for instance a log search for the clicked service.

Standard options

These apply to most visualizations:

Option Purpose
Unit Formats numbers: bytes, percent, seconds, requests/sec, currency, etc.
Min / Max Fixes the scale (essential for gauges)
Decimals Number of digits
Display name Replaces the series name; supports ${__field.labels.host}
Color scheme How series or values are colored
No value Text shown when there is no data

Setting the right unit is the single most useful habit: with unit bytes (IEC) a value of 1048576 shows as 1 MiB, and with seconds (s) 3661 shows as 1.02 hour.

Repeating panels

Under Repeat options you can repeat a panel for every value of a multi-value variable (one panel per host) in a chosen direction. This is covered further in the variables lesson of the dashboards chapter.

Library panels

A library panel is stored once and reused in many dashboards; changing it updates them all. Use them for standard panels, such as a company-wide "Error rate" definition. In the panel menu choose More > New library panel.

The Inspect drawer

Press i over a panel or choose Inspect from its menu. Tabs:

  • Data: the results as a table, with options like Formatted data, Apply transformations and Download CSV.
  • Stats: query time, number of rows returned, processing time.
  • JSON: the panel JSON, the DataFrame JSON (what the data source returned) and Panel data.
  • Query: the actual request/response sent to the data source, which is how you debug "why is the graph empty".
  • Error: the details if a query failed.

Stand-in: formatting values with units

The unit option changes display, not the stored value. This stand-in implements a few common formatters so you can see how 1048576 can become "1 MiB" and why the same number needs different units.

JS Stand-in: unit formatting

Press Run (or Ctrl + Enter) to see the console output here.

No output.

Stand-in: no value and display names

Display name templates use field labels. This stand-in applies ${__field.labels.host} style substitution and the "No value" text.

JS Stand-in: display name templates

Press Run (or Ctrl + Enter) to see the console output here.

No output.

Good panel habits

  • One panel, one question. If the title needs "and", consider two panels.
  • Always set unit and axis labels; always give meaningful legends.
  • Use consistent colors for the same thing across dashboards (errors red, success green).
  • Keep descriptions short but precise.
  • Prefer Inspect > Query over guessing when data looks wrong.

Check your understanding

Quick check ยท 4 questions

of 4 answered You scored / 4 ยท perfect!

  1. 1. Which Inspect tab shows the actual request sent to the data source?

    The Query tab shows request and response, ideal for debugging empty panels.
  2. 2. What is a library panel?

    Editing a library panel updates every dashboard that uses it.
  3. 3. Which option formats a raw number as MiB or minutes?

    Units change how values are displayed and scaled; the data stays the same.
  4. 4. How do you open Inspect quickly while hovering a panel?

    i opens Inspect, e opens the panel editor.

Summary

  • The panel editor has Queries, Transformations and Alert tabs plus an options pane.
  • Standard options (unit, min/max, decimals, display name, colors) work almost everywhere.
  • Panel links and data links connect dashboards.
  • Library panels share definitions; repeat options multiply panels per variable value.
  • Inspect shows data, stats, JSON and the real query.

Next: The Time Series Panel