What is Generate Exception Log?
The Generate Exception Log feature allows you to retrieve detailed information about failed records during bulk job processing in DataMasker. It automatically collects all exceptions, identifies unique errors, and provides them in an easily accessible format.
When to Use This Feature
Use Generate Exception Log when:
- A bulk masking job has completed with errors
- You need to identify why specific records failed
- You want to analyze error patterns across multiple execution logs
- You need to export error details for offline analysis
How to Generate Exception Logs
Prerequisites
- The execution must be complete (Status: “Errored” or “Completed”)
- No other exception process should be running
Steps
Navigate to Execution Details
- Go to the Execution Detailed Record
- Locate the “Generate Exception Logs” button (only visible after execution completes)
Choose Log Scope All Logs Tab
- Processes all execution logs that have errors in a single batch
- Automatically includes every object/entity with failed records
- Best for comprehensive error analysis across the entire execution
Specific Logs Tab
- Displays individual objects/entities that encountered errors
- Shows each object with its error details:
- Execution Log: Object name and type (e.g., “Contact (Contact)”)
- Status: Current status (Errored/Completed)
- Records (Errored): Count of failed records for that specific object
- Allows selective processing of specific objects
- Ideal when you want to focus on particular objects or troubleshoot incrementally
Configure File Generation
Option A: Without File Attachments
- Leave “Attach Exception detail files to the Execution Logs?” unchecked
- Click Run
- Result: Exception details appear in the ExecutionLog.ExceptionLog field only
Option B: With File Attachments
- Check “Attach Exception detail files to the Execution Logs?”
- Select Exception/Error Type:
- Generate Files with unique errors – Creates CSV with deduplicated errors
- Generate Files with all errors – Creates CSV with complete error list
- Click Run
- After clicking Run, an Apex batch job (
DM_ExceptionLogBatch) is created - Navigate to Setup → Apex Jobs to monitor progress
- The job will show:
- Job Type: Batch Apex
- Status: Processing → Completed
- Total Batches: Number of batches to process
- Batches Processed: Current progress
- Failures: Any failed batches (should be 0)
- Wait for the status to show “Completed”
Review Results
- Once the Apex job completes, return to your execution logs
- Exception details populate in the ExecutionLog.ExceptionLog field
- CSV files (if selected) appear in the File related list
- Check the Exception Batch Status for completion
Exception/Error Type Options
Generate Files with Unique Errors
- Creates CSV files containing only unique error messages
- Eliminates duplicate errors for easier analysis
- Ideal for identifying distinct configuration issues
- If no unique errors can be generated, displays: “Unique Errors cannot be generated for Entity Log: [Entity Name]”
Generate Files with All Errors
- Creates CSV files with complete error data
- Includes all occurrences of each error
- Useful for understanding error frequency and patterns
- Provides comprehensive error tracking
Note: Files will get generated only when there is a bulk job is getting created.
File Size Management
- Default file size limit: 3MB
- Maximum configurable limit: 11MB