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

# Overview

> Monitor your voice AI system's overall activity with session counts, durations, and call distribution analytics

The Overview tab is your primary view for monitoring overall system activity. It displays real-time metrics and historical data based on your selected filters.

<img className="block dark:hidden" src="https://mintcdn.com/hamsa-452fa79a/faqA0g16HZbxfVQ3/images/agents/dashboard/overview/overview-1-light.jpg?fit=max&auto=format&n=faqA0g16HZbxfVQ3&q=85&s=b9f8786e69fa188026310022e4816fe1" alt="Dashboard Overview UI" width="3418" height="1844" data-path="images/agents/dashboard/overview/overview-1-light.jpg" />

<img className="hidden dark:block" src="https://mintcdn.com/hamsa-452fa79a/faqA0g16HZbxfVQ3/images/agents/dashboard/overview/overview-1-dark.jpg?fit=max&auto=format&n=faqA0g16HZbxfVQ3&q=85&s=db6ed78252611257f6bfce5719689e5c" alt="Dashboard Overview UI" width="3418" height="1844" data-path="images/agents/dashboard/overview/overview-1-dark.jpg" />

### Accessing the Overview

1. Navigate to **Dashboard** from the main navigation menu
2. The **Overview** tab opens by default
3. Use the filter controls at the top to refine your view:
   * **Agent Filter**: Select "All agents" or a specific voice agent
   * **Date Range**: Choose from preset ranges or custom dates

## Overall Information Metrics

The top section displays four primary metrics:

### Live Sessions

The number of concurrent active calls happening right now.

### Total Sessions

The total number of completed sessions within your selected date range.

### Average Session Duration

The mean duration of all sessions in your selected time range, displayed in minutes and seconds (e.g., "2m 34s").

<Warning>
  Very short average durations (under 30 seconds) may indicate call quality issues or premature disconnections. Check your call history to identify the cause.
</Warning>

### Total Session Duration

The cumulative time of all sessions combined, displayed in hours and minutes (e.g., "52h 18m").

## Additional Metrics

### Calls by Duration Bucket

Categorizes calls into three duration ranges:

* **Less than 30s**: Very short calls (quick queries or disconnections)
* **30-120s**: Medium-length calls (standard conversations)
* **More than 120s**: Long calls (complex issues or extended interactions)

Most calls should fall in the 30-120s range for typical use cases. A high number of calls under 30s may indicate connection issues or callers hanging up quickly.

### Average Words per AI Response

The average number of words the AI agent uses in each response.

As a reference:

* **\< 20 words**: Responses may be too brief to be helpful
* **20-60 words**: Typical for natural conversation
* **> 80 words**: May overwhelm callers — consider adjusting your prompt to encourage conciseness

### Forwarded to Human Agent

The percentage of calls that were escalated to a human agent.

As a reference:

* **\< 10%**: High AI containment
* **10% - 20%**: Acceptable for most use cases
* **> 20%**: Agent may need expanded knowledge base or capabilities

## Charts

<img className="block dark:hidden" src="https://mintcdn.com/hamsa-452fa79a/faqA0g16HZbxfVQ3/images/agents/dashboard/overview/overview-2-light.jpg?fit=max&auto=format&n=faqA0g16HZbxfVQ3&q=85&s=c71d4319e43e3994499ae1fcbdd73bad" alt="Dashboard Charts UI" width="3410" height="1842" data-path="images/agents/dashboard/overview/overview-2-light.jpg" />

<img className="hidden dark:block" src="https://mintcdn.com/hamsa-452fa79a/faqA0g16HZbxfVQ3/images/agents/dashboard/overview/overview-2-dark.jpg?fit=max&auto=format&n=faqA0g16HZbxfVQ3&q=85&s=d9dc510f476c5339d429df4d2cd90157" alt="Dashboard Charts UI" width="3418" height="1844" data-path="images/agents/dashboard/overview/overview-2-dark.jpg" />

### Calls by Duration Bucket (Pie Chart)

Visual distribution of calls across the three duration buckets. Hover over segments to see exact counts and percentages.

### Calls Over Time (Line Chart)

Call volume over time, with granularity based on your selected date range:

* **Today or Yesterday**: Hourly breakdown
* **This Week / This Month**: Daily breakdown
* **Custom range**: Automatically adjusts (hourly, daily, weekly, or monthly)

Use this chart to identify peak usage hours, spot volume trends, or measure the impact of changes you've made.

## Filtering

### Agent Filter

Filter all metrics and charts by a specific agent. Switch between agents to compare their metrics individually.

<Info>
  The agent filter is single-select. When "All agents" is selected, you see aggregated data across your entire system.
</Info>

### Date Range Filter

Choose from preset ranges or create custom date ranges:

* **Today**: Current day (midnight to now)
* **Yesterday**: Previous full day
* **This Week**: Sunday to today
* **This Month**: First day of month to today
* **Custom**: Select any start and end date

<Note>
  All times are displayed in your browser's local timezone.
</Note>

## Troubleshooting

### No Data Available

* Verify you have calls in the selected date range
* Try selecting "All agents" if a specific agent is filtered
* Expand your date range (e.g., from "Today" to "This Week")

### Metrics Show Zero

* Your selected date range may have no activity
* The filtered agent may have no calls in that period
* Wait a few seconds for data to finish loading

### Slow Loading

* Reduce the date range — large ranges process more data
* Filter by a specific agent instead of "All agents"
* Use preset date ranges rather than custom ranges spanning many months

## API Reference

<Card title="Get Overview Analytics" icon="code" href="/api-reference/endpoint/get-overview-analytics">
  Retrieve session counts, durations, and call volume trends.
</Card>

## Related

<CardGroup cols={2}>
  <Card title="Live Calls" icon="phone" href="/agents/dashboard/live-calls">
    Monitor active calls in real-time and join as a listener
  </Card>

  <Card title="Performance Metrics" icon="gauge" href="/agents/dashboard/performance">
    Analyze system performance and response times
  </Card>

  <Card title="Satisfaction" icon="heart" href="/agents/dashboard/satisfaction">
    Track customer satisfaction and sentiment analysis
  </Card>

  <Card title="Call History" icon="history" href="/agents/call-history/introduction">
    Search and review detailed call logs and transcripts
  </Card>
</CardGroup>
