Log Messages
The Azure IoT Hub Connector provides the following operational logging messages:
Message
Description
Azure IoT Protocol Adapter started
The Azure IoT Hub Adapter component started successfully.
Unable to connect to Azure IoT Hub endpoint
The Azure IoT Hub Connector failed to start successfully.
successful
The egress handler of the Azure IoT Hub Connector started successfully.
failed
The egress handler of the Azure IoT Hub Connector failed to start.
Unexpected error occurred while consuming a message: partitionId=ID" + stacktrace
The Azure IoT Hub Connector encountered an error while handling a message from the Azure IoT Hub.
Error handling egress property write
The Azure Iot Hub Connector encounter an error while handling a property write to the Azure IoT Hub.
To assist you in understanding the error and warning messages that may be generated, the following tables list the two types of operational log messages and provide possible causes and actions to take.
* 
When connection server appears in a log message, it refers to the Azure IoT Hub Connector.
Warning Messages
Logger Name
Message
Probable Cause
Action to Take
com.thingworx.connection
server.metrics.
MetricsReporterManager
Metrics are enabled but no reporters are configured.
The metrics are enabled in the configuration file, but no metrics reporters were configured. No metrics are reported.
Enable the metrics reporter in the configuration file and restart the Azure IoT Hub Connector.
com.thingworx.connection
server.metrics.
MetricsReporterManager
Graphite metrics reporter enabled without service discovery but no endpoints are configured.
No explicit endpoint has been defined in the configuration file. No metrics are reported to Graphite.
Define the endpoint in the configuration file and restart the Azure IoT Hub Connector.
com.thingworx.fabric.impl.
AbstractManyPlatform
WebSocketFabric
Platform still alive, so not removing: endpoint={}
The Azure IoT Hub Connector received a notification that ThingWorx is no longer available, but the Azure IoT Hub Connector is still connected to that ThingWorx instance.
Verify whether ThingWorx specified is still available.
Error Messages
Logger Name
Message
Probable Cause
Action to Take
com.thingworx.connection
server.
ConnectionServer
Unable to start connection server
The Azure IoT Hub Connector encountered an error that prevented it from starting up. The exception appears after the log message.
Resolve the issue mentioned in the exception and restart the Azure IoT Hub Connector.
com.thingworx.connection
server.metrics.
MetricsReporterManager
Unable to create stream for metrics console reporter, defaulting to standard-out: intended file={}
The file specified for the metrics console reporter could not be created. The exception appears after the log message. The Azure IoT Hub Connector will continue functioning, but the metrics are written to standard out rather than the intended metrics file. The output file is specified in the configuration file at the following key: cx-server.metrics.reporters.console.outfile.
Fix the underlying issue specified in the exception, and restart the Azure IoT Hub Connector. Possible causes are non-existent base directories and permissions issues.
com.thingworx.connection
server.metrics.
MetricsReporterManager
Unable to create directory for metrics CSV reporter, disabling reporter: directory={}
The directory specified for the metrics CSV reporter could not be created. The exception appears after the log message. The Azure IoT Hub Connector continues to operate, but the CSV metrics reporter is disabled. If the CSV metrics reporter is the only configured reporter, no metrics information is available.
Fix the underlying issue specified in the exception and restart the Azure IoT Hub Connector. Possible causes are base directories not existing and permissions issues.
com.thingworx.fabric.
impl.Abstract
ManyPlatform
WebSocketFabric
Failure while connecting to platform: endpoint={}
The connection attempt to ThingWorx failed. The exception appears after the log message. The Azure IoT Hub Connector will not start.
Resolve the issue mentioned in the exception and restart the Azure IoT Hub Connector. Possible causes are:
The wrong ThingWorx endpoint (host/port) is specified in the configuration.
The ThingWorx Platform instance is not accessible over the network from the Azure IoT Hub Connector.
The ThingWorx Platform instance is not running
.