DiscoveredNode

Represents NetXMS node found while performing network discovery. Is available as a $node in script that is set as DiscoveryFilter.

Instance attributes

agentVersion: String: NetXMS agent version as string.

dnsName: String: Node’s DNS name, resolved by reverse lookup on first access (through the zone proxy if zoning is enabled), or null if the address cannot be resolved

interfaces: Array: Array with node’s interfaces

ipAddr: String: Node’s ip address. Deprecated and will be removed in a future version, use ipAddress instead.

ipAddress ⇒ InetAddress: Added in version 5.1

Primary IP address.

isAgent: bool: TRUE if NetXMS agent detected on node

isBridge: bool: TRUE if node is a bridge

isCDP: bool: TRUE if node supports CDP (Cisco Discovery Protocol)

isLLDP: bool: TRUE if node supports LLDP (Link Layer Discovery Protocol)

isPrinter: bool: TRUE if node is a printer

isRouter: bool: TRUE if node is a router (has IP forwarding enabled)

isSNMP: bool: TRUE if SNMP agent detected on node

isSONMP: bool: TRUE if node supports SONMP/NDP (Synoptics/Nortel Discovery Protocol)

isSSH: bool: TRUE if SSH connection is available for this node

netMask: int: Network mask length (number of bits)

platformName: String: Platform name reported by NetXMS agent

snmpOID: String: SNMP object identifier (result of 1.3.6.1.2.1.1.2.0 request)

snmpVersion: int

SNMP version detected during discovery:

0: SNMP version 1 (also reported if SNMP was not detected, check isSNMP)
1: SNMP version 2c
3: SNMP version 3

subnet: String: Subnet address

zone ⇒ Zone: Zone object (null if zoning is disabled)

zoneUIN: int: This node zone UIN

Instance methods

readAgentList(name): Array

Requests list directly from NetXMS agent on discovered node. Returns array of strings or null if agent connection is not available or request failed.

Table 1. Parameters
name	String	List name.

readAgentParameter(name): String

Requests metric directly from NetXMS agent on discovered node. Returns null if agent connection is not available or request failed.

Table 2. Parameters
name	String	Metric name.

// Discovery filter: accept only nodes running on Linux
if ($node.isAgent)
{
   osName = $node.readAgentParameter("System.Uname");
   return osName != null && osName ~= "^Linux";
}
return false;

readAgentTable(name) ⇒ Table

Requests table directly from NetXMS agent on discovered node. Returns Table or null if agent connection is not available or request failed.

Table 3. Parameters
name	String	Table name.