Temporal

High batcher processor errors indicate batch processing failures

warning
performanceUpdated Mar 3, 2026

The Batcher system collects items into batches and processes them through a single-threaded processing function. Errors during batch processing indicate failures in the batch function execution, which can lead to unprocessed items and system degradation.

Technologies:
How to detect:

temporal_server_batcher_processor_errors increasing, especially when temporal_server_batcher_processor_requested is also high, indicating a high failure rate in batch processing operations

Recommended action:

1. Calculate error rate by comparing temporal_server_batcher_processor_errors to temporal_server_batcher_processor_requested. 2. Review logs for the specific batch processing function (fn parameter) that is failing. 3. Check if batch sizes (MaxItems) are too large causing processing timeouts. 4. Verify the batch processing function can handle the volume within the configured delays (MinDelay, MaxDelay). 5. Consider reducing batch size or increasing processing timeouts if the function is timing out. 6. Investigate if specific item types in batches are causing failures.