Management Console

The management console (nxmc) is your primary interface for interacting with NetXMS. It is available in two forms:

  • Desktop client — a cross-platform Java-based application

  • Web console — a browser-based interface accessible via HTTPS

Both are builds of the same client and provide the same core functionality.

Connecting to NetXMS

Web Console

Open your browser and navigate to the URL provided by your administrator (typically https://<server>/nxmc).

Enter your username and password on the login page. After authentication, the console opens with the default view configured by your administrator.

Desktop Client

Start the desktop client: on Windows, use the NetXMS Client shortcut in the Start menu; on macOS, open NetXMS Console from Applications. On the login screen:

  1. Enter the Server address (hostname or IP of the NetXMS server)

  2. Enter your Login and Password

  3. Click OK

The desktop client connects to the server on TCP port 4701 by default.

Console Layout

The management console uses a layout with several key areas:

Perspective Switcher

A column of buttons along the left edge of the window. Each button opens a perspective — a set of views tailored to a specific task (see Perspectives).

Object Browser

Next to the perspective switcher. Displays the object tree — the hierarchical view of monitored infrastructure. Click on objects to select them and view their details. Note that "Object Browser" is a descriptive term used in this guide; in the console the panel is titled with the name of the current perspective (Infrastructure, Network, and so on).

Working Area

The central area where views and editors are displayed. This is where you see object details, alarm lists, graphs, dashboards, and maps.

Header

At the top of the console. Shows the NetXMS logo and title, an indicator when the console is out of sync with the server, the server name and clock, and buttons for the AI chat, user properties, preferences, help, and product information.

Object Browser

There is no single combined object tree — each object-based perspective has its own object tree showing the objects relevant to that perspective:

  • Infrastructure — your main workspace, containing containers, nodes, and other infrastructure objects organized by your administrator

  • Network — all discovered subnets and their nodes, organized by zone and IP topology

  • Maps — network maps

  • Dashboards — available dashboard objects

  • Business Services — service availability definitions (if configured)

  • Assets — asset inventory with attributes defined by your administrator

  • Templates — data collection templates (primarily used by administrators)

Navigation and filtering work the same way in every object tree.

Navigating the Tree

  • Click the triangle (or +) next to an object to expand it and see children

  • Click an object to select it; its details appear in the working area

  • Double-click a node to open its detailed view

  • Right-click an object to see the context menu with available actions

Filtering Objects

Use the filter field at the top of the Object Browser to search for objects by name. Type part of a name and the tree filters to show only matching objects and their parents.

The filter supports prefix characters that change the search behavior:

Prefix Searches By Example

(none)

Object name, including alias (default). Without wildcards, the name or alias must contain the filter text, case-insensitively. With * or ?, the pattern is matched from the start of the name.

web* — all objects starting with "web"

>

IP address (prefix match)

>192.168.1. — objects whose IP address starts with 192.168.1.

/

Object comments

/maintenance — objects with "maintenance" in comments

^

Exact IP address match

^192.168.1.10 — object with exactly this IP address

#

Object ID

#1234 — object with ID 1234

@

Zone (UIN prefix or zone name)

@5 — objects in zones whose UIN starts with 5

Views

Views are panels in the working area that display different types of information. Key views include:

Alarms

Displays active alarms across the system (or for a selected object and its children). From this view you can acknowledge, resolve, and terminate alarms, open alarm details, jump to the source object, and filter by severity, state, or source.

See Working with Alarms for the complete alarm workflow.

The Alarms view can show alarms globally (all alarms in the system) or scoped to a specific object subtree. Select a container or node in the object tree and open its Alarms tab to see only alarms related to that branch.

Object View Tabs

When you select a node in the object tree, information about it is shown as view tabs in the working area:

  • Overview — summary of the object: general information, state, communications, topology, inventory, location, last values, external resources, and comments

  • Interfaces — network interfaces of the node with their status and configuration; Export selection to CSV…​ (context menu) and Export all to CSV…​ (view menu, Since 6.2.4) save the table to a file

  • Alarms — alarms for this node and its children

  • Data Collection — collected DCI values (see below)

  • Performance — quick access to predefined performance graphs (CPU, memory, disk, network)

  • Software Inventory — list of installed software packages (if agent is installed)

  • Hardware Inventory — hardware component details (if available)

  • File Manager — browse files on the remote system through the agent (if agent is installed)

Data Collection

The Data Collection view shows all DCIs configured on a node. By default it displays the last collected values; the Edit mode toggle switches the view to data collection configuration (used by administrators).

Column Description

Owner

Object the DCI belongs to.

ID

Internal identifier of the DCI.

Display name

Name of the metric being collected.

Value

Most recently collected value.

Timestamp

When the value was last collected.

Tag

User-defined tag assigned to the DCI.

Threshold

Current threshold state — indicates if the value has crossed a defined boundary.

Event

Event generated by the currently active threshold.

Message

Message of the threshold event.

Comments

Comments configured on the DCI.

Double-click a DCI row to open a historical graph for that metric; for a table DCI, double-click opens the table last values view.

Right-click a DCI to access additional options:

  • History (Ctrl+H / Cmd+H) — view a table of all collected values over time

  • Line chart, Bar chart, Pie chart — open the collected data as a chart; Real-time line chart and Raw data line chart variants are also available. For table DCIs, use Table last value instead.

  • Actions submenu — Force poll, Clear collected data (requires appropriate permissions), and Start data recalculation

Graphs

Graphs display historical DCI data as line, area, or bar charts. You can:

  • Adjust the time range using the toolbar or by dragging on the time axis

  • Zoom in on specific time periods

  • Add multiple DCIs to a single graph for comparison

  • Save graph configurations as predefined graphs for quick access

Dashboards

Dashboards are accessed from the Dashboards perspective or from links provided by your administrator. Click on a dashboard to open it in the working area.

Dashboards display a combination of elements configured by the administrator:

  • Status indicators and alarm summaries

  • Performance graphs and gauges

  • Tables of collected values

  • Network maps

  • Custom HTML/web content

  • Geographical maps

Network Maps

Network maps visualize the monitored infrastructure and its interconnections. Maps are accessed from the Maps perspective.

Objects on maps are color-coded by their current status. Links between objects show connection type and can display utilization metrics.

For more details on topology visualization, see Topology.

Context Menu Actions

Right-clicking on objects provides access to common operator actions. The exact set of menu items depends on the object type and your access rights.

Node Context Menu

Information about a node (alarms, collected values, performance graphs, inventory) is shown in view tabs when the node is selected — see Object View Tabs. The context menu provides actions. Many of these items are also available on other object types (sensors, collectors, racks, access points).

Most items are placed directly on the top level of the menu; only a few are grouped into submenus.

Menu item Contents

Create

Create a child object (shown for objects that can have children).

Bind to container…​ / Unbind from container…​

Placement of the object in the object tree; Move to another container…​ moves it to a different container.

Link to asset…​ / Unlink from asset

Link the object to an asset record, or remove the link.

Apply template…​ / Remove template…​

Apply data collection templates to the object, or remove them.

Maintenance

Start, end, or schedule maintenance mode for the object.

Manage / Unmanage

Toggle managed state. When unmanaged, all child objects (interfaces, network services) are also unmanaged — metrics are not collected and no polls are scheduled.

Rename / Delete / Decommission…​

Rename or delete the object; Decommission…​ is available for nodes.

Change zone…​

Move the node to another zone (when zoning is enabled).

Send user support application notification

See User Support Application Notifications.

Edit agent configuration / Deploy package…​ / Upload file…​

Agent-related operations for nodes with an agent; Upload file…​ uploads a file from the server to the node and can be applied to multiple nodes at once.

Remote control / Take screenshot

Remote control (VNC) is shown only for nodes with VNC capability; Take screenshot only for Windows nodes with an agent.

MIB Explorer / Agent Explorer / Web Service Query

MIB Explorer for SNMP-capable nodes; Agent Explorer and Web Service Query for nodes with an agent.

Trace path / Topology maps

Trace path (Route from NetXMS server, Route from…​, Route to…​, plus the L2 path variants) and Topology maps (Layer 2 topology, IP topology, Internal communication topology), for nodes with a valid primary IP address.

Execute script

Open the NXSL script execution view for the object.

Logs

Log views filtered for the object.

Tools

Object tools defined by the administrator (for example, ping or traceroute).

Poll

Manually start a poll. See Poll Types for the available types.

Summary tables / Graphs / Dashboards / Network maps

Summary tables, template graphs, dashboards, and network maps applicable to the object.

Explain status…​ / Show effective rights…​ / Properties…​

Explain how the object’s status was calculated, show your effective access rights on the object, or open the object properties dialog.

Items are shown only when they apply to the selected object and your access rights.

Poll Types

When selecting Poll from the node context menu, the following poll types are available:

Poll Type Description

Status

Determine the current status of the object (reachability check).

Configuration

Discover current configuration — interfaces, supported protocols, capabilities. By default also executes auto-bind scripts for templates and containers.

Configuration (with reset)

Same as Configuration poll but resets previously detected capabilities and detects them again. Can only be executed manually. Requires modify access rights on the object, while other poll types require only read access.

Instance discovery

Discover or update dynamic DCI instances (e.g., disk volumes, database instances).

Interface

Update interface names and related interface information.

Network discovery

Examine this node’s ARP and routing tables to discover new nodes.

Topology

Gather information about network link layer topology connections.

Container and Subnet Context Menu

Some actions performed on containers or subnets are executed on all child nodes:

  • Manage / Unmanage — applied to all nodes under the container or subnet

  • Upload file…​ — uploads a file to all nodes that have an agent installed

  • Tools — object tools are executed on each child node

The Alarms tab of a container or subnet shows alarms from all child nodes.

If a container or subnet is deleted and is the only parent of a node, the node is also deleted.

Perspectives

On the left side of the management console there are perspective selection buttons. Each perspective provides a different view of the system, tailored to a specific task.

A perspective contains one or multiple views. If there are multiple views, they are organized as a view stack with tab navigation. Some perspectives have a button in the upper right corner that opens a view with additional object information.

The switcher groups the perspective buttons into sections: Objects (Infrastructure, Network, Assets, Templates), Monitoring (Dashboards, Graphs, Maps, Alarms, Incidents), Business (Business Services, Reporting), Analysis (Logs, Monitor), and Administration (Tools, Configuration), with the Pinboard at the bottom.

There are 16 perspectives in total, including the Pinboard described below (some may be hidden depending on your access rights and server configuration):

Infrastructure

Organize objects in a logical way, based on location, type, or function. This is your primary workspace.

Network

Objects organized by zone and network subnet (IP topology view).

Assets

Hierarchical structure of inventory assets; asset attributes are defined by your administrator.

Templates

Data collection and policy templates (primarily used by administrators).

Dashboards

High-level visual displays combining data from multiple sources to show network health at a glance.

Graphs

Saved graphs that display collected data from multiple objects.

Maps

Layer 2 topology, IP topology, OSPF, or custom network maps.

Alarms

System-wide alarm view for all objects.

Incidents

Trouble tickets (incidents) associated with objects, used to track investigation and resolution of problems.

Business Services

Availability monitoring of logical services (email, web site, server farm, call center, etc.).

Reporting

Report execution and rendering (communicates with a separate reporting process, e.g., Jasper).

Logs

Collective view of different logs (event log, audit log, syslog, SNMP trap log).

Monitor

Real-time display of events, traps, and log entries as they arrive.

Tools

Search and server management utilities (MAC address search, IP address search, etc.).

Configuration

Access to system configuration (primarily used by administrators).

Pinboard

The Pinboard perspective provides quick access to your favorite views. You can pin any view using the pin button in the view’s toolbar (F7); its drop-down lets you choose where the view is pinned — the Pinboard, or the left, right, or bottom edge of the window. Open the Pinboard perspective with F12. This allows you to build a personalized set of frequently accessed views for rapid navigation.

Preferences

The preferences button in the header opens the console preferences. On the Objects page, Full object synchronization on startup also loads node components (such as interfaces) at login instead of on demand.

Preferences are stored locally on the client.

Searching for Objects

To search for objects across the whole system, open the Find Object view in the Tools perspective. Three matching modes are available: plain text, pattern (with * and ? wildcards), and regular expression. Search results show matching objects; right-click a result and select Go to object to navigate to it.

Keyboard Shortcuts

Common keyboard shortcuts in the management console:

Shortcut Action

Ctrl+F / Cmd+F

Focus the filter field in the current view

Ctrl+F2 / Cmd+F2

Show or hide the filter in the current view

F5

Refresh current view

F7

Pin current view

F8

Pop out current view into a separate window

F10

Open the view menu of the current view

Alt+Left / Alt+Right

Navigate back / forward in views that keep navigation history

F11

Toggle full screen mode (desktop client)

Ctrl+W / Cmd+W

Close current view

F12

Open the Pinboard perspective

Cmd+,

Open the Configuration perspective (desktop client on macOS)

Tips for Daily Use

  • Start your day by checking the Alarms perspective for outstanding alarms

  • Use the Object Browser filter to quickly find specific nodes

  • Pin frequently accessed dashboards for quick access

  • Use predefined graphs on the Performance Tab for quick node health checks

  • Acknowledge alarms as you begin investigating them so other operators know the issue is being handled