Hello Integrators!

This is the third part of the blog on Basic Monitoring and Administration for the Integration Developer. The first and second one can be accessed here and here.

In this blog, we shall explore the logs available for the integration developer.


Part 3: Understanding the logs in HCI-PI


As an integration developer, you have access to the following two logs that can help you debug message processing and artifact deployment issues.

  1. Message monitoring log
  2. Tail log

Understanding the Message Monitoring Log

Let me take an example of a “failed” message to explain this log.


Consider the following integration flow. The Integration flow is triggered on a particular schedule, followed by a content modifier (where I have inserted text in the body of the payload); followed by a multicast message that sends the message to two different branches and to two different receivers. In the monitoring view, I get a failed message processing.

Sample_integration_flow.JPG

First step – click on the message and in the Properties View, you can view the message monitoring log.

Monitoring_Overview.png

It is a very detailed log and it can appear confusing at first. However, once you understand the structure of the log it becomes easier.

Tip: The default view includes leading spaces in the logs. If you choose to read in a more linear top-down fashion, you can remove the leading spaces. The option is provided in the menu.

menu_leading_spaced.JPG

The first block of the log contains an overview. If provides the overall status and also the time taken to complete the message processing.

Overview_Information.png

After the overview information block, each processing step is included. In our example, the first step is a scheduled timer start. So, the scheduler starts with the “Children” block.  A unique processing ID is created for the timer and you can see that it has successfully completed.

Timer_example.png

After the Timer step, it goes to the Content Modifier step. This is also executed correctly. However, the step after content modifier, the multicast step, shows an error. And the processing has failed for branch 1 of the multicast.

Multicast_error.png

On scrolling to the right and reading the complete line, it shows that the error is related to connecting to the SFTP server connected to this branch. That helps us in isolating the problem.

Multicast_error_sftp.png

Since it is a parallel multicast message, the second branch has executed successfully and it could send the message to the receiver.

Multicast_success_branch.png

The log also provides useful information on how much time each processing step has taken.

Time_taken_to_process.png

There you go; that is how you should interpret the message monitoring log. Let us move on to the next log.


Understanding the Tail Log

The tail log would be typically checked if you have an error in the deployment of the integration flow. Again, with an example – I am deploying an integration flow with the name SF_RCM_TO_SHL_Assessment

TailLog_Project.JPG

On deployment, I find that the component monitor shows an Error status.

TailLog_Component_Status.JPG

Go to the Tail Log view of the Worker Node and check for the detailed error.

  1. Navigate to the Tail Log view in the Integration Operations perspective.
  2. Enter a log size (100 KB would do checking the logs of a recent activity, else increase it and check)
  3. Tip: Enter the name of the integration flow in the search box and click on the next button.
  4. Check the reasons for the error.

TailLog_completeview.JPG.png

The error is interpreted as the system.jks file not been deployed to the tenant. So, the developer might have just forgotten to deploy the system.jks file, which contains the tenant certificates, to the tenant.

just FYI – In the previous example of the Message monitoring log, the log is also stored in the Tail log. But we need not come to the Tail log to interpret the error. It is easier in the Message monitoring log.

Spoiler [ 😉 ]: To debug this error, you need not go to the Tail logs view. You can obtain it from the Component Monitor view itself. In the context menu of the message, click on Show Error Details. It would provide the error details in the pop-up window. Never-the-less, this example is a good showcase on when to use the Tail Logs.

TailLog_Comp_error.JPG.png

Hope you have gained a perspective of how to use the monitoring and administration for your development requirements.

Let me know your feedback or suggestions on improving this blog.

Thanks !

Best Regards,

Sujit

Connected Blogs

Part 1: Overview of the Integration Operations feature in HCI-PI

Part 2: Checking the status of Integration Deployments in HCI-PI

To report this post you need to login first.

1 Comment

You must be Logged on to comment or reply to a post.

Leave a Reply