WISPMapbeta

Docs / Adding devices

Device settings

Every field on a device, and what each one changes: kind, role, criticality, collector, port, credential profile, ping and polling.

Updated 10 November 2026

Devices are added and edited in Admin → Devices by owners and admins.

The fields

Field What it does
Name What you call it. Shown everywhere, and in alerts.
Site Where it is. Every device belongs to a site.
Collector Which collector monitors it. Empty = not monitored. With one collector, new devices get it automatically.
Kind MikroTik RouterOS (read over the API), SNMP (other makes), or Ping only.
Role What it does in your network. It sets how serious an outage of this device is (see below).
Criticality Adjusts that: Critical always makes an outage critical; High makes it at least major; Low makes it at most a warning; Normal leaves the role's.
Management IP / host The address the collector reaches it on. Each address can be used once in your organisation.
API / SNMP port 8728 for the RouterOS API, 8729 with TLS, 161 for SNMP. It follows the kind until you change it.
API over TLS (8729) RouterOS only: use api-ssl (how).
Credential profile Which credentials in the collector's .env it uses. default unless you've set up profiles.
Ping it Ping it every cycle. Leave it on: up and down come from ping.
Poll it Read it over the API or SNMP. Off for ping-only devices.
Notes Anything for your team.

A device that doesn't answer ping but whose API or SNMP answers is still up when Ping it is off: then the API decides.

Role and outage severity

When devices go down, the most serious one in the outage sets its severity:

Role Outage severity
Core router critical
Router major
Backhaul critical
Access point major
Switch major
CPE warning
Other warning

Criticality then adjusts it per device. A core router or backhaul down is critical; an access point or tower router is major; anything else is a warning, unless you raise its criticality.

Changing a device

Changes reach the collector within a minute; a new address, port or TLS setting makes it reconnect then. A device's history stays when you edit it, and is deleted with the device.