Network Management

How to transform values in Universal Device Poller

This article provides an example of how to use a Universal Device Poller (UnDP) transform to convert a raw integer value into a meaningful percentage and display it in the SolarWinds Platform Web Console.

First published date

2/5/2026 1:04 PM

Last published date

2/5/2026 5:18 PM

Overview

In some cases, a device returns a raw integer value that represents a percentage or another scaled metric.
This article walks through a sample scenario where a UnDP is configured to monitor system ASP usage and demonstrates how to:

  • Apply a transform to turn the raw integer into a percentage.

  • Assign the transformed UnDP to a node.

  • Configure Web Display so the transformed value appears in the desired node view.

Product section

Network Performance Monitor

Resolution

Scenario

You have configured a UnDP to monitor the percentage of system ASP usage using the following OID:

  • Name: cpuPercentSystemASP

  • OID: 1.3.6.1.4.1.597.3.1.2.6.0

The device returns an integer instead of a directly usable percentage, so you need a transformed UnDP to convert the raw value to the correct scale.

Examples of attempted formulas:

  • {cpuPercentSystemASP}%

    • Displays the raw value as an integer with a percent sign, but does not change the scale.

  • {cpuPercentSystemASP}/10000

    • Applies a scale factor, but the result did not appear in the console until the transformed poller was properly assigned and configured for Web Display.

Step 1: Verify the transform in UnDP

  1. Open the Universal Device Poller application on the SolarWinds Platform server.

  2. Create (or edit) a Transform Result UnDP that:

    • References the original poller (cpuPercentSystemASP).

    • Applies the correct scaling formula (for example, dividing by 100 or 10,000 depending on how the device encodes the value).

  3. Confirm in the UnDP interface that the transformed poller returns the expected percentage when tested against the node.

The UnDP application should show the correct transformed result when you click Test.

Step 2: Assign the transformed UnDP to the node

  1. In the Universal Device Poller application, select the transformed poller.

  2. Click Assign Pollers (or equivalent option).

  3. Select the node(s) you want to monitor.

  4. Click Test to verify that the node supports the OID and that the transformed poller returns data.

  5. Save the assignment.

At this point, the transformed poller is collecting data from the node, but you still need to configure where it appears in the web console.

Step 3: Configure Web Display for the transformed UnDP

  1. In the Universal Device Poller application, right‑click the transformed poller and click Web Display.

  2. Set Display in Web Console to Yes.

  3. Select where you want the transformed UnDP to be shown, for example:

    • Node Details – Summary

    • Node Details – Vital Statistics

    • Other applicable node/interface views

  4. (Optional) Use Preview to confirm how the widget will look.

  5. Click Finish.

After this, when you open the Node Details page in the SolarWinds Platform Web Console, the transformed UnDP widget should show the percentage value instead of the raw integer.

Important notes

  • Creating a UnDP (or transformed UnDP) does not change built‑in resource values.

    • For example, it does not modify the value shown in Volume Details or other out‑of‑the‑box widgets returned by standard SNMP polling.

  • The UnDP and its transform simply provide additional custom values based on the OID you configured.

  • If you do not see the transformed value in the web console:

    • Confirm that the poller is assigned to the node and returns data when tested.

    • Confirm that Keep Historical Data is enabled if you expect charts.

    • Verify that Web Display is set to Yes and mapped to the correct views.