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