Documentation forServer & Application Monitor

Configure monitored values in API pollers

For each value monitored by an API poller, you can define:

  • How the value is stored, which controls whether or not a SAM license is consumed.
  • The name used for the value when displayed in the Orion Web Console.
  • Warning and critical thresholds used for Orion Platform alerting.

To configure a value for an API poller, you can either:

  • Click the Monitor () icon next to a new value you're adding to an API poller, or

  • Click the Edit () icon for an existing value in an API poller.

The following dialog box appears:

Options include:

  • How should we store this value?
    • Keep the default setting, "New monitored value," to save the value as historical, time series data that consumes a SAM license.
    • Select "Use as a variable in subsequent request" to save the value for use in later API requests without consuming a license. This is useful for APIs that require authentication tokens in headers; the first request retrieves a token that is then passed to subsequent requests as a variable in headers. See Chain multiple API requests in a single API poller in SAM for details.
  • Orion display name
  • Type
    • Adjust the default setting (Numeric) if returned values will be in string format (for example, Up, Down, True, or False). If you select String, additional fields appear where you can convert expected values to numeric values so you can set thresholds for alerting. For example, map "True" to 1 and "False" to 2, and then use the numeric values in the Threshold fields.

  • Thresholds. Set warning and critical thresholds for API poller alerts.