This document explains how Multi-IP Ping Monitoring works and outlines the steps to apply it to a resource.

Note: Multi IP Ping Monitoring is not supported in Windows Gateway. This monitor only supports Ubuntu (classic and Next Gen Gateway).

Introduction

Multi-IP Ping Monitoring is a small utility that actively checks device reachability by pinging all physically connected IPs of device. It automatically pings each host at user-defined intervals and reports the device’s reachability status.

Pre-requisites

  • Mapping a gateway management profile to the resource is required.
  • Add SNMP-type credentials to the resource to retrieve alternative IPs using IP-MIB and HSRP IPs using CISCO-HSRP-MIB.

Template Overview and Business Use Case:

Template: Multiple IPs Ping Reachability Monitor - v2
Business Use Case:
Monitors the device’s reachability by first pinging the management IP. If the management IP is unreachable, it checks reachability using custom parameters specified in the assigned template.

  • If the Include Discovery IPs List parameter is set to Yes:
    • The monitor evaluates both:
      • The custom IP list provided in the configuration.
      • The alternative IPs discovered via SNMP by querying OID 1.3.6.1.2.1.4.20.1.1.
    • It retrieves HSRP IPs using OID 1.3.6.1.4.1.9.9.106.1.2.1.1.11 and removes them from the discovered IP list.
    • It combines the filtered discovered IPs with the custom IP list.
    • It removes any IPs listed in the Exclude IPs List.
    • It pings the final set of IPs:
      • If any IP responds, the metric is set to 1 (REACHABLE).
      • If none respond, the metric is set to 0 (UNREACHABLE).
  • If the Include Discovery IPs List parameter is set to No and the management IP is unreachable:
    • The monitor uses only the custom IP list, if provided.
    • If no custom list is available, it retrieves alternative IPs via SNMP by querying OID 1.3.6.1.2.1.4.20.1.1.
    • It retrieves HSRP IPs using OID 1.3.6.1.4.1.9.9.106.1.2.1.1.11 and removes them from the alternative IP list.
    • It removes any IPs listed in the Exclude IPs List.
    • It pings the remaining IPs:
      • If any IP responds, the metric is set to 1 (REACHABLE).
      • If none respond, the metric is set to 0 (UNREACHABLE).

Examples:

Consider a device with the following IP configuration:

  • Management IP: A
  • Custom IPs: B, C, D
  • IP-MIB IPs: C, D, E, F
  • HSRP IPs: F, G
  • Exclude IPs: D, H

Case 1: Include Discovery IPs List = Yes
Management IP A is down.

  • The monitor considers:
    1. Custom IPs: [B, C, D]
    2. IP-MIB IPs: [C, D, E, F] and it removes HSRP IPs [F, G], resulting in IP-MIB IPs: [C, D, E]
  • Merged list becomes: [B, C, D, E]
  • It removes Exclude IPs [D, H], resulting in final list: [B, C, E]
  • If any of the IPs in the final list respond, the device is considered up; otherwise, it's down.

Case 2: Include Discovery IPs List = No
Management IP A is down.

  • The monitor considers only:
    1. Custom IPs: [B, C, D]
    2. It removes Exclude IPs [D, H], resulting in: [B, C]
  • If any of the IPs in the final list respond, the device is up; otherwise, it's down.

Case 3: Include Discovery IPs List = No, and no Custom IPs provided
Management IP A is down.

  • The monitor considers:
    1. IP-MIB IPs: [C, D, E, F] and removes HSRP IPs [F, G], resulting in: [C, D, E]
  • Removes Exclude IPs [D, H], resulting in final list: [C, E]
  • If any of the IPs in the final list respond, the device is up; otherwise, it's down.

Template: Multiple IPs Ping Reachability Monitor
Business Use Case:
The monitor checks device reachability by first pinging the discovered IP. If discovered IP is unreachable, it checks reachability using multiple IPs defined in the custom parameter during template assignment.

  • Monitors device reachability state by pinging device discovered IP at the first step.
  • If the discovered IP is not reachable, monitor tries to get the reachability info using multiple IPs provided as part of a custom parameter at the time of template assignment.
  • If a custom IPs list is not provided, this monitor will try to get the device IP’s list through SNMP by querying OID 1.3.6.1.2.1.4.20.1.1, and check for the device reachability state.
  • If any of the IPs are being pinged, then the metric values would be 1 - REACHABLE else 0 - UNREACHABLE.

Apply Multi IP Ping Monitoring on the Device

To apply a Multi IP Ping Monitoring:

  1. From All Clients, select a client.
  2. Go to Infrastructure > Resources.
  3. From the available resources, select the required resource.
  4. Select a Monitor from the left side menu. On the Templates screen, click +Assign Templates to open the Apply Templates screen.


  1. From Select Templates Available templates, select Multiple IPs Ping Reachability Monitor template. Selected templates display the chosen templates.
    Note: Select the Collector Type as Gateway.
  2. Click Assign, which displays the Enter Configurations section.


  1. Enter Value for the Assigned Templates and Configuration Parameters and click Assign.


The templates screen displays the selected templates.

Configuration Parameters

NameDisplay NameDefault Value
multi.ip.ping.reachability.data.bytesData Bytes64
multi.ip.ping.reachability.pkt.intervalPacket Interval1000
multi.ip.ping.reachability.pkts.countPacket Count5
multi.ip.ping.reachability.discovery.frequencyDiscovery Frequency In Mins60
multi.ip.ping.reachability.ip.listComma Separated IPs ListNone
Provide a comma-separated list of IP addresses. If the management IP is not reachable, these IPs will be used to check the device's reachability.
multi.ip.ping.reachability.exclude.ip.listComma Separated Exclude IPs ListNone
Provide a comma-separated list of IP addresses. The specified IPs will be excluded when evaluating the device's reachability.
multi.ip.ping.reachability.include.discovery.ip.listInclude Discovery IPs ListYes/No

If the parameter value is set to Yes, the tool considers both custom and discovered alternative IPs after excluding the HSRP IPs from the alternative IPs list.

If the parameter value is set to No, the tool considers discovered alternative IPs after excluding HSRP IPs from the alternative IPs list, but if custom IPs are configured, it will only consider the custom IPs.

Get Latest Metric Values

To view latest metric values, select Metrics from the left side menu. Modify the time frame based on your requirement.


Graphical metrics representation

To view metrics in graphical representation, select Metrics from the left-side menu.


Sample Alert

To view Alerts, select Overview from the left side menu and then click on any alert to view details.


Troubleshooting

To check whether monitoring data is collected from the classic gateway:

  1. Log in to the gateway shell.
  2. Enter CLI mode by running the command: gcli
  3. Enable logging with the command: flag add multi.ip.ping.log on 30
  4. Exit CLI using the command: exit
  5. View logs using: tail -100f /var/log/app/vprobe.log

To verify whether monitoring data collected from the nextgen-gateway

  1. Login into gateway shell.
  2. Login to the vprobe container using the following command
    kubectl exec -it nextgen-gw-0 -c vprobe -n <namespace> -- bash
    kubectl exec -it nextgen-gw-0 -c vprobe -- bash
  3. Enable gateway CLI mode by using the command gcli.
  4. Execute flag add multi.ip.ping.log on 30, and then exit from gcli through exit command.
  5. Use the command tail -100f /var/log/app/vprobe.log to verify logs.