# Admin Overview

## Introduction

This section covers administrative tools and troubleshooting capabilities for workspace admins who need to debug issues, monitor activity, and maintain Duvo deployments.

***

## Admin Capabilities Overview

### Job Debugging

When assignments don't work as expected, administrators can investigate:

* View detailed execution logs
* See exactly what the assignment did
* Identify where issues occurred
* Understand error conditions

### User Support

Administrators can help team members by:

* Viewing user activity and assignments
* Diagnosing permission or access issues
* Assisting with configuration problems

### System Monitoring

Keep track of overall health:

* Monitor assignment success rates
* Identify problematic connections
* Track system-wide activity
* Spot trends and issues early

***

## When to Use Admin Tools

### Investigating Failed Jobs

When a team member reports an assignment isn't working:

1. Access the job debugger
2. Find the specific job that failed
3. Review the execution logs
4. Identify the point of failure
5. Determine the root cause

### Resolving User Issues

When team members need help:

1. Understand what they're trying to accomplish
2. Review their assignment configuration
3. Check connections
4. Verify permissions and access
5. Guide them to a solution

### Proactive Monitoring

Regular administrative tasks:

1. Review team activity and adoption
2. Check for recurring issues
3. Monitor connection health
4. Ensure logins are current
5. Plan for scaling and growth

***

## Access Requirements

Admin tools require appropriate permissions:

* **Owner or Admin** — Full access to team settings and debugging tools
* **Member or Clarity Member** — Access to their own job history only

Contact your team Owner or Admin if you need elevated access. See [Roles and Permissions](https://docs.duvo.ai/teams/roles-and-permissions) for a complete breakdown.

***

## Best Practices

### Document Issues

When troubleshooting:

* Record what you found
* Note the resolution
* Update documentation if needed
* Share learnings with the team

### Systematic Approach

Follow a consistent troubleshooting process:

1. Gather information about the issue
2. Reproduce if possible
3. Check the obvious things first
4. Use debugging tools for deeper investigation
5. Implement and verify the fix

### User Communication

Keep team members informed:

* Acknowledge their issue
* Provide updates on investigation
* Explain what you found
* Help them prevent future issues

***

## Related Topics

* [Run Debugger](https://docs.duvo.ai/admin-and-troubleshooting/run-debugger) - Debug assignment jobs in detail
* [Common Issues](https://docs.duvo.ai/admin-and-troubleshooting/common-issues) - Solutions to frequently encountered problems
* [Impersonation](https://docs.duvo.ai/admin-and-troubleshooting/impersonation) - Reviewing team member activity from their perspective