Creating a Board
This guide walks you through creating a custom dashboard with widgets.
Step 1: Create a Board
- Click Boards in the sidebar
- Click Create Board
- Enter a name and optional description
- Click Create
You'll be taken to the board editor.
Step 2: Add a Widget
Click Add Widget to open the widget creation wizard. It has three steps:
Source — Choose Your Data
Pick a preset query or write custom SQL.
Presets are ready-made queries for common use cases:
- Messages by Role
- Events by Type
- Logs by Severity
- Messages over Time
- Events over Time
- Audit by Action
- Token Usage
Each preset includes a suggested chart type and field mapping.
Custom SQL lets you write any query against the available tables: logs, metrics, traces, events, messages, audit. The SQL editor provides live preview of results.
Chart — Choose a Visualization
Select the chart type:
- Bar — Vertical bar chart for comparing categories
- Line — Line chart for trends over time
- Area — Filled area chart for volume trends
- Donut — Ring chart for proportions
- Stat — Single large number for key metrics
- Table — Raw data table
Configure — Map Fields
- Title — Display name for the widget
- X-axis field — The column to use for the horizontal axis
- Y-axis field — The column to use for the vertical axis
- Color field (optional) — A column to group and color-code the data
Click Add to place the widget on the board.
Step 3: Arrange the Board
Widgets are displayed in a grid layout. In the editor view, you can:
- Edit a widget — Change its SQL, chart type, or field mapping
- Delete a widget — Remove it from the board
- Reorder — Drag and drop widgets to rearrange
Click Done when you're finished editing.
Advanced: Custom Vega-Lite
For complex visualizations beyond the built-in chart types, you can provide a full Vega-Lite specification. Select the Custom chart type and write a complete vegaLiteSpec JSON object.
TIP
Start with a preset query and modify the SQL to learn the available table schemas. Presets are a great starting point for building custom queries.
Next Steps
- Learn SQL querying for writing advanced queries
- Explore Insights for built-in panels alongside your boards