NetXMS icon

NetXMS

Interact with the NetXMS network monitoring and management system

Actions41

Find → Get Connection History

AI-generated

Summary

Queries the NetXMS connection history (MAC address connection events) via GET /v1/connection-history, with optional filters for MAC, node, switch, interface, and time range.

Inputs

  • MAC Address — Filter records by MAC address. Sent only if non-empty.
  • Node ID — Match records where this node is either the switch or the connected node. Ignored if 0.
  • Switch ID — Filter by switch node ID. Ignored if 0.
  • Interface ID — Filter by interface ID. Ignored if 0.
  • From (Unix Timestamp) — Start of the time range. Ignored if 0.
  • To (Unix Timestamp) — End of the time range. Ignored if 0.
  • Result Limit — Maximum records to return (UI default 1000, max 10000 per the description). The node forwards the value as given and does not enforce the cap itself.

Output shape

The JSON response from the NetXMS REST API, split into one n8n item per element if it is an array. Otherwise a single item.

The exact record fields are defined by the NetXMS server and not by this node. Each input item triggers a separate login and request. With Continue On Fail enabled, errors are returned as an item containing {error: message}. Filters set to 0 or empty are omitted from the query.

Examples

Example 1: Track where a device has been plugged in over the last day

MAC Address = 00:1A:2B:3C:4D:5E, From = Unix timestamp of 24 hours ago, To = now

Example 2: Audit connection events on a specific switch

Switch ID = 123, Result Limit = 500

Links

Discussion