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

# Task Monitoring

> Track and analyze task execution

## Overview

Task monitoring in Pulze provides visibility into how your automated workflows are performing. Track execution history, identify issues, and ensure tasks are running as expected.

## Monitoring Dashboard

### Task List View

The main Tasks page shows key monitoring information:

* **Status Indicators** - Visual status for each task (Active, Paused, Completed, Deleted)
* **Next Run Time** - When each task will execute next
* **Creator Information** - Who created the task
* **Space Association** - Which space the task runs in

### Status Display

Tasks are displayed with color-coded status badges:

* **Active** - Green/success badge - Task is running as scheduled
* **Paused** - Blue/info badge - Task exists but won't run
* **Completed** - Success badge - One-time task that finished
* **Deleted** - Warning/error badge - Task removed, shown temporarily

## Task Details

Click on any task to access comprehensive details:

### Basic Information

* Task name and description
* Creation date and creator
* Associated space
* Current status
* Schedule configuration

### Execution History

* List of past runs
* Execution timestamps
* Success/failure status
* Generated conversation links
* Error messages (if any)

### Next Execution

* Scheduled run time
* Timezone display
* Time until next execution
* Schedule pattern summary

## Execution History

### Viewing Past Runs

Access execution history to see:

* **When** - Exact timestamp of each execution
* **Result** - Success or failure status
* **Output** - Link to generated conversation
* **Duration** - How long the task took to complete
* **Errors** - Any error messages or issues

### Analyzing Results

For each execution, you can:

* View the generated conversation
* See the assistant's response
* Check for errors or issues
* Compare results across runs
* Identify patterns or trends

## Task Conversations

### Accessing Output

Task executions create conversations in the associated space:

* Each run generates a new conversation
* Conversations are tagged with the task name
* Results are stored permanently
* Can be viewed, shared, and referenced

### Finding Task Conversations

Navigate to task conversations:

1. Click on the task
2. View execution history
3. Click on any execution
4. Opens the generated conversation
5. See full AI assistant response

## Performance Tracking

### Success Rate

Monitor task reliability:

* Track successful vs. failed executions
* Identify tasks with issues
* Review error patterns
* Take corrective action

### Execution Trends

Analyze patterns over time:

* Frequency of executions
* Success rates
* Common failure points
* Performance consistency

## Real-Time Monitoring

### Active Task Status

See current task states:

* Tasks currently running
* Recently completed executions
* Upcoming scheduled runs
* Tasks awaiting next execution

### Notifications

Stay informed about task execution:

* Execution start notifications (if configured)
* Completion notifications
* Failure alerts
* Status change updates

## Troubleshooting

### Failed Executions

When a task fails:

1. Check execution history for error messages
2. Review the conversation (if created)
3. Verify space and assistant configuration
4. Check assistant capabilities and tools
5. Review input/prompt configuration

### Common Issues

**Task Not Executing:**

* Status is set to "Paused"
* Next run time is in the past
* Space or assistant was deleted
* Subscription expired

**Unexpected Output:**

* Prompt needs refinement
* Assistant configuration changed
* Data sources unavailable
* Tool access issues

**Inconsistent Results:**

* Prompt ambiguity
* Non-deterministic assistant behavior
* External data source changes
* Time-sensitive content

## Filtering and Search

### Filter Tasks

Focus on specific subsets:

* **By Status** - Active, Paused, Completed, Deleted
* **By Schedule Type** - One-time, Daily, Weekly, Monthly, Custom
* **By Space** - Tasks in specific spaces
* **By Creator** - Tasks created by specific members

### Search

Find tasks quickly:

* Search by task name
* Search by description
* Search by creator name
* Real-time results

## Metrics and Analytics

### Key Metrics

Track important statistics:

* **Total Tasks** - Number of configured tasks
* **Active Tasks** - Tasks currently scheduled
* **Execution Count** - Total runs across all tasks
* **Success Rate** - Percentage of successful executions
* **Failed Runs** - Number of failures requiring attention

### Usage Patterns

Understand task utilization:

* Most frequently running tasks
* Tasks consuming most resources
* Peak execution times
* Space-level task distribution

## Best Practices

<Tip>
  **Regular Reviews**: Check task execution history weekly to catch issues early.
</Tip>

<Tip>
  **Monitor Success Rates**: Track which tasks are reliable and which need attention.
</Tip>

<Tip>
  **Review Failures**: Investigate failed executions promptly to prevent recurring issues.
</Tip>

<Tip>
  **Clean Up**: Remove or pause tasks that are no longer needed to reduce clutter.
</Tip>

<Tip>
  **Test Changes**: After modifying a task, monitor the next few executions closely.
</Tip>

## Alerts and Notifications

### Failure Alerts

Be notified when tasks fail:

* Email notifications (if configured)
* In-app notifications
* Details about the failure
* Quick links to troubleshoot

### Success Confirmations

Track successful executions:

* Confirmation of task completion
* Link to generated output
* Execution timestamp
* Next scheduled run

## Task Health Indicators

### Healthy Tasks

Indicators of well-functioning tasks:

* ✓ Consistent successful executions
* ✓ Regular schedule adherence
* ✓ Expected outputs
* ✓ No error patterns

### Tasks Needing Attention

Warning signs:

* ⚠ Repeated failures
* ⚠ Inconsistent results
* ⚠ Long execution times
* ⚠ Error messages
* ⚠ Status stuck in "running"

## Reporting

### Generate Reports

Create reports on task performance:

* Export execution history
* Analyze success rates
* Review resource usage
* Track trends over time

### Data Export

Export task data for analysis:

* CSV export of task list
* Execution history data
* Performance metrics
* Failure logs

## Integration with Conversations

### Conversation Tagging

Task-generated conversations are:

* Automatically tagged with task name
* Linked in execution history
* Searchable in conversation list
* Filterable by task origin

### Viewing Context

Access full context:

* See complete conversation
* Review assistant responses
* Check data sources used
* Analyze reasoning

## Maintenance

### Routine Checks

Regularly review:

* Task execution history
* Success/failure rates
* Schedule accuracy
* Resource usage

### Cleanup

Keep tasks organized:

* Delete completed one-time tasks
* Remove unused tasks
* Pause tasks no longer needed
* Archive old execution history

### Updates

Maintain task health:

* Update prompts as needed
* Adjust schedules based on usage
* Refresh assistant configurations
* Review and update data sources

## Troubleshooting Guide

### Task Shows as "Active" but Not Running

1. Check next run time - should be in the future
2. Verify timezone settings
3. Confirm space and assistant exist
4. Check organization subscription status
5. Review execution history for patterns

### Task Runs but Produces No Output

1. Check if conversation was created
2. Review assistant configuration
3. Verify prompt is valid
4. Check data source availability
5. Review assistant tool permissions

### Task Executions Take Too Long

1. Review assistant configuration
2. Check data source size and complexity
3. Simplify prompt if possible
4. Consider splitting into multiple tasks
5. Review tool usage in execution

## Performance Optimization

<Tip>
  **Optimize Prompts**: Clear, specific prompts reduce execution time and improve reliability.
</Tip>

<Tip>
  **Schedule Smartly**: Distribute task execution times to avoid resource contention.
</Tip>

<Tip>
  **Monitor Resources**: Track which tasks consume most credits and optimize accordingly.
</Tip>

## Next Steps

Once monitoring is set up:

1. Review tasks weekly
2. Address failures promptly
3. Optimize based on patterns
4. Scale successful workflows
5. Iterate and improve

<CardGroup cols={2}>
  <Card title="Tasks Overview" icon="clock" href="/pulze/tasks/overview">
    Back to Tasks Overview
  </Card>

  <Card title="Scheduling" icon="calendar" href="/pulze/tasks/scheduling">
    Configure task schedules
  </Card>
</CardGroup>