Unknown macro: {next_previous_link3}
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

Message Tracing is used to trace, track and visualize a message's body in each intermediate stage of its transmission. This is useful for a number of reasons, including auditing and debugging. You use the Activity Dashboard of WSO2 BAM to trace messages going through WSO2 ESB. It allows you to track and trace messages in real-time within Cassandra, without having to write Hive scripts.

Message tracing for the ESB

Follow the steps below to use WSO2 BAM to trace messages going through WSO2 ESB.

  • This sample uses WSO2 ESB 4.8.0.
  • The Message Tracing toolbox comes with BAM by default. You can view this by going to BAM Toolboxes -> List menu in the management console

Installing the Message Tracer feature

  1. Download and set up WSO2 ESB.
  2. Log in to ESB management console and select Features under the Configure menu.
  3. In the Repository Management tab click Add Repository.
  4. Enter a name for the new repository and its URL as http://product-dist.wso2.com/p2/carbon/releases/turing/, and click Add.
    add new repository
  5. Go to the Available Features tab and select the newly added repository from the Repository drop-down list. Under Filter by feature name field, enter BAM Message Tracer Handler Aggregate, select Show only the latest versions checkbox, and deselect Group features by category checkbox. 
  6. Click Find Features.
  7. Select BAM Message Tracer Handler Aggregate feature 4.2.2 version from the available features list and click Install. 
    select the feature from the repository
  8. Click Finish to complete the installation and click Shutdown/Restart on the left navigation menu to restart the server.

Configuring message tracing

  1. On the Configure menu of ESB Management Console, click Message Tracing and then click Message Tracing Configuration.

  2. Select all the checkboxes as illustrated below and enter the Receiver URL (in the hostname:port format), Username and Password that is used by BAM. The default value for both the username and password will be admin.

    Enter the thrift port value that is obtained when running the start-up script of BAM, which can be found in the SSH log, for the Receiver URL.

  3. Click Update to save the settings.

Publishing data to WSO2 BAM

  1. After message tracing is configured, invoke a deployed service on WSO2 ESB (for example: echo service) for data publishing.
  2. Log in to BAM management console to check whether data is being published to BAM. 
  3. On the Tools menu, click Cassandra Explorer and then click Explore Cluster.
  4. Enter the default values as localhost:9160, admin and admin respectively for Connection URL, Username and Password and click Connect.
  5. In Keyspaces, check for the published contents in the BAM_MESSAGE_TRACE column family, which is located in the EVENT_KS keyspace.

  6. As soon as data is published and available, on the Main menu select Activity Dashboard to track and trace messages.
  7. In the Connect to Cluster window, enter the same details as entered in step 11 above and click Login.
  8. In the Search Activities window, enter the query details related to your search and click Search. For example:

  9. You view the resulting activities of the search query you entered in the previous step as below:

The message tracing functionality of WSO2 BAM can be used for any Carbon based product. Also it can be used to to track and trace messages that are transmitted from one product to another in a sequential manner.

  • No labels
Unknown macro: {next_previous_links2}