Skip to main content

​
Steps

1

Create a new dashboard

Create a new dashboard or folder form
  1. Navigate to the Dashboards section in the main navigation
  2. Click the Create new dashboard button in the top right corner
  3. A “Create a new dashboard or folder” popup will appear
  4. Fill in the dashboard details:
    • Name: Enter a descriptive name (e.g., “LLM Observability”)
    • Description: Describe the dashboard’s purpose (e.g., “Dashboard to view telemetry from LLM apps and AI Agents”)
    • Tags: Add relevant tags for organization and searchability
    • Type: Select Dashboard (Dashboard with widgets)
  5. Click the Add button to create your dashboard
  6. You’ll be taken to the empty dashboard canvas ready for widgets
2

Add your first widget

Empty dashboard canvas with a Create Your First Widget button
  1. Click Create Your First Widget button on the empty dashboard
  2. You’ll see a “Select a Widget” popup with two options:
Select a Widget popup showing existing pre-built widgets
  • Choose from existing widgets: Select from pre-built widgets like “Avg temperature”, “Avg utilization percentage”, “Requests per time”, etc.
  • Create new widget: Click + Create New Widget to build a custom widget
Create New Widget option in the Select a Widget popup
3

Configure widget

When creating a new widget, you’ll see a configuration panel with three tabs: General Tab
Widget configuration panel General tab
  1. Widget Title: Enter a descriptive name (e.g., “Total Requests”)
  2. Widget Type: Select from Stat Card in this example
  3. Description: Add context about what the widget shows
  4. Value Path: Specify which field from your query to display (e.g., 0.count() in this example)
  5. Prefix: Add symbols before the value (e.g., $ for costs)
  6. Suffix: Add units after the value (e.g., % for percentages)
Query Tab
Widget configuration panel Query tab with a SQL editor
  1. Write your SQL query against the ClickHouse database. For example:
  2. Test your query by clicking Run Query
  3. Verify the results - you’ll see output like: {"count()": 622}
4

Save your widget

  1. Click Save Changes to add the widget to your dashboard
  2. The widget will appear on your dashboard canvas
  3. You can immediately see your data visualization
Dashboard canvas showing the newly created widget
5

Your dashboard is ready!

  • Add more widgets: Click Create Widget to add additional visualizations
  • Resize widgets: Drag the corners of any widget to adjust its size
  • Move widgets: Drag widgets to rearrange their positions on the dashboard