Jobs

Monitor background tasks like product enrichment, document ingestion, and exports in real-time.

How to track job progress and troubleshoot issues.

What are Jobs?

Jobs are background tasks that process data asynchronously. Long-running operations like document ingestion, batch enrichment, and exports run as jobs so you can continue working while they process.

Jobs provide:

Real-time progress tracking
Error reporting and logs
The ability to cancel running jobs
Historical job records

Job Types

MerchantOps uses several types of background jobs:

Type	Description	Triggered By
`document_ingestion`	Processing uploaded documents (PDF, Excel, CSV)	Document uploads
`enrichment`	AI-powered product enrichment	Single or batch enrich actions
`crawl`	Web scraping brand websites	Technology crawl actions

Viewing Jobs

To view your jobs:

Navigate to Jobs in the sidebar
View the list of all jobs
Click any job to see details

Jobs List Columns

Column	Description
Job	Job type and ID
Status	Current job status
Progress	Progress bar and percentage
Items	Processed / Total items
Started	When the job began
Duration	Time elapsed or total time

Filtering Jobs

Filter the jobs list by:

Type: Document ingestion, enrichment, crawl, export
Status: All, pending, in_progress, completed, failed
User: The email of the user that submitted the job.
Date Range: Jobs within a specific time period

Job Statuses

Each job has one of these statuses:

Status	Description	Indicator
`pending`	Job is queued but hasn't started	Gray
`in_progress`	Job is actively processing	Blue (animated)
`completed`	Job finished successfully	Green
`partial_success`	Job completed with some failures	Yellow
`failed`	Job encountered a critical error	Red
`cancelled`	Job was manually cancelled	Gray

Job Detail Page

Click on any job to see detailed information:

Detail Sections

Overview: Job type, status, timing, and progress
Progress: Real-time progress bar and statistics
Items: List of items being processed
Errors: Any errors or failures encountered

Progress Statistics

Jobs display various statistics:

Total Items: Number of items to process
Processed: Successfully completed items
Failed: Items that encountered errors
Progress %: Overall completion percentage
Success Rate: Percentage of successful items
Estimated Time: Remaining time estimate (when available)

Real-Time Monitoring

Job progress updates automatically in real-time. You don't need to refresh the page to see updates.

Progress Indicators

Progress Bar: Visual representation of completion
Item Counter:"45 of 100 items processed"
Time Elapsed: How long the job has been running
Processing Rate: Items per minute (for longer jobs)

Tip: You can navigate away from the Jobs page while a job is running. The job will continue processing in the background.

Cancelling Jobs

To cancel a running job:

Open the job detail page
Click "Cancel Job"
Confirm the cancellation

Note:Cancelling a job stops processing of remaining items. Items already processed are kept. The job status changes to "cancelled".

Troubleshooting Failed Jobs

When a job fails or has errors:

Check Error Details

Open the failed job
Error message appear after theMetadata section
Review the error messages

Common Issues

Issue	Possible Cause	Solution
Enrichment failures	Product URL not accessible	Verify and update product URLs
Document parsing errors	Unsupported file format or corrupted file	Try re-uploading or converting format
Rate limit errors	Too many requests to external sites	Wait and retry, or reduce batch size
Timeout errors	Processing took too long	Split into smaller batches

Retrying Failed Items

For jobs with partial failures, resubmit them.

Job History

MerchantOps maintains a complete history of all jobs. You can:

View completed jobs from any time period
Filter by type, status, or date range
Analyze job performance over time

Best Practices

Job Management

Monitor large jobs: Check progress periodically for batch operations
Review failures promptly: Address failed items before they accumulate
Use appropriate batch sizes: Balance speed with reliability

Performance

Split very large batches: Jobs with 10+ items may benefit from being split
Check job queue: Be aware of pending jobs before starting new ones