Tutorials

Delve into End-to-End Monitoring user journeys through step-by-step tutorials.

Generic User Journey

As a part of the user journey, we have two actors who play the following roles:

Challenge

Jim reviews many business transactions in a day. These transactions move across the various IBM webMethods applications. Reviewing the transactions helps Jim identify areas of improvement and any errors. In this scenario, XYSsales uses both IBM webMethods API Gateway and IBM webMethods Integration. Jim can view the details of the transactions within the individual systems. For example, on an API execution, he can view its details using the logs in IBM webMethods API Gateway. In the same manner, when an integration is run, he can view its details using the logs in IBM webMethods Integration. However, if an API calls an integration in IBM webMethods Integration, the log information does not tell Jim which integration in IBM webMethods Integration corresponds to which API execution in IBM webMethods API Gateway.

To summarize, Jim is unable to correlate the information when a business transaction traverses through multiple systems. He is unable to view the end to end details of a business transaction. We are helping Jim solve this problem by introducing End-to-End Monitoring.

Hayley sends a request to create a user account using a client application. This triggers a business transaction. Jim wants to view the complete flow of this business transaction. He wants to know the details from the time Hayley sent the request to the time she received the response.

Prerequisites

As part of the prerequisites, Jim performs the following actions:

Basic Flow

When Hayley sends a request to create a user account in XYSsales using the client application, following events take place:

  1. The client application calls the REST API APItoCreateAccountinXYSsales. The system applies all the policies defined for this API at this stage of the transaction.

  2. After successful authentication of Hayley’s account credentials with IBM webMethods API Gateway, the API invokes the integration CreateAccountinXYSsales, which is the REST endpoint.

  3. The integration is run and it creates the user account for Hayley in XYSsales. On successful creation of the account, the system sends a confirmation message as a response to Hayley through the client application.

  4. Jim can view the details of the API execution through the Analytics tab of the IBM webMethods API Gateway cloud instance:

  5. Jim can also view the details of the integration using the Monitor tab of the IBM webMethods Integration instance:

Monitoring transactions

  1. Jim logs into IBM webMethods Integration.

  2. He selects End-to-End Monitoring from the App Switcher:

  3. Jim opens the Dashboard of IBM webMethods End-to-End Monitoring to view all the transaction groups. By default, the duration selected for view is last half an hour from the current system time. Jim can see the following details:

  4. He selects the group XYSsales which lists all the transactions associated with his enterprise.

  5. He selects the transaction which he wants to view.

  6. On the Business Transaction Details page, he can view all the information for that business transaction:

  7. On the Business Transaction Details page, he can get more details for each component of the transaction by selecting the component on the Business flow map. When he selects the component, the details are shown in a new pane. For example, Jim selects the Integration Cloud component and he can view the details as shown in the following image.

    This completes the user journey for Jim.

Environment Groups and Stages

As part of this user journey, we have two actors who play the following roles:

Existing Setup

Challenge

John reviews numerous business transactions in a day. These transactions move across various environments, stages, and IBM applications. When a transactions fails, John has difficulty in finding out which specific product caused the failure. John also needs to find out the root cause of slow transactions.

Use Case 1

Tenant WMIO Flow B2B Channel API Gateway
XYSsalesFinanceDev ComputeXYLogisticAccountCount XYSsalesChannel, Sender:XYSsales InvokeXYSsalesInfo

Root Cause

  1. John logs into his IBM webMethods iPaaS tenant XYSsalesFinanceDev. It lists all the products that he currently uses for his business needs.

  2. John selects IBM webMethods Integration, and then the Monitor tab to view all transactions specific to IBM webMethods Integration.

  3. He selects End-to-End Monitoring using the app switcher.

  4. John selects Administrator on his user profile link and ensures that the environment group listing is setup right, to view his transaction.

  5. He selects a time range to cover the time window of Emma’s transaction.

  6. John now makes Environment group and Stages in View selections on the masthead filters to simplify locating his transaction.

  7. John is able to locate the transaction he is looking for within the All Transactions group.

  8. Selecting the transaction allows him to view the full flow of the business flow map, and also shows him the finer details of time delay and the reason for any failure, if any.

  9. For further details, John clicks on the More details link of that product and traverses to that product’s monitoring page.

Use Case 2

This use case is an exact replica of use case 1, with the only exception that this is deployed in the production environment. Hence, John will be executing the same set of steps listed above with the following exceptions:

Tenant WMIO Flow B2B Channel API Gateway
XYSsalesFinanceProd ComputeXYLogisticAccountCount XYSsalesChannel, Sender:XYSsales InvokeXYSsalesInfo

Root Cause

  1. This time, John logs into his IBM webMethods iPaaS tenant XYSsalesFinanceProd.

  2. He verifies the environment group listing and selects the time range just as in use case 1.

  3. His masthead filter selections will now be Finance and Production.

  4. He now easily locates his production transaction and looks into more details.

Use Case 3

This use case is deployed for John’s logistics department. In order to calculate some expenses, they receive data from the finance department. In this new environment, they call a REST API from XYSsalesFinanceDev and then processes it in a workflow to calculate some expenses for the logistics department.

Tenant Finance WMIO REST API Called WMIO workflow Logistics WMIO workflow
XYSsalesLogisticDev GetConsumedCouponDetails ConsumedCouponDetails ComputeConsumtionOnGivenDates

Root Cause

  1. John logs into his IBM webMethods iPaaS tenant XYSsalesLogisticDev.

  2. He verifies the environment group listing and selects the time range just as in use cases 1 and 2.

  3. His masthead filter selections will now be Logistics and Development.

  4. He locates the logistics transaction and looks into more details.

Hybrid Monitoring

As part of this user journey, we have two actors who play the following roles:

Existing Setup

Challenge

John reviews numerous business transactions in a day. These transactions move across many IBM cloud solutions and webMethods Integration Server. When a transaction fails at Integration Server, Emma has difficulty in analysing the failure as there is no solution that tracks transactions between cloud and on-premises products.

Use Case

Tenant WMIO Flow B2B Channel API Gateway Integration Server
XYSsalesSCM XYSSCMComputetaionsAndProductDeliveryManagement XYSsalesChannel, Sender:XYSsales InvokeXYSsalesInfo XYSDeliveryManagementServices

Root Cause

  1. John logs into his IBM webMethods iPaaS tenant XYSsalesSCM. It lists all the products that he currently uses for his business needs.

  2. John now selects IBM webMethods Integration, and selects the Monitor tab to view all transactions specific to IBM webMethods Integration.

  3. He selects End-to-End Monitoring using the app switcher.

  4. He selects a time range to cover the time window of Emma’s transaction.

  5. John is now able to locate the transaction he is looking for within the All Transactions group.

  6. Selecting the transaction allows him to view the full flow of the business flow map, and also shows him the finer details of time delay and the reason for the failure, if any.

    Note
    The tool tip on each node provides him more details.
  7. If failure of the transaction is in the on-premises Integration Server node, John can expand the node and analyse the individual services for failures and delays.

  8. For an in-depth analysis, John checks the End-to-End Monitoring Hybrid Integration log files in the on-premises webMethods Integration Server file system:

    <Install-Dir>/IntegrationServer/instances/default/logs