Terminology

A cloud-based IT service management (ITSM) platform used for incident, change, problem, and asset management. This plugin communicates with ServiceNow through its REST API.

The authentication mechanism used by the plugin. A client ID and client secret are exchanged for a short-lived bearer token at a configured token endpoint. The plugin caches the token and refreshes it automatically before expiry.

A packaging format for Apache Karaf that bundles OSGi features and their dependencies into a single deployable file. The plugin is distributed as a .kar file.

The deployment unit for Java code inside Apache Karaf. Each bundle is a JAR with OSGi metadata declaring its imports and exports.

The OSGi dependency-injection framework (Apache Aries Blueprint) used by this plugin to wire together its components and inject configuration properties.

A string that uniquely identifies an OpenNMS event type (e.g. uei.opennms.org/nodes/nodeDown). The alarm forwarder uses a set of UEIs to decide which alarms to forward.

A label assigned to nodes in OpenNMS to group them (e.g. Minnovo). The plugin filters alarms and assets by configured category values.

The pair that uniquely identifies a node in an OpenNMS requisition. Asset cache entries and shell commands use foreignSource::foreignId as the cache key.

The plugin component responsible for building a topology map of the monitored network. It traverses EdgeDao data up to a configurable depth and exposes a getParent() method used during alarm enrichment.

The plugin component that listens for OpenNMS alarm lifecycle events, applies UEI and category filters, enriches alarms with topology data, and hands them off to AlarmSender for async delivery.

The plugin component that owns the alarm send queue and executor threads. It converts alarms to Alert DTOs, sends them to ServiceNow, and handles retry and per-send timeout.

The plugin component that runs on a schedule, discovers network assets from the OpenNMS inventory, checks them against the AssetSender cache, and enqueues changed assets for delivery.

The plugin component that owns the asset send queues, executor threads, and the three-tier on-disk cache (hash cache for change detection, plus JSON caches for NetworkDevice and AccessPoint data). It sends assets to ServiceNow asynchronously with retry and per-send timeout.

A WiFi access-point asset type, identified in OpenNMS by the category configured in filter.accesspoint.

A generic network-device asset type covering switches, firewalls, LTE modems, and xDSL modems. Each sub-type is identified by a separate node category.

An asset field sent to ServiceNow indicating whether a device is active, disabled, or suspended. Values: ATTIVO (1), DISATTIVO (7), SOSPESO (100).

The OpenNMS facility for storing sensitive credentials encrypted at rest. The plugin stores ServiceNow connection details in the SCV under the prefix servicenow_connection_.