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

# Usage Tracking

> Track agent, user, and connection usage to measure automation impact and find new opportunities.

## Introduction

Track how your team uses Duvo to identify opportunities, measure impact, and ensure you're getting maximum value from automation.

***

## Tracking Agent Performance

### Viewing Run History

For any agent, you can see its complete run history:

<Steps>
  <Step title="Open the agent">
    Open the agent you want to review.
  </Step>

  <Step title="Find the run history">
    Look for the run history or past runs section.
  </Step>

  <Step title="Review executions">
    See all executions with their status and timing.
  </Step>
</Steps>

### What to Look For

**Successful patterns:**

* Consistent completion times
* High success rates
* Regular scheduled execution

**Warning signs:**

* Frequent failures or interruptions
* Increasing run times
* Gaps in scheduled runs

***

## Tracking by User

### Understanding User Activity

Team Insights shows activity broken down by user, helping you understand:

* Who is actively using automation
* Which users might need additional support
* Where to focus adoption efforts

### Identifying Champions

Users with high activity levels can be:

* Resources for helping other team members
* Sources of feedback for improvements
* Advocates for expanding automation

### Supporting New Users

Users with low activity might benefit from:

* Simpler agents to start with
* Clear documentation of available automation
* Direct walkthroughs of relevant agents

***

## Tracking Connection Usage

### Which Connections Are Used Most

Understanding which connections your agents use helps you:

* Prioritize maintaining critical connections
* Identify opportunities for new connections
* Ensure tokens and logins stay current

### Connection Health

Monitor that connected connections are working:

* Check that scheduled agents complete successfully
* Watch for authentication errors in run logs
* Refresh logins before they expire

***

## Setting Up Effective Tracking

### Naming Conventions

Use clear, consistent naming for agents:

* **Good:** "Weekly Sales Report - Regional Managers"
* **Poor:** "Report v2 final"

Good names make it easier to track and analyze usage.

### Organizing by Purpose

Group related agents mentally or through naming:

* Finance agents
* Customer service automation
* Internal operations

This helps you track usage by business function.

***

## Measuring Automation Impact

### Time Savings

Estimate time saved by comparing:

* How long the task took manually
* How often the agent runs
* Total time saved = (manual time × frequency)

### Error Reduction

Automation can reduce errors:

* Track issues before and after automation
* Note consistency improvements
* Document quality gains

### Speed Improvements

Measure faster turnaround:

* Time from trigger to completion
* Response times for automated processes
* Customer or stakeholder wait times

***

## Reporting on Automation

### For Your Team

Share regular updates on:

* Number of agents in use
* Runs completed this period
* New automation added
* Success stories and wins

### For Leadership

Highlight business impact:

* Time and cost savings
* Error reduction
* Process improvements
* Employee satisfaction with automation

***

## Things to Know

* Regular review of usage helps optimize your automation
* Low-usage agents might need improvement or retirement
* High-usage agents deserve careful maintenance
* Usage patterns can reveal new automation opportunities