Troubleshooting

When troubleshooting, stop the Azure IoT Hub Connector, set the log level to TRACE, and re-create the scenario that caused the issue. The log messages at the TRACE level can help you track down where and when the issue occurred.

The Connector loads and caches all configuration settings during startup. Any changes that you make to the configuration when troubleshooting are ignored until the Connector is restarted.

The following topics provide general categories of troubleshooting information and link to specific topics for scenarios and error messages:

Troubleshooting Scenarios and Error Messages
Category	Scenarios	Errors
Errors on Connector Startup		Error: Cannot find function GrantConnectorPermissions Error: Failed to initialize Azure IoT Hub Connector due to invalid configuration Error: Invalid service name: GetConfiguration Error: Unable to bootstrap required extensions Error Entity PlatformSubsystem does not exist or is not yet associated with a Thing Error: Unable to Invoke Service GetExtensionPackageList on PlatformSubsystem: Not authorized. Error Failed to initialize all the egress handlers: Shared Access KeyName cannot be null or empty
Troubleshooting Device-Related Issues	Scenarios: Device import fails or takes too long Scenarios: Troubleshooting AzureIotThings	Errors Caused by Device Deleted or Missing in Azure IoT
Troubleshooting Runtime Issues	Scenario: Logback is configured and file created, but nothing is written to file.	Error: The messaging entity <badconsumergroup> could not be found. Connector fails to consume ingress Errors: No Thing Found for name {THINGNAME} / Entity {THINGNAME} does not exist or is not yet associated with a Thing
Subscriptions	Scenario: Subscription Not Firing for Event on an Azure IoT Thing
Troubleshooting Connectivity Issues	Internet Connectivity What happens to updates sent during loss of connectivity between a Connector and a ThingWorx Platform?
Troubleshooting File Transfers	Scenario: A Configuration Change Is Not Working	File Transfer Event error when repository-thing=name Thing does not exist or implements wrong Thing Shape Error: Lost connection to File Notification Queue Error: Error retrieving file-upload notification Error: The client could not finish the operation within specified maximum execution timeout Error: Failed to initialize Azure IoT Hub Connector due to invalid configuration (Azure Blob Thing) Error: Unable to invoke service on Connection Services Hub: No Things are connected to handle request for service <serviceName> Error: Service has timed out Error: Unable to invoke service on Connection Services Hub: No Things are connected to handle request for service <serviceName> Error: Transfer did not complete within 60000 ms