Debugging Overview

To debug a StreamBase application means to run the application in debug mode and use the StreamBase visual debugger to pause your running StreamBase application and step through its processing. See Running Compared to Debugging for a discussion of running versus debugging your applications.

The EventFlow debugger works in StreamBase Studio on EventFlow applications. While your application is running, you can stop on breakpoints, see the path currently being taken through your EventFlow diagram, and see the current tuple contents in the Variables view.


If an EventFlow module references an EventFlow module that is not in the same project (for example, a different project or a binary dependency), you must add the EventFlow fragment as a Maven dependency to your project before launching. Failure to do this can result in a "module not found" error message when attempting to run or debug the module.

For more information, see Module Search Path.

When using the debugger, start by launching your application in debug mode, as described in the next section.

Debugging an Application with Default Configuration

StreamBase Studio provides a default launch configuration for running applications in debug mode. This lets you debug right away without stopping to configure a launch configuration.

To run an application on the local StreamBase Server using the default debug configuration, first make sure that your application is active in the Editor view, and is saved and free of typecheck errors. Then use any of these methods:

  • Click the Debug button () on the toolbar.

  • Press F11.

  • Alt+Shift+D, B. That is, press and hold the Alt, Shift, and D keys at the same time. Release them, and immediately press the B key.

  • Select Run>Debug As>StreamBase Application from the top-level menu. (This option only appears in the Run menu if the currently selected Editor view is an EventFlow Editor.)

  • Right-click in the canvas of your application in the Editor view, and select Debug As>StreamBase Application from the context menu.

  • Right-click the name of your top-level application's EventFlow file in the Project Explorer view, and select Debug As>StreamBase Application from the context menu.

  • Click the down-arrow next to the toolbar's Debug button, and select Debug As>StreamBase Application from the menu.

Debugging an Application with a Custom Configuration

Use the Debug Configurations dialog to edit, name, and save a debug configuration. See Editing EventFlow Run Configurations.

To debug an application with a custom configuration, invoke the configuration's name in one of the following ways:

  • Open the Debug Configurations dialog as described in Open a Run Configuration Dialog. Select the name of the launch configuration in the contents pane on the left, then click the Debug button.

  • Select Run>Debug History>your-config-name from the top-level menu.

  • Click the down-arrow next to the toolbar's Debug button, and select your configuration's name from the menu.

Debugging Topics

The following topics provide the details of debugging StreamBase applications.

Back to Top ^