REST API (Active)

The REST API Active Monitor allows you to monitor any REST API that supports anonymous and basic authentication. It also allows you to validate the JSON Response with JSONPath Queries.

To configure a REST API active monitor:

• Name. Enter a unique name for the monitor. This name displays in the Active Monitor Library.
• Description. Enter additional information for the monitor. This description displays next to the monitor name in the Active Monitor Library.
• Use in rescan. This option indicates to WhatsUp Gold that it should attempt to apply this active monitor when Discovery detects any new conditions that warrant it.
• Timeout. Enter the amount of time WhatsUp Gold waits for the REST API to respond before terminating the connection and returning the timeout error. The minimum allowed value is 1 second and the maximum allowed value is 120.
• REST API
  • Edit Custom Headers. Enter up to ten custom headers required to access the REST API endpoint. A default Accept header is provided and is specified as application/json.

  Note: For monitoring a Progress Application Server for OpenEdge OEManager REST API endpoint, the Accept header must be set to application/vnd.progress+json or */*.

  • REST API URL. The URL for the REST API endpoint that you want to monitor.

  Note: Reference variables (also called Percent variables) for System (%System), Device (%Device), and Application (%Application) are supported in the REST API URL. For more information, see Percent Variables.

  • Method. Select a supported HTTP method for the REST API endpoint. Currently, only the GET method is supported.
  • Ignore Certificate Errors. Enable this checkbox to force WhatsUp Gold to disregard any certificate errors.
  • Use anonymous access. If the REST API endpoint does not require authentication, check this box.
• Down Condition. The monitor will report as down if any of the HTTP response codes listed is returned. You can control which response codes indicate that the monitor is down, and you can also provide a JSONPath Query along with conditions to indicate if the monitor is down. The monitor can use either a Down Condition, a JSONPath Query, or both to return a down response.
• JSONPATH Query. Design a logical test for evaluating conditions that the REST API endpoint returns:
  1. Select the Add icon to enter a conditional test using the JSONPath Query. By default, the "No Comparison Set" text appears in-line.
  2. Double-click inside the JSONPath Query entry, and then select the magnifying glass logo. This prompts you to enter a REST API Credential if "Use anonymous access" is not checked. After the REST API Credentials are verified, the JSONPath Builder window opens.
  3. Select the endpoint that you want to monitor.
  4. Build a logical test that represents a down condition for monitoring the REST API endpoint. Supported value types are Boolean, Number, String, and Other. The Other data type checks if a value is null. Empty strings are supported.
  5. Click Save.

Note: For more information about JSONPath and JSONPath Builder, see JSONPath Query and JSONPath Builder.

See Also Active Monitors Active Script (Active) APC UPS (Active) BGP Peer Status Cloud Resource Monitor DNS Email Exchange 2003 Exchange Fan File Content File Properties Folder FTP HTTP Content JMX (Active) Meraki Device Status Active Monitor Network Statistics Ping Ping Interarrival Jitter Power Supply PowerShell Printer Process Service SMI-S SNMP Extended SNMP (Active) SQL Query (Active) SQL Server SSH (Active) SSL Certificate Storage Controller Health monitor Storage File System Storage Disk Drives Storage LUN Storage Pool TCPIP Telnet Temperature VoIP WAP Radio WMI Formatted WMI Set Polling Properties Apply Action to Monitor Using Action Policies Implicit Action Policy