Inspecting the connection status of the Collector

Overview

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

The Windows Collector writes the messages to the Windows Event log.
The Mac Collector writes the messages to the system log.

Connection messages

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

Source

Nexthink Collector.

Task Category

Connection events.

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

Message	Level (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 UDP packet [appliance host: host_name:port][resolved appliance IP: ip_address]	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