Skip to content
SiteQwality SiteQwality Docs

Dashboards quickstart

By the end of this guide you’ll have a dashboard called Service health with two widgets — a metrics timeseries and a live log stream — both sharing a 1-hour global time range that auto-refreshes every minute.

1. Create the dashboard

Section titled “1. Create the dashboard”

  1. Dashboards → New dashboard.

  2. Name: Service health. Description: Live ops view. Global time range: Last 1 hour. Auto-refresh: 60s. Save.

2. Add a metrics widget

Section titled “2. Add a metrics widget”

  1. Add widget → Timeseries.

  2. Title: Request latency p99. Data source: metrics. Metric: http.request.duration_ms. Aggregation: p99. Group by: endpoint. Save.

3. Add a log stream widget

Section titled “3. Add a log stream widget”

  1. Add widget → Log stream.

  2. Title: Errors. Data source: logs. Filter level = error. Save.

4. Reorder widgets

Section titled “4. Reorder widgets”

Drag widgets around in the editor; the layout updates live. Or batch-update positions:

Terminal window
curl -X PUT https://api.siteqwality.com/dashboard/$DASHBOARD_ID/layout \
  -H "Authorization: Bearer $SITEQWALITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "widgets": [
      { "widget_id": "<id-1>", "x": 0, "y": 0, "w": 12, "h": 4 },
      { "widget_id": "<id-2>", "x": 0, "y": 4, "w": 12, "h": 4 }
    ]
  }'

This is the cheapest update path when you’re rearranging multiple widgets at once.

What’s next

Section titled “What’s next”
Widget reference All widget types with config shapes.
Metrics The most common widget data source.
Logs For log_stream widgets.