Querying the Collector TCP connection status
Windows Collector
To query the status of the TCP connection between the Collector and the Nexthink instance for a particular device, run the Collector Configuration Tool on the device as follows:
nxtcfg.exe /g tcp_status
The Collector Configuration Tool queries the Nexthink Coordinator service, which is the component of the Collector that is responsible for the TCP connection.
Mac Collector
To query the status of the TCP connection between the Mac Collector and the Appliance, open the command-line interface on your macOS device and type in:
grep -i "tcp-status" /Library/Application\ Support/Nexthink/config.json
Error messages
The following table shows the possible output messages along with their description. The messages that start with a timestamp are retrieved from the Coordinator service. On the other hand, messages that start without a date come directly from the Collector Configuration Tool:
Message | Definition |
---|---|
[ERROR] Nexthink Coordinator service is not installed | The Coordinator is not found in the device. No TCP connection is established. |
[ERROR] Nexthink Coordinator service can not be queried | The Coordinator is momentarily not able to respond to the query. |
[ERROR] Unknown | There was an unknown error while trying to get the status of the TCP connection from the Coordinator. |
[INFO] Nexthink Coordinator service is stopped | The Coordinator service is installed but not running. No TCP connection is established. |
[MM/DD/YY hh:mm:ss] [INFO] Initializing connection | The Coordinator is starting and attempting to establish a TCP connection with the Appliance. |
[MM/DD/YY hh:mm:ss] [INFO] Connected | The Coordinator established a TCP connection with the Appliance. |
[MM/DD/YY hh:mm:ss] [INFO] Disconnected | The Coordinator was disconnected from the Appliance and is actively waiting for a new assignment. |
[MM/DD/YY hh:mm:ss] [ERROR] Protocol failure | There is a version mismatch between the Collector and the Appliance. |
[MM/DD/YY hh:mm:ss] [ERROR] Customer Key issue | There is a mismatch between the Customer Key in the Collector and that of the Appliance. |
[MM/DD/YY hh:mm:ss] [ERROR] Certificate issue | There is an issue with the certificate validation. Probable causes:
|
[MM/DD/YY hh:mm:ss] [ERROR] Host not found | The DNS name or IP address of the Appliance configured in the Collector designates a host that is not found in the network. |
[MM/DD/YY hh:mm:ss] [ERROR] TCP connection failure:<number> | Returns an error code from the underlying implementation that indicates the reason for the failure. The most common error is [ERROR] TCP connection failure: 0. It indicates that the host exists, but the Collector cannot connect to the indicated TCP port. |
Last updated