Documentation forSolarWinds Platform

Transform poller results in the SolarWinds Platform

This SolarWinds Platform topic applies only to the following products:

Hybrid Cloud Observability EssentialsHybrid Cloud Observability Advanced

NAMNPMNTASRMVNQM

Values polled by a custom poller are often better understood after a calculation transforms the value to a different format.

For example, if a poller returns temperature values in Celsius, you might want to see the values in Fahrenheit.

Pollers that you use in a transformation must be assigned to the nodes to poll for values that will be transformed.

  1. Start the Universal Device Poller application, for example by clicking Start > SolarWinds Orion > Universal Device Poller.

  2. Click Transform Results, and click Next to acknowledge examples of transformations.
  3. Type the name and description for the transformation, and click Next. Names must be unique.

    Names are required. Any spaces in the name are removed.

    Descriptions are optional but might be helpful in identifying the type of information generated by the transformation.

    You can also change other default settings:

    1. Select Yes in the Keep Historical Data section. You will be able to view the transformed poller data in charts and gauges in the SolarWinds Platform Web Console.
    2. Select Enabled as the Status if you want your transformation to begin calculating results immediately.

      If you select Disabled, the transformation will not transform polled data.

    3. In the Group field, select a group where you want to add the transformation. To add a group, provide the new group name.
    4. Optional: provide a polling interval.

      Make sure all pollers in the transformation use the same polling interval.

  4. Provide the formula for calculating the transformation.
    1. Click Add Function, and select a function. See Poller transformations for the SolarWinds Platform.

    2. Click within the bracket, click Add Poller, and select the poller you want to transform.

      • Separate pollers with commas. The following example averages the results of three pollers:

        avg({poller1},{poller2},{poller3})

      • Use standard mathematical operations:

        {poller1}+{poller2}

      • Use the mathematical constants e and π, as E() and PI(), respectively.
      • Nest formulas. The following example returns the average of two poller comparisons:

        avg(min({poller1},{poller2}),max({poller3},{poller4}))

  5. Test the transformation on a device, and click Next.

    Troubleshooting failed transformation tests

    If the test fails, verify the following items:

    • Is your formula correct? Ensure that all braces are balanced, that there are no unnecessary spaces, and that all pollers return the same type of values.
    • Are you using the correct community string for the node that is being polled for the test? For more information about providing community strings, see Edit node properties.
    • Does the device support the polled MIB or OID? See the documentation supplied by the device vendor to confirm supported MIBs for your device.
    • Can you access the device from the SolarWinds Network Performance Monitor server? Confirm that the device is responding to both ICMP and SNMP requests.
  6. Select nodes for the transformation, and click Test.
    • Interfaces are not displayed unless your poller transformation operates on an interface poller.
  7. If the transformation output is a table, select labels for the rows in the table, and click Next.
  8. Select SolarWinds Platform Web Console views where you want to include the transformed values as a chart or table, and click Finish.

    Click Preview to see how your poller resource will display in the selected SolarWinds Platform Web Console view.

  9. The new transformation is added to All Defined Pollers and applied on the selected nodes or interfaces. You can add a Universal Device Poller resource to display transformed values in the SolarWinds Platform Web Console views.

If the transformation combines data from other pollers, make sure that it is assigned to the same node or interface as the pollers used for the transformation and that it has the same polling interval.