This page introduces the Debugging Applications section of the Test/Debug Guide. Use the links in the Contents section to see the other topics in this section.
To debug a StreamBase application means to run the application in debug mode and use a StreamBase 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.
StreamBase provides two debugging environments:
-
The Visual debugger works in StreamBase Studio on EventFlow applications, and shows you the path currently being taken in your EventFlow diagram, and shows the current tuple contents in the Variables view.
-
The legacy command-line debugger runs in a terminal window or StreamBase Command Prompt, and can debug both EventFlow and StreamSQL applications.
When using either debugger, you start by launching your application in debug mode, as described in the next section.
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 your application is currently 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.
-
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 → → from the top-level menu.
-
Right-click in the canvas of your application in the Editor view, and select → from the pop-up menu.
-
Right-click the name of your application's
.sbappor.ssqlfile in the Package Explorer view, and select → from the pop-up menu. -
Click the down-arrow next to the toolbar's button, and select → from the menu.
The following topics provide the details of debugging StreamBase applications.
-
See Using the Visual Debugger to learn about using the visual debugging features of StreamBase Studio.
-
See Saving Debug Configurations to learn about creating and saving non-default debug configurations for debugging your StreamBase applications.
-
See Editing Launch Configurations to learn how to use the Run/Debug Configuration Wizards to specify launch configurations for debugging applications.
-
See Tutorial for the Command-Line Debugger (Deprecated) to learn how to use the legacy command-line debugger, sbdb.