Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Services that do not have a SOAP interface (such as scheduler or timer services) can not be tested as described in Running a Test. Having imported a Bridge service repository file into the xUML Analyzer (as described in Importing the Service Description) you can trace such service calls asynchronously.
If you e.g. imported the service repository file that is created when compiling the timer example delivered with the Bridge, the Trace Analyzer displays the following:
Otp | ||
---|---|---|
|
Rp |
---|
If you want to know more on the information displayed in the Overview window, refer to Contents of the Asynchronous Part in Managing Service Descriptions With the Trace Analyzer.
For more information on timers refer to Timer Service.
Changing the Asynchronous Trace Settings
You can change the asynchronous tracing settings for the service operation selected in the Overview window.
The asynchronous trace settings window consists of three parts:
- the service location
- the effective trace settings
- the list of collected trace information
The Service Location
Image Modified | Concerning the service location, you can switch between the location the service was originally deployed to or a custom location. |
Image Modified | Select Custom Location and enter the URL to the custom service location. This can be used, e.g. if the very same service has been deployed to multiple Bridges.
|
Image Modified | Select |
Bridge, enter protocol, name and port of the Bridge the service is running on and provide valid credentials. |
|
|
The authentication must be of a valid Bridge user.
|
|
Refer to Group Roles for more information on Bridge roles and to Secure Bridge Setup for more information on securing your Bridge. | |
Image Modified | Click Delete All Traces to remove all of the collected tracing information from the specified service location. You will be prompted for confirmation. |
The Trace Settings
Image Modified | Change the trace settings for the displayed operation. |
Image Modified | Choose between three trace levels:
|
| |
Image Modified | Click Inspection List to select activities you want to inspect. Tracing information will be collected for the selected activities only. |
Click Enable Trace / Apply to apply any change of settings.
The Status messages displays that the tracing status of the service operation is yet unknown.
Image Modified
Click Read to read the actual tracing status of this service operation.
If no tracing is activated on the service operation, you can activate tracing by clicking Enable Trace / Apply.
Image Modified
The
xUML Runtime starts collecting tracing information on service calls.
Image Modified
By clicking Disable Trace or selecting Deactivate in the context menu tracing can be deactivated.
Viewing Available Traces
Click Show Available Traces to reload the list of traces that are available on the specified Bridge.
Image Modified | New traces are marked in bold. |
Image Modified | Select Get Trace from the context menu or click the Get Trace button to download the tracing information from the Bridge. |
The Analyzer displays the downloaded trace in the content pane and switches to the UML tab to let you browse through the execution path of the service call.
Image Modified
Additionally, you can inspect the request.log and the response.log of the service call.
Sorting and Filtering Available Traces
Having downloaded multiple traces (see Viewing Available Traces above), the list may be very long. You can sort table columns, and filter the table to reduce the amount of displayed traces.
To sort the list of traces, click the column header of the column you want to sort by.
The first click will sort the column data ascending.
The second click will sort descending.
The third click resets the column data to the original order.
To sort on multiple columns, press Ctrl and hold while clicking on another column. A number is displayed in the header to indicate the sort rank of the selected column.
Image Modified
To filter the traces, hover your mouse over the table heading, and click the filter icon.
Image Modified
From the filter menu, you can select
- all to display all traces and remove previously added filters
- Custom to specify a custom filter
- a list of values from the table to display traces having the corresponding value
Once a filter has been applied, this is indicated by the filter icon (Image Modified) in the table header.
Image Modified | To apply a custom filter, you can select from a list of conditions, and - for some filters - add a value. |
Image Added |
Searching Available Traces
Additionally, you can search the tree of the downloaded traces using the Find field at the bottom:
Image Modified
The tree expands and displays the first item that has been found. Additionally, this item gets displayed in the execution path of the trace. For more information about the UML diagram in the content pane, refer to Browsing through the Execution Path of the Service.
You can use the arrow keys (
Image Added and
Image Added) to search for further instances of the search term.