Inspecting Collector connection status

For the whole Nexthink solution to work properly, it is essential that the Collector instances can communicate with their target Nexthink Appliances. To easily determine the status of the connection between a Collector and its assigned Nexthink Appliance, Collector registers all connection attempts in the standard log of the underlying operating system.

  • Collector for Windows writes the messages to the Windows Event log.

  • Collector for macOS writes the messages to the system log.

Connection messages

When writing log messages to the Windows Event Log, Collector for Windows classifies the messages as Application logs and always tags them with the same source and task category:

Source Nexthink Collector.

Task Category Connection events.

The table below contains the complete list of messages and the other tags that the Collectors, both Windows and macOS, can write to the log. The parts of the message in italics are replaced by actual data:

MessageLevel (Windows)Event ID (Windows)Process (macOS)Type (macOS)

Connection to Nexthink Appliance has been established [appliance host: host_name:port][resolved appliance IP: ip_address]

Information

259

nxtcoordinator

Info

Connection to Nexthink Appliance can not be established: TCP connection failure: error [appliance host: host_name:port][resolved appliance IP: ip_address]

Error

256

nxtcoordinator

Error

Connection to Nexthink Appliance can not be established: Protocol error [appliance host: host_name:port][resolved appliance IP: ip_address]

Error

256

nxtcoordinator

Error

Connection to Nexthink Appliance can not be established: Websocket error: Certificate issue [appliance host: host_name:port][resolved appliance IP: ip_address]

Error

256

nxtcoordinator

Error

Connection to Nexthink Appliance can not be established: Websocket error: Host not found [appliance host: host_name:port][resolved appliance IP: ip_address]

Error

256

nxtcoordinator

Error

Connection to Nexthink Appliance can not be established: Websocket error: error [appliance host: host_name:port][resolved appliance IP: ip_address]

Error

256

nxtcoordinator

Error

The Nexthink Appliance URL does not have a valid format [appliance host: host_name:port][resolved appliance IP: ip_address]

Error

256

nxtcoordinator

Error

Received an error message from Nexthink Appliance: error_code error message. Message content: error_message

Error

256

nxtcoordinator

Error

Failed to send data, size data_size ; WSAGetLastError: error [appliance host: host_name:port][resolved appliance IP: ip_address]

Error

256

nxtcoordinator

Error

Failed to create socket with preferIpv6ForHost [ip_address]. Reason: error [appliance host: host_name:port][resolved appliance IP: ip_address]

Warning

257

nxtsvc

Warning

Last updated