OpsRamp supports web application endpoint monitoring using the HTTP Endpoint Probe application. This permits monitoring of both HTTP and HTTPS URLs.

This document describes how to install the HTTP Endpoint Probe application on the clustered gateway.

Prerequisites

Get installation package and deployment instructions

The gateway cluster should be running and registration should be complete.

Gateway Core - Update Instructions:

Performed the following steps on each cluster node.

  1. Log in to the gateway command-line interface.

  2. Perform clean-up of the existing image:

        microk8s ctr i rm $(microk8s ctr i ls -q | grep message-sorter)
        
  3. Run the following commands on any node in the cluster. That node distributes the image to all other nodes in the cluster.

        helm chart pull us-docker.pkg.dev/gateway-images/gateway-cluster-charts/message-sorter:0.9.11
        helm chart export us-docker.pkg.dev/gateway-images/gateway-cluster-charts/message-sorter:0.9.11
        helm upgrade message-sorter message-sorter -f message-sorter/cluster.yaml --set imageChannel=stable
        

HTTP Endpoint Probe setup

Ensure that Adapter Integrations is enabled in the respective partner and client setup. This can be done from partner and client settings when you set up your account, as described in the following steps:

  1. Select Adapter Integrations:

    Image
  2. Choose ADDONS:

    Image
  3. After adapter integration is enabled, you can view the available integrations in Setup > Integrations > Integrations and click the Adapter tab:

    Image

Step 1: Install the integration

  1. From All Clients, select a client.

  2. Go to Setup > Integrations > Integrations.

  3. In Available Integrations, select Adapter > HTTP Endpoint Probe.

  4. In Install Integration, enter:

    ParameterDescription
    NameName of the integration.
    Upload Logo(optional) Logo for the integration.
    Gateway ProfileChoose a gateway management profile to associate with the client.
  5. Click Install. The Integration page displays the installed integration in the CONFIGURATION section.

Step 2: Configure the integration

  1. In the CONFIGURATION section, click + Add.

  2. Enter the following configuration parameters:

    ParameterDescription
    NameConfiguration name.
    Base URLEndpoint URL to be monitored.
    TimeoutTime interval to wait for a response from the configured URL, in milliseconds.
    Additional configurationA JSON data structure with additional configuration parameters:
    • Uripath = (optional) Additional path elements appended to the base URL.
    • ResContentShouldContain = (optional) String/pattern to match on in the response from the configured URL.
    • ResContentShouldNotContain = (optional) String/pattern that should not be present in the response from configured URL.
    • Method = GET HTTP method or POST HTTP method.
    • HttpHeaders = (optional) Additional headers that might be required for the URL.
    • HttpParams = (optional) Applicable for all request types.
    • PostData = (optional) Applicable for HTTP method types POST or PATCH.

    Sample payload:

        Additional Configuration:
        {
            "Method":"POST",
            "ResContentShouldContain":"",
            "ResContentShouldNotContain":"",
            "HttpHeaders":{"content-type":"application/json"},
            "HttpParams":{},
            "PostData":"{ \"name\": \"morpheus\", \"job\": \"zion resident\"}",
            "UrlPath":"api/users"}
        }
        
  3. In the Resource Types & Metrics section, select the metrics and configure them for availability and alert conditions.

  4. In the Discovery Schedule section, select Recurrence Pattern and add one of the following patterns:

    • Hourly
    • Daily
    • Weekly
    • Monthly
  5. In the Monitoring Schedule section, select the target device monitoring frequency. The default frequency is five minutes

  6. Click Save.

Supported metrics

Metric NameMetric Display NameUnits
endpoint_url_ResponseTime

Endpoint url response time.
Response Timemilliseconds
endpoint_url_ResponseLookUpTime

Duration from start until the DNS name is resolved.
Lookup Timemilliseconds
endpoint_url_ResponsePreTransferTime

Duration from start until the file, requested page, transfer is about to start.
Pre Transfer Timemilliseconds
endpoint_url_ResponseStartTransferTime

Duration from start until the first byte is received.
Start Transfer Timemilliseconds
endpoint_url_ResponseConnectTime

Duration from start until the web server is connected.
Connect Timemilliseconds
endpoint_url_ResponseRedirectTime

Total duration of all redirect steps before the final transfer.
Redirect Timemilliseconds

Risks, Limitations & Assumptions

  • The availability is shown unknown for few resources even if it is enabled on the respective resource metrics. This is because of the presence of multiple native type resources under the same resource type.