Error Handling Event Streaming

Last modified by Erik Bakker on 2024/02/21 22:42

Note that the functionality mentioned in this microlearning will become obsolete when migrating to the 3rd generation runtime.

In this microlearning, we will learn how error handling works for event processors. In a later module, we will learn more about event processors and we will learn how to configure them. In this microlearning, the focus will remain on error handling and not on flow configuration.

Should you have any questions, please contact academy@emagiz.com.

1. Prerequisites

  • Intermediate knowledge of the eMagiz platform

2. Key concepts

This microlearning centers on error handling for Event Streaming.

  • The key aspects are:
    • The producer and consumer are responsible for handling the error correctly
    • eMagiz will only log exceptions that occur within an event processor
    • You can use the log to determine what went wrong where and when
    • When eMagiz only provides the topic no additional logging functionality is available in eMagiz

3. Event Streaming

In this microlearning, we will learn how error handling works for event processors. In a later module, we will learn more about event processors and we will learn how to configure them. In this microlearning, the focus will remain on error handling and not on flow configuration.

  • The key aspects are:
    • The producer and consumer are responsible for handling the error correctly
    • eMagiz will only log exceptions that occur within an event processor
    • You can use the log to determine what went wrong where and when
    • When eMagiz only provides the topic no additional logging functionality is available in eMagiz

As we learned in previous microlearnings on the subject of Event Streaming the idea behind it is that producers and consumers can act completely independently of one another. They do not have to be aware of each other. Facilitating Event Streaming in eMagiz can be done in two ways:

  • eMagiz will only be the broker providing the topics
  • eMagiz will process data between topics via an Event Processor

In the first case, the producer and consumer will be solely responsible for error handling in case something goes wrong. This is in line with the philosophy of Event Streaming. In case eMagiz is used to process data between topics the data will pass through an eMagiz flow. Within this flow, things can go wrong. In case they go wrong an exception is written to the log of eMagiz. You can find these exceptions in the Manage phase of eMagiz under Monitoring -> Log entries. Here you can filter on the Event Streaming runtime, on level error, and message (Error while processing). This will provide you with a list of errors on the Event Streaming level.

intermediate-understanding-error-handling-in-emagiz-event-streaming--error-list-manage.png

Each of these errors corresponds with a failed attempt to process a certain message. Keep an eye out for this logging to prevent data loss. If an error persists you should start thinking about finding out and subsequently solving the underlying problem.

4. Key takeaways

  • The key aspects are:
    • The producer and consumer are responsible for handling the error correctly
    • eMagiz will only log exceptions that occur within an event processor
    • You can use the log to determine what went wrong where and when
    • When eMagiz only provides the topic no additional logging functionality is available in eMagiz

5. Suggested Additional Readings

If you are interested in this topic please read the help text eMagiz provides you.