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:

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 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