View other versions. Version 7.10 Version 8.0

Endpoint monitoring is not new functionality in BizTalk360. The earlier versions of BizTalk360 had the web endpoint monitoring capability to manage the external endpoints. You can access the articles related to the previous versions of Web endpoint monitoring by clicking the above buttons. You had the capability to set up monitoring on the web endpoints and validate the actual response code against the expected response code. In BizTalk360 version 8.1, the web endpoint monitoring functionality has been further improved (revamped) to include -

  • You can now add Payload and Custom HTTP Headers
  • You will be able to configure the alerts based on the response payload from web endpoints

The following sections show the different sections that are available to set up web endpoint monitoring in BizTalk360. Click the links below to navigate to the corresponding section - 


Basic details configuration

The basic details page is the first page that is displayed when you try to configure an endpoint monitor. Follow the steps as shown below to navigate to the basic details screen of web endpoint monitoring.

  1. Log in to the BizTalk360 application
  2. Click 'Monitoring' in the navigation panel
  3. Click the + button against 'Manage Mapping' tab and select 'BizTalk Environment'
  4. Select the Alarm name (see Creating an alarm) from the drop down for which you would like to associate the alerts
  5. In the list of system resources at the top, select Web Endpoints
  6. Click New Web Endpoint button to set up monitoring for the web endpoints
  7. A new blade will open where the user can enter basic details such as -
  8. Click Next to navigate to the the Optional details section


configuring web endpoints monitoring in biztalk360


Optional details configuration

In this section, we will take a detailed look at the optional settings that are available in the second screen that is displayed when configuring a new web endpoint monitor. All the details on this page are optional. You can choose to skip them if they are not required. You also need to remember that skipping the details in this section will start monitoring the endpoint based on the default selection ("Response Time Alerts") in the next screen. You can set up the response alert configuration (based on return code or keyword) accordingly.

  1. Authorization Credentials - Certain endpoints will require a valid user name and password (and potentially the domain name as well) in order to set up monitoring. For these cases, you can specify the authorization credentials information. Example: Lets say you have a virtual machine that has BizTalk360 installed. You can easily check if the machine is running or not by setting up an endpoint monitoring on the http://<virtual machine name>/BizTalk360 URL. You can also specify the domain name, user name, and password to directly monitor the above URL. If the response is successful, you will see the endpoint health status as Healthy. If the endpoint is unavailable, the endpoint health status will be shown as Error and you will see an exception message as follows "Accessing the Web Endpoint " Test VM " returned error. Cannot Validate Endpoint. Please verify internet connectivity".

    authorization details in web endpoints monitoring

  2. Proxy Settings - If your organization uses a proxy, you can enter the proxy settings that is required to access an endpoint URL. There are two ways in which you can use Proxy settings in BizTalk360. The proxy settings can be predefined in the Gateway Settings page under BizTalk360 Settings. If the proxy settings are defined under the Gateway Settings page, then you need not enter the details in this section. You can simply toggle the Use Gateway Proxy toggle bar to use the defined proxy settings. You can override the global gateway settings by entering the following information -
    • Server Name - the name of your proxy server
    • Port Number - the port number used to connect through your proxy
    • Proxy username - the username to connect to the proxy server
    • Proxy password - the password to authenticate the credentials to connect to the proxy server
      You need to remember that toggling the Use Gateway Proxy setting will override the values entered in the Proxy Settings fields.

      web endpoints monitoring proxy settings

  3. Payload - Payload section is used to configure the query string parameters of a GET request or content for a POST request. For example, let's assume you want to retrieve the list of send ports in a particular application "Contoso". You can use the BizTalk360 API (Services.REST/BizTalkApplicationService.svc/GetSendPorts) to retrieve this information. But this will not work without adding a few extra parameters like environment ID and application name. You can add these additional parameters required by the API in the Payload section and monitor this web endpoint. The payload section has the following options that users can choose to monitor their preferred endpoint.

    Request Methods - Users can choose between GET or POST. Depending on the selection, you will see the following options -


    • GET
      • HTTP Version - Choose the version of HTTP (HTTP/1.1 or HTTP/1.0)
      • Accept - The accepted content format such as application/json, application/xml, text/html, text/xml, application/javascript, text/plain
      • Get Parameters - The two fields (Key and Value) have to be passed along with the endpoint URL. For example, the environment ID, application name etc as mentioned above. Enter the values in the space provided. You can add multiple parameters by clicking the + button. Click the Delete icon to delete the parameter.

        web endpoints monitoring payload settings

    • POST
      • Add content length - Toggle the icon to add the content length to the endpoint URL
      • HTTP Version - Choose the version of HTTP (HTTP/1.1 or HTTP/1.0)
      • Accept - The accepted content format such as application/json, application/xml, text/html, text/xml, application/javascript, text/plain
      • Content-Type - The content type format such as application/json, application/xml, text/html, text/xml, application/javascript, text/plain
      • Payload - The payload to be added to the endpoint URL
  4. Custom Header - You can pass custom headers along with your endpoint URL. You need to pass the Custom Header Name and Custom Header Value for the custom headers. You can add multiple custom header values as required by clicking the button.

    creating custom header in web endpoints monitoring

Response alert configuration

In this section, we will take a detailed look at the different options that are available in the third screen that is displayed when configuring a new web endpoint monitor.

  1. Response Format - You need to select the type of response format that you will receive when the monitoring service tries to access the web endpoint. The different options available are - Plain Text, XML, and JSON
    Depending on the response format selection, the second option in the response alert configuration will change automatically. For Plain Text, you will notice Keyword Alerts, for XML, it will be _XPath Alerts, and for JSON, it will be _JSON path Alerts.

    response alert configuration in web endpoints monitoring

  2. Return Code Alerts - You can set up monitoring for the web endpoint and set up alerting based on the return code that is generated by the endpoint. You can define monitoring such as "Set up a monitor on http://www.microsoft.com/en.in and the status should be Healthy if the return code is 200. Otherwise, throw a warning/error and set the status appropriately." To achieve this, you need to define 3 parameters - 
    • Status Code - This is the return code that you expect from the endpoint if it is active
    • Expected Status - This expected status of the return code in the response alert. You can choose between Must be Present and Must be Absent
    • Else - This section will get triggered when the logic fails for the expected status value. For instance, if you set the expected status code (200) to "Must be Present", and the actual return code from the web endpoint is 404, then in this case the else section will get executed and the health status of the web endpoint will be displayed as Error or Warning depending on the value selected.

      return code alert status monitoring for web endpoints

  3. _JSON Path Alerts / _XPath Alerts - Similar to return code alerts, you can set up monitoring and set the alert configuration to the _JSON Path and _XPath Alerts. You need to define the following 3 parameters -
    • XPath / JSON Path - Enter the XPath/JSON Path in the space provided. You can find an example given in the text box. You need to enter the path in the specified format only. For example, in JSON Path, you can enter the JSON path as $.breakfast_menu.food[0].price and in XPath, you can enter the XPath as /breakfast_menu/food[1]/price
    • Expected value - Enter the expected value that the XPath/JSON Path will return. If the actual value returned is the same as the expected value, you will notice the endpoint health status to be Healthy. However, if the returned value is different from the expected value, the endpoint health status will be displayed as Error or Warning depending on the status defined in the else section.
    • Else - This section will get triggered when the logic fails for the expected value status. For instance, if you set the expected value of $.breakfast_menu.food[1].price (or) /breakfast_menu/food[1]/price to $7.95, and the actual value returned by the XPath or JSON path is $5.95, then the else section will get executed and the health status of the web endpoint will be displayed as Error or Warning depending on the value selected.

      xpath json path alerts in biztalk360 web endpoint monitoring

      response alert configuration for json xpath alerts

  4. Response Time Alerts - You can set up monitoring for the web endpoint based on the response time alert. You can specify the warning and error time by which the endpoint should send a response back. If the time exceeds the time, the endpoint will be shown in either the Warning or Error state. The default warning time is 2 seconds, and the error time is 7 seconds.
    The Response Time Alerts will be selected by default. Even if you do not choose the Return Code Alerts or _JSON Path alerts/XPath alerts, the web endpoint will be monitored against the response time alert values. In case you try to disable the response time alerts toggle bar, you will see an error message as "Please make sure at least one Alert section is enabled."

    response time alert configuration for web endpoints

Endpoint Summary

Depending on the endpoint configuration, you will see the current status of the endpoint monitor as either Error, Warning, or Healthy. In case, of the Warning or Error status, the Reason field will display the reason for the current status. Click the eye icon in the Summary column to view the endpoint summary information.

The Endpoint Summary will be displayed based on the priority order of the alerts. The Return Code Alerts takes the highest priority. If the return code alert is configured and in healthy state, the priority moves to the _XML Alerts / JSON Alerts section. If this section also is configured and in a healthy state, the priority moves to the third section (Response Time Alerts). If this section is also in the Healthy state, the final endpoint state will be in the Healthy state. However, if the endpoint state is in an Error state in any of the three sections, then the health status would automatically display the status of the endpoint as Error or Warning depending on the value selected. Also, if the endpoint status becomes Error or Warning in either the Return Code Alerts section or _JSON Path Alerts/_XPath Alerts section, the next section will display the Current State information as Not Validated. This means that the final section will not be considered by the monitoring service when triggering the response.

view web endpoints summary in biztalk360

biztalk360 web endpoints monitoring summary

In v8.5, we have enhanced the endpoint monitoring alerts to display the respective endpoint name in the Email alert to easily identify which endpoint has downtime in case of multiple endpoints configured for monitoring. The alerts will also include the Expected Return code and Response Time Alert details to give more insights to the users.