jEAP Error Handling Service

The jEAP Error Handling Service (EHS) makes sure that no Kafka message is lost when its processing fails in a business application. It consumes MessageProcessingFailedEvents published by the jEAP messaging error handler, persists the failed messages, automatically retries temporary errors, escalates permanent errors to manual tasks, and provides a UI to inspect, resend and close errors — with optional grouping of related errors and Jira issue tracking.

This repository is published as a library: every business system creates and deploys its own EHS instance depending on it.

Documentation

• Getting Started — set up an EHS instance for your system
• Architecture — context, building blocks, error state model, data model
• Message Flows — sequence diagrams of the runtime behaviour
• MessageProcessingFailedEvent — the inbound event contract
• Configuration — the complete property reference
• User Interface — views, filters, roles and persisted view settings
• Error Groups — grouping of permanent errors and Jira integration
• Operations — dead letter topic, housekeeping, metrics, multi-cluster
• Customization — custom resending strategy, task factory and back-off
• Development — building, running and testing this repository

Versioning

This library is versioned using Semantic Versioning and all changes are documented in CHANGELOG.md following the format defined in Keep a Changelog.