Auvik icon

Auvik

Interact with Auvik API

Actions41

SNMP Poller → Get History (String)

AI-generated

Summary

Retrieves historical string-valued SNMP poller readings from Auvik for selected tenants over a preset or custom time range, optionally narrowed by device and poller setting IDs.

Inputs

  • Time Preset — Time window to query (e.g. Last 5 minutes to Last 30 days, Today, Yesterday, This week/month, Quarter/Year to date, Last month, or Custom). Defaults to Last 24 hours.
  • From Time (required) — Lower bound in 'YYYY-MM-DD HH:mm:ss' format with no timezone. Shown and required only when Time Preset is Custom.
  • Thru Time — Upper bound in 'YYYY-MM-DD HH:mm:ss' format with no timezone. Shown only when Time Preset is Custom.
  • Compact — When true, returns only changes in value. When false, the date range is limited to 24 hours by the API; the node forces compact on if the range exceeds 24h and you haven't set it.
  • Tenants (required) — One or more tenants to query. At least one must be selected.
  • Device ID — Filter history to one device. It is validated against the selected tenant(s) before the request.
  • SNMP Poller Setting IDs (CSV) — Comma-separated poller setting IDs to filter on. If a Device ID is given, the node checks that these settings apply to that device and are configured as pollers.
  • Debug Request — Includes debug info on the output and logs the built request.

Output shape

The Auvik API response containing historical string-type SNMP poller readings for the requested tenants, time range and filters.

Validation errors are raised for missing tenants, an unknown device, or settings that don't apply to the device. If no data is returned, a helpful message is added. With Debug Request enabled, extra debug information is included. The exact response fields are not shown in the source pack.

Examples

Example 1: Check the last day of string poller values (e.g. firmware or status text) for one device

Time Preset: Last 24 hours; Tenants: select one; Device ID: the device's ID; SNMP Poller Setting IDs: the relevant setting ID; Compact: true

Example 2: Audit changes to a string value over a custom week

Time Preset: Custom; From Time: 2026-09-20 00:00:00; Thru Time: 2026-09-27 00:00:00; Compact: true; Tenants: select one or more

Links

Discussion