Message mediation mode is one of the operational modes of the ESB profile where the ESB profile functions as an intermediate message router. When operating in this mode, it can filter, transform, drop or forward messages to an endpoint based on the given parameters. A unit of the mediation flow is a mediator. Sequences define the message mediation behavior of the ESB profile. A sequence is a series of mediators, where each mediator is a unit entity that can input a message, carry out a predefined processing task on the message, and output the message for further processing.
...
- Click Run in the top menu of the WSO2 EI Tooling Plugin, and then click Debug Configurations.
- Double click EI Mediation Debugger as shown below.
- Enter the details to create a new configuration as shown in the example below. You need to define two port numbers and a hostname to connect the ESB profile with the WSO2 EI Tooling Plugin in the mediation debug mode.
- Execute the following command commands to start WSO2 EI server in the debug mode by passing a system variable at start up:
- On Windows:
<EI_HOME>\bin\integrator.bat --run -Desb.debug=true - On Linux/Solaris:
sh <EI_HOME>/bin/integrator.
sh -Desb.debug=true
- On Windows:
Click Debug in the WSO2 EI Tooling Plugin when the Console indicates the following.
Note You have approximately a one-minute time span to connect the WSO2 EI Tooling Plugin with the EI server for the execution of the above created debug configuration. Otherwise, the EI server will stop listening and start without connecting with the debugger tool.
In the WSO2 EI Tooling Plugin, right click and add breakpoints or skip points on the desired mediators to start debugging as shown in the example below.
Info You can add the following debugging options on the mediators using the right click context menu.
- Toggle Breakpoint: Adds a breakpoint to the selected mediator
- Toggle Skip Point: Adds a skip point to the selected mediator
- Resend EI Debug Points: If you re-start the the ESB profile, or if you re-deploy the proxy service after changing its Synapse configuration, you need to re-send the information on breakpoints to the WSO2 EI server. This re-sends all registered debugging points to the EI Server.
- Delete All EI Debug Points: Deletes all registered debug points from the EI Server and the WSO2 EI Tooling Plugin
...
You need to put a debug point to the mediator, to view wire logs of it. When debugging is finished (or while debugging), right click on the mediator, and click Show WireLogs, to view wire logs for a specific mediator.
| Info |
|---|
You can only view wire logs for a whole proxy service, call mediator, send mediator, or other API resources. However, you cannot view a wire log of a Synapse config (e.g. sequences), because there would not be anything written to wire, when the flow comes to the sequence etc. Hence, you can only view them in wire entry points. |
Viewing wire logs while debugging
If you view wire logs while debugging, you view only the wire logs of mediators, whose execution is already completed as shown in the example below.
Viewing wire logs of a mediator after debugging execution of it
When you view wire logs of a mediator (e.g. send mediator) after debugging, you can view the request and response wire logs as shown in the example below.
Viewing wire logs of a proxy service after debugging
If you view wire logs of a proxy service after debugging finished, you view the request wire log and final response wire log of that proxy as shown in the example below.
