> ## Documentation Index
> Fetch the complete documentation index at: https://docs.owlintegrations.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dashboard Overview

> Monitor your Duck mesh network with real-time message feeds, analytics, and device status

The Dashboard is your central hub for monitoring the OWL DMS network. It provides real-time visibility into message traffic, device activity, and network health.

## Summary Cards

At the top of the dashboard, three cards display key metrics:

<CardGroup cols={3}>
  <Card title="Papa Ducks" icon="tower-broadcast">
    Shows the number of Papa Duck gateways connected to your account
  </Card>

  <Card title="Mama Ducks" icon="satellite-dish">
    Displays the total count of Mama Duck devices across all Papa Ducks
  </Card>

  <Card title="Messages (24h)" icon="message">
    Shows the message count received in the last 24 hours, updates every minute
  </Card>
</CardGroup>

## Message Chart

The interactive chart visualizes message traffic over the last 14 days:

<Steps>
  <Step title="Toggle Chart Type">
    Click the chart icon to switch between bar and line charts
  </Step>

  <Step title="View Options">
    Toggle between total messages and per-device breakdown using the grid icon
  </Step>

  <Step title="Interactive Tooltips">
    Hover over any data point to see:

    * Date and day of week
    * Total message count
    * Breakdown by device (with color-coded indicators)
  </Step>
</Steps>

<Info>
  The chart always displays the last 14 days of data, independent of the message table filters.
</Info>

## Recent Messages Table

The table shows your most recent messages with powerful filtering options:

### Time Window Selection

Filter messages by selecting a time range:

* Last 30 minutes
* Last hour
* Today
* Yesterday
* Last 7 days (default)
* Last 30 days
* Month to date
* Last month

<Warning>
  The table displays a maximum of 1,000 messages to ensure optimal performance.
</Warning>

### Table Features

| Feature        | Description                                              |
| -------------- | -------------------------------------------------------- |
| **Papa Name**  | Click to view Papa Duck details                          |
| **Mama Name**  | Color-coded by device with clickable link to device page |
| **Topic**      | Event type (GPS, Health, Status, Sensor, etc.)           |
| **Date**       | Message timestamp in `YYYY-MM-DD HH:mm:ss` format        |
| **Message ID** | Unique identifier for each message                       |
| **Payload**    | Message content (hover for full text)                    |
| **Hops**       | Number of mesh network hops                              |
| **Actions**    | Eye icon to view Mama Duck details                       |

### Sorting and Filtering

<Steps>
  <Step title="Sort Columns">
    Click column headers to sort. Hold Shift to sort by multiple columns.
  </Step>

  <Step title="Filter Data">
    Use the filter icon in column headers to filter by:

    * Mama Name (text search)
    * Topic (text search)
    * Date (date picker)
  </Step>

  <Step title="Reset View">
    Click the refresh icon to clear all sorting and filters
  </Step>
</Steps>

## Real-Time Updates

The dashboard automatically updates with live data:

<Accordion title="WebSocket Connection">
  Messages are streamed in real-time via WebSocket. New messages appear with a highlight animation and automatically scroll into view. The connection status is monitored and will reconnect automatically if interrupted.
</Accordion>

<Accordion title="Automatic Refresh">
  * **Message count**: Updates every 30 seconds
  * **Message table**: Refreshes every 60 seconds
  * **Chart data**: Updates every 5 minutes
</Accordion>

## Tips

<Tip>
  **New message indicator**: Newly arrived messages appear with a green highlight animation that fades after 3 seconds.
</Tip>

<Tip>
  **Quick device access**: Click on device names in the table to navigate directly to their detail pages.
</Tip>

<Tip>
  **Performance**: If you have a large number of messages, use the time window filter to narrow the data range for faster loading.
</Tip>