Panel Overview
grafana-react provides components for all core Grafana panel types.
Common Props
Section titled “Common Props”All panels share these common props:
| Prop | Type | Description |
|---|---|---|
title | string | Panel title |
description | string | Panel description |
width | number | Grid width (1-24) |
height | number | Grid height |
x | number | X position (0-23) |
y | number | Y position |
repeat | string | Variable to repeat panel for |
repeatDirection | ’v’ | ‘h’ | Repeat direction |
Panel Categories
Section titled “Panel Categories”Core Panels
Section titled “Core Panels”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
Chart Panels
Section titled “Chart Panels”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
Data Display
Section titled “Data Display”Specialized data views:
- Logs - Log message display
- Datagrid - Editable data grid
Specialized
Section titled “Specialized”Advanced visualizations:
- NodeGraph - Network/relationship graphs
- Traces - Distributed tracing
- FlameGraph - Profiling visualization
- Canvas - Custom layouts
- Geomap - Geographic maps
Widgets
Section titled “Widgets”Dashboard widgets:
- DashboardList - Dashboard navigation
- AlertList - Alert status display
- AnnotationsList - Annotation list
- News - RSS/Atom feeds
Grid Layout
Section titled “Grid Layout”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.