Starting the debugger

Starting the debugger opens the Debug Source page in the Monitor Model editor.

Before you begin

Before starting the debugger, you must have a Monitor test environment server running in your development and test environment on Integration Designer. The monitor model must have no errors in the Problems view.

You do not need to generate Java EE projects for the monitor model being debugged nor add the projects to the server.

About this task

To start the debugger, complete the following steps:

Procedure

In the Project Explorer view, right-click the monitor model that you want to debug.
Click Debug Monitor Model. (Alternatively, you can click Debug As > Monitor Model.)

Results

The Debug perspective opens. The Monitor Model editor is shown in the lower part of the screen open to the Debug Source tab. You can click the tabs at the bottom to switch to the other pages of the Monitor Model editor. The Integrated Test Client opens in a tab behind the Debug Source view so that you can send events.

The debugger uses the server selected in the preferences window (Windows > Preferences > Business Monitoring > Monitor Model Debugger), and starts the server if it is not already started.

To prevent the Debug perspective from opening by default when you launch the debugger on a monitor model, navigate to Windows > Preferences > Business Monitoring > Monitor Model Debugger, and clear the Always switch to the debug perspective after launching the debugger check box. After you clear the check box, the general preferences for perspective settings apply. For more control over when the perspective opens, navigate in the Preferences list to Run/Debug > Perspectives. On that page, you can choose to switch automatically to the associated perspective when an application launches or is suspended, or only when you answer Yes to a prompt.

On the Target Server tab of the Integrated Test Client, if Send directly to debugger is selected, events are sent directly (through the debugger's Representational State Transfer (REST) Services interface). If you select Send to CEI subscribers, including debugger, events are sent through the Common Event Infrastructure (CEI), just as they would be with a monitor model in a production environment. For more information about how events are sent, see Event flow.

What to do next

If you follow the previous steps, the debugger and the Integrated Test Client open with the monitor model that you have chosen.

Tip: You can also set the debug configuration manually by completing the following steps:

Right-click the monitor model that you want to debug, and click Debug As > Debug Configurations.
In the Debug configuration window, right-click Monitor Model in the list and click New to create a new debug configuration. Alternatively, select an existing configuration that you have used before.
To use the Integrated Test Client:
1. Right-click the monitor model in the Project Explorer view and click Launch Integrated Test Client
2. Click the Target Server tab located at the bottom of the Integrated Test Client page and make sure that the correct server is selected in the list.
  The information in the Server Configuration fields is entered automatically. You will never need to enter values in the other fields while you are debugging.

To keep the input queue of incoming events as well as any remaining monitoring context instances from the previous debugging session, clear the Clear data from previous debug sessions check box. If you clear this option, the input queue and any instances remain when a new debugging session is launched. By default, the input queue and instances are cleared when you launch a new session.

Select whether the current time value for the debugger should be based on the time value of the incoming events or on the time from the system clock. By default, the time is based on the creationTime attribute of the incoming events.

For more information on these configuration options, see "Configuring the debugger."