Skip to content

Panel Overview

grafana-react provides components for all core Grafana panel types.

All panels share these common props:

PropTypeDescription
titlestringPanel title
descriptionstringPanel description
widthnumberGrid width (1-24)
heightnumberGrid height
xnumberX position (0-23)
ynumberY position
repeatstringVariable to repeat panel for
repeatDirection’v’ | ‘h’Repeat direction

Essential visualization types for most use cases:

  • Stat - Single value with optional sparkline
  • Timeseries - Line/bar charts over time
  • Table - Tabular data display
  • BarGauge - Progress bar visualization
  • Gauge - Circular gauge
  • Heatmap - Distribution visualization
  • Text - Markdown/HTML content

Additional chart types:

  • BarChart - Categorical bar charts
  • PieChart - Pie/donut charts
  • Histogram - Distribution histograms
  • StateTimeline - State changes over time
  • StatusHistory - Status grid over time
  • Candlestick - Financial OHLC charts
  • Trend - Sparkline trends
  • XYChart - Scatter/bubble charts

Specialized data views:

  • Logs - Log message display
  • Datagrid - Editable data grid

Advanced visualizations:

  • NodeGraph - Network/relationship graphs
  • Traces - Distributed tracing
  • FlameGraph - Profiling visualization
  • Canvas - Custom layouts
  • Geomap - Geographic maps

Dashboard widgets:

  • DashboardList - Dashboard navigation
  • AlertList - Alert status display
  • AnnotationsList - Annotation list
  • News - RSS/Atom feeds

Panels are positioned on a 24-column grid. Width and height are in grid units:

<Row title="Metrics">
{/* Full width */}
<Timeseries title="CPU" width={24} height={8}>
...
</Timeseries>
{/* Half width, side by side */}
<Stat title="Metric 1" width={12} height={4}>
...
</Stat>
<Stat title="Metric 2" width={12} height={4}>
...
</Stat>
{/* Three columns */}
<Stat title="A" width={8}>
...
</Stat>
<Stat title="B" width={8}>
...
</Stat>
<Stat title="C" width={8}>
...
</Stat>
</Row>

If width/height aren’t specified, panels are auto-positioned within the row.