Monitor custom metrics from HTTP endpoints via API

Collect data from devices, services, or other HTTP endpoints. You can define custom metrics, configure how data is polled, and store the results for analysis.

Observe monitored metrics

1. In SolarWinds Observability SaaS, click Infrastructure > Software and activate the API Monitor tab. The tab lists all available monitors, with details, such as the collected metric prefix, number of monitored metrics, or the polling interval.

2. Click the Metric Prefix to open the Metrics Explorer displaying all metrics with the given prefix.

3. In the Metric Explorer, click a metric to display a graph showing polled values.

API monitors send requests from source IP addresses that are not static and can change at any moment. For the identification of HTTP requests coming from a SolarWinds Observability API Monitor, use headers. You can also configure authentication to increase security.

Create an API monitor

1. In SolarWinds Observability SaaS, click Infrastructure > Software and activate the API Monitor tab.

2. Click Create API Monitor.

3. On the Settings screen:

   1. Provide a Name for the monitor. The name is used as the prefix for the new metric. You can use it to find your monitors in the Metrics Explorer.

   2. (Optional) Add a description to explain the monitor's purpose.

   3. (Optional) Specify a custom polling interval.

      By default, custom monitors are polled every two minutes. If you want to change the polling frequency, click Use Custom Polling Interval and specify the new polling interval.

   4. Click Next.

4. (Optional) On Select Entity, you can link polled metrics to an already monitored entity.

   1. Select an entity type in the list.

   2. Select the entity.

   3. Click Next.

5. On Create Request, specify the request you want to send to the URL.

   1. Enter the Request URL.

   2. Specify headers for your request. Click Add Header and provide the Name and Value for the header. Repeat for all headers you want to include in the request.

      Some headers, such as Host, Cookie, Content-Length, and User-Agent, might be restricted due to security concerns, internal use, or inapplicability.

   3. (Optional) Select the authentication type and enter required details.

      No Authentication - default option

      Basic Authentication

      1. Select credentials from the List or click Add Credentials to specify a new set of credentials.

      2. To create a new set, provide a name for the set, user name, and password. Click Save. The new credentials set will be added to the list and selected.

   4. Click Send Request. The response (headers and content) are displayed on the screen.

   5. Select metrics to monitor.

      1. Review the response. You can see a toggle next to items you can monitor.

      2. Enable the toggle for a metric you want to monitor.

      3. In the Configure Metric pop-up, enter a display name. Review the read-only box below to see the metric name. This is the name you will see in the Metrics Explorer.

         If you use camel case or blanks in the display name, the metric name will be adjusted. Blanks are replaced with an underscore, upper case letters are transformed to lowercase and are preceded with an underscore. For example, the display name Rate Limit or RateLimit will be reflected in the metric name as rate_limit.

      4. If the values returned will be in string format, such as true or false, use the Convert String to Numeric fields to add the string values and map them to numeric values. For example, map "OK" to 0, "Error" to 1, and all other values including null to -1. The strings are automatically replaced by and stored as the corresponding numbers. You can also use the numeric values in alert definitions.

      5. Click Save and complete the steps for all metrics to monitor.

   6. When you have added all metrics you want to monitor, click Next.

6. Review the Summary and click Save. You will return to the API monitor tab where you can see your new metric.

Edit API monitors

If you want to rename a monitor, change the URL, add or remove a metric it specifies, edit the monitor.

In SolarWinds Observability SaaS, click Infrastructure > Software and activate the API Monitor tab.

1. Find the monitor to edit, click the vertical ellipsis at the end of its row and select Edit. This starts the API monitor wizard.

2. On Settings, you can:

   • Change the prefix used for polled metrics: Adjust the Name and check the change in the read-only field below.

     Changing the name also changes the metric prefix. As a result, the data is polled from scratch and historical data is not linked to the metric anymore.

   • Change the polling frequency: Click the slider and fill in the required polling frequency.

3. On Create Request, you can make the following changes:

   • Change the request URL

   • Adjust the headers.

   • Add or remove monitored metrics: Click Send Request and use the sliders to adjust what is monitored.

4. Review the summary and complete the wizard.

Stop/re-start polling data for a monitor

If you want to temporarily stop polling metrics for a monitor, disable it.

1. In SolarWinds Observability SaaS, click Infrastructure > Software and activate the API Monitor tab.

2. Find the monitor to edit, click the vertical ellipsis at the end of its row and select Disable. Data for all metrics in the monitor will stop being polled. Check the monitor status on the API Monitor tab, it should be Disabled.

3. To start polling data for the monitor again, click the vertical ellipsis and select Enable.

Delete API monitors

If you want to remove an API monitor, delete it.

1. In SolarWinds Observability SaaS, click Infrastructure > Software and activate the API Monitor tab.

2. Find the monitor to delete, click the vertical ellipsis at the end of its row and select Delete.

   The monitor is deleted and new data for the metric is not polled anymore. Historical data is still accessible, you can find it in the Metrics Explorer using the deleted metric name.