Cisco SD-WAN Monitor API URL.

Cisco SD-WAN Monitor API username.

Cisco SD-WAN Monitor API password.

The update interval for the Cisco SD-WAN Authentication item, which also equals the access token regeneration request frequency. Check the template documentation notes carefully for more details.

A response timeout for an API.

This macro is used in device discovery. Can be overridden on the host or linked template level.

This macro is used in device discovery. Can be overridden on the host or linked template level.

HTTP proxy for API requests. You can specify it using the format [protocol://][username[:password]@]proxy.example.com[:port]. See the documentation at https://www.zabbix.com/documentation/7.0/manual/config/items/itemtypes/http

Cisco SD-WAN authentication with service account parameters and temporary-generated token usage.

Returns an authentication token and session id; it is required only once and is used for all dependent script items.

A session will expire after 30 minutes of inactivity or after 24 hours, which is the total lifespan of a session.

Check the template documentation for the details.

Item for gathering all the data item errors.

Preprocessing

• JSON Path: $.error

• Discard unchanged with heartbeat: 1h

Item for gathering all devices from Cisco SD-WAN API.

Preprocessing

• JavaScript: The text is too long. Please see the template.

Item for gathering all the data item errors.

Preprocessing

• JSON Path: $.error

• Discard unchanged with heartbeat: 1h

Number of invalid certificates.

Preprocessing

• JSON Path: $.devices[?(@.cert_valid != "Valid")].length()

The total number of all devices.

Preprocessing

• JSON Path: $.devices.length()

• Discard unchanged with heartbeat: 1h

The total number of vEdge devices.

Preprocessing

• JSON Path: $.devices[?(@.type == "vedge")].length()

• Discard unchanged with heartbeat: 1h

The total number of vBond devices.

Preprocessing

• JSON Path: $.devices[?(@.type == "vbond")].length()

• Discard unchanged with heartbeat: 1h

The total number of vSmart devices.

Preprocessing

• JSON Path: $.devices[?(@.type == "vsmart")].length()

• Discard unchanged with heartbeat: 1h

The total number of vManage devices.

Preprocessing

• JSON Path: $.devices[?(@.type == "vmanage")].length()

• Discard unchanged with heartbeat: 1h

Discovering devices from Cisco SD-WAN API.

Preprocessing

• JSON Path: $.devices

Cisco SD-WAN Monitor API URL.

Cisco SD-WAN Monitor API token.

Response timeout for an API.

Critical threshold of the CPU utilization, expressed in %.

Critical threshold of the memory utilization, expressed in %.

This macro is used as a threshold in the memory available trigger.

This macro is used as a threshold in the interface utilization trigger. Can be used with the interface name as context.

Threshold of the error packets rate for the warning trigger. Can be used with the interface name as context.

Critical threshold of the filesystem utilization. Can be used with the filesystem name as context.

Warning threshold of the filesystem utilization. Can be used with the filesystem name as context.

Load per CPU considered sustainable. Tune if needed.

Filter of discoverable filesystems by name.

Filter to exclude discoverable filesystems by name.

Filter of discoverable interfaces by name.

Filter to exclude discoverable interfaces by name.

HTTP proxy for API requests. You can specify it using the format [protocol://][username[:password]@]proxy.example.com[:port]. See the documentation at https://www.zabbix.com/documentation/7.0/manual/config/items/itemtypes/http

Macro for operational state of the interface for the link down trigger. Can be used with the interface name as context.

Update interval for the Routes item, expressed in hours.

Item for gathering device interfaces from Cisco SD-WAN API.

Item for gathering errors of the device interfaces.

Preprocessing

• JSON Path: $.error

• Discard unchanged with heartbeat: 1h

Item for gathering device routes from Cisco SD-WAN API.

Item for gathering errors of the device routes.

Preprocessing

• JSON Path: $.error

• Discard unchanged with heartbeat: 1h

Item for gathering device data from Cisco SD-WAN API.

Item for gathering errors of the device item.

Preprocessing

• JSON Path: $.error

• Discard unchanged with heartbeat: 1h

The number of control connections.

Preprocessing

• JSON Path: $.controlConnections

  ⛔️Custom on fail: Set value to: 0

• Matches regular expression: ^[0-9]+$

  ⛔️Custom on fail: Set value to: 0

Validity status of the device certificate.

Preprocessing

• JSON Path: $["certificate-validity"]

  ⛔️Custom on fail: Set value to: Unknown

• JavaScript: The text is too long. Please see the template.

Total memory, expressed in bytes.

Preprocessing

• JSON Path: $.mem_total

The amount of physical memory (in bytes) immediately available for the allocation to a process or for a system use in the device.

Preprocessing

• JSON Path: $.mem_free

The amount of physical memory (in bytes) used by the kernel buffers.

Preprocessing

• JSON Path: $.mem_buffers

The amount of physical memory (in bytes) used by the page cache and slabs.

Preprocessing

• JSON Path: $.mem_cached

The amount of physical memory (in bytes) used by applications on the device.

Preprocessing

• JSON Path: $.mem_used

Calculated percentage of the memory used, in %.

The total number of CPU.

Preprocessing

• JSON Path: $.total_cpu_count

The average number of processes being or waiting executed over past 1 minute.

Preprocessing

• JSON Path: $.min1_avg

The average number of processes being or waiting executed over past 5 minutes.

Preprocessing

• JSON Path: $.min5_avg

The average number of processes being or waiting executed over past 15 minutes.

Preprocessing

• JSON Path: $.min15_avg

The time the CPU has spent doing nothing.

Preprocessing

• JSON Path: $.cpu_idle

The time the CPU has spent running the kernel and its processes.

Preprocessing

• JSON Path: $.cpu_system

The time the CPU has spent running users' processes that are not niced.

Preprocessing

• JSON Path: $.cpu_user

CPU utilization, expressed in %.

Preprocessing

• JavaScript: return (100 - value);

Reachability to the vManager and/or the entire network.

Preprocessing

• JSON Path: $.reachability

• JavaScript: The text is too long. Please see the template.

The device current state.

Preprocessing

• JSON Path: $.state

• JavaScript: The text is too long. Please see the template.

The description of the device current state.

Preprocessing

• JSON Path: $.state_description

• Discard unchanged with heartbeat: 1h

The device operating system.

Preprocessing

• JSON Path: $["device-os"]

• Discard unchanged with heartbeat: 1d

The architecture of the operating system.

Preprocessing

• JSON Path: $.platform

• Discard unchanged with heartbeat: 1d

The device role in the network.

Preprocessing

• JSON Path: $.device_role

  ⛔️Custom on fail: Set value to: -1

The model name of the device.

Preprocessing

• JSON Path: $["device-model"]

The total number of processes in any state.

Preprocessing

• JSON Path: $.procs

The device serial number.

Preprocessing

• JSON Path: $["board-serial"]

The system host name.

Preprocessing

• JSON Path: $["host-name"]

• Discard unchanged with heartbeat: 12h

The system uptime is calculated on the basis of boot time.

Preprocessing

• JSON Path: $["uptime-date"]

• JavaScript: The text is too long. Please see the template.

The version of the device software.

Preprocessing

• JSON Path: $.version

• Discard unchanged with heartbeat: 12h

The system is running out of free memory.

• SD-WAN: Lack of available memory

The load average per CPU is too high. The system might be slow to respond.

CPU utilization is too high. The system might be slow to respond.

• SD-WAN: Load average is too high

Device is not reachable to the vManager and/or the entire network.

The device current state is not green.

Operating system description has changed. Possible reasons that system has been updated or replaced. Ack to close.

• SD-WAN: Device has been replaced

Device serial number has changed. Acknowledge to close the problem manually.

System name has changed. Ack to close.

The host uptime is less than 10 minutes

Discovering device interfaces from Cisco SD-WAN API.

Preprocessing

• JavaScript: The text is too long. Please see the template.

• Discard unchanged with heartbeat: 3h

Item for gathering data for the {#IFNAME} interface.

Preprocessing

• JSON Path: $.data[?(@["vdevice-dataKey"] == "{#IFKEY}")].first()

  ⛔️Custom on fail: Discard value

Current admin status of the interface.

Preprocessing

• JSON Path: $["if-admin-status"]

• JavaScript: The text is too long. Please see the template.

Current operational status of the interface.

Preprocessing

• JSON Path: $["if-oper-status"]

• JavaScript: The text is too long. Please see the template.

Current bandwidth of the interface.

Preprocessing

• JSON Path: $["speed-mbps"]

• Custom multiplier: 1000000

The total number of octets received on the interface.

Preprocessing

• JSON Path: $["rx-octets"]

  ⛔️Custom on fail: Set value to: 0

• Change per second

• Custom multiplier: 8

The total number of octets transmitted out of the interface.

Preprocessing

• JSON Path: $["tx-octets"]

  ⛔️Custom on fail: Set value to: 0

• Change per second

• Custom multiplier: 8

The number of inbound packets that were chosen to be discarded.

Preprocessing

• JSON Path: $["rx-drops"]

  ⛔️Custom on fail: Set value to: 0

The number of inbound IPv6 packets that were chosen to be discarded.

Preprocessing

• JSON Path: $["ipv6-rx-drops"]

  ⛔️Custom on fail: Set value to: -1

The number of inbound packets that were contain errors.

Preprocessing

• JSON Path: $["rx-errors"]

  ⛔️Custom on fail: Set value to: 0

The number of inbound IPv4 packets that were contain errors.

Preprocessing

• JSON Path: $["ipv6-rx-errors"]

  ⛔️Custom on fail: Set value to: -1

The number of outbound packets that were chosen to be discarded.

Preprocessing

• JSON Path: $["tx-drops"]

  ⛔️Custom on fail: Set value to: 0

The number of outbound IPv6 packets that were chosen to be discarded.

Preprocessing

• JSON Path: $["ipv6-tx-drops"]

  ⛔️Custom on fail: Set value to: -1

The number of outbound packets that were contain errors.

Preprocessing

• JSON Path: $["tx-errors"]

  ⛔️Custom on fail: Set value to: 0

The number of outbound IPv6 packets that were contain errors.

Preprocessing

• JSON Path: $["ipv6-tx-errors"]

  ⛔️Custom on fail: Set value to: -1

This trigger expression works as follows:
1. It can be triggered if the operational status is down.
2. {$IFCONTROL:"{#IFNAME}"}=1 - a user can redefine context macro to value - 0. That marks this interface as not important. No new trigger will be fired if this interface is down.
3. {TEMPLATE_NAME:METRIC.diff()}=1 - the trigger fires only if the operational status was up to (1) sometime before (so, it does not fire for the 'eternal off' interfaces).

WARNING: If closed manually, it will not fire again on the next poll because of .diff.

This Ethernet connection has transitioned down from its known maximum speed. This might be a sign of autonegotiation issues. Acknowledge to close the problem manually.

• Interface ["{#IFNAME}"]: Link down

The network interface utilization is close to its estimated maximum bandwidth.

• Interface ["{#IFNAME}"]: Link down

It recovers when it is below 80% of the {$SDWAN.IF.ERRORS.WARN:"{#IFNAME}"} threshold.

• Interface ["{#IFNAME}"]: Link down

Discovering device filesystems from Cisco SD-WAN API.

Preprocessing

• JavaScript: The text is too long. Please see the template.

• Discard unchanged with heartbeat: 3h

Item for gathering data for the {#FSNAME} filesystem.

Preprocessing

• JavaScript: The text is too long. Please see the template.

The size of the storage pool, in bytes.

Preprocessing

• JSON Path: $.size

• JavaScript: The text is too long. Please see the template.

The available size of the storage pool, in bytes.

Preprocessing

• JSON Path: $.avail

• JavaScript: The text is too long. Please see the template.

The used size of the dataset, in bytes.

Preprocessing

• JSON Path: $.used

• JavaScript: The text is too long. Please see the template.

Space utilization, expressed in %.

Preprocessing

• JSON Path: $.use

Utilization of the space is above {$VFS.FS.PUSED.MAX.CRIT:"{{FSNAME}}"}

Utilization of the space is above {$VFS.FS.PUSED.MAX.CRIT:"{{FSNAME}}"}

• ["{#FSNAME}"]: Disk space is critically low

Discovering Application-Aware routes from Cisco SD-WAN API.

Preprocessing

• JSON Path: $.data

  ⛔️Custom on fail: Set value to: []

Item for gathering data for the route {#LOCAL} => {#REMOTE}.

Preprocessing

• JSON Path: The text is too long. Please see the template.

  ⛔️Custom on fail: Discard value

• Discard unchanged with heartbeat: 3h

The amount of time it takes for a data packet to travel through the route.

Preprocessing

• JSON Path: $.latency

A change in the time it takes for a data packet to travel through the route.

Preprocessing

• JSON Path: $.jitter

Lost packets of data not reached the destination after being transmitted through the route.

Preprocessing

• JSON Path: $.loss_percentage