Troubleshooting and diagnostics


When an error message occurs informing you that real-time event processing is currently overloaded and may stop processing your events, this means that the microservice for Apama is either not running or not keeping up with the rate of updates occurring.

If there has been a recent large burst of updates (such as new measurements, especially when a number of large bulk measurement requests are sent), then this can trigger the alarm. If custom EPL applications are generating a large number of outputs or not processing events quickly, this can also lead to the alarm.

When the alarm is raised, older updates will be discarded. This may affect the behavior of Smart Rules, Analytics Builder models or EPL applications.

There are two ways to get the logs of the Apama microservice:

Contact Software AG Support if needed.

Downloading diagnostics and logs

If a user has READ permission for “CEP management”, then two links for downloading diagnostics information are available in both the Apama EPL Apps and Apama Analytics Builder web applications: one for downloading basic diagnostics information (the Diagnostics link) and another one for downloading enhanced (more resource-intensive) diagnostics information (the Enhanced link). These links are shown at the bottom of the web application’s starting page (that is, in the EPL application manager and in the model manager).

It may be useful to capture this diagnostics information when experiencing problems, or for debugging EPL applications. It is also useful to provide to support if you are filing a support ticket.

You can see a version number in the EPL application manager and in the model manager. It is shown next to the above links.

Basic diagnostics information is provided in a ZIP file named diagnostic-overview<timestamp>.zip and includes the following information (this should be typically a few Megabytes, and be generated in about 5 seconds):

Enhanced diagnostics information is provided in a ZIP file named diagnostic-enhanced<timestamp>.zip and includes the following information:

What a user can see or do depends on the permissions:

Diagnostics REST endpoints

The following diagnostics endpoints are available for REST requests. These require authentication as a user with READ permission for “CEP management”: