Share via

Troubleshoot Azure Percept Vision and vision modules


Retirement of Azure Percept DK:

Update 22 February 2023: A firmware update for the Percept DK Vision and Audio accessory components (also known as Vision and Audio SOM) is now available here, and will enable the accessory components to continue functioning beyond the retirement date.

The Azure Percept public preview will be evolving to support new edge device platforms and developer experiences. As part of this evolution the Azure Percept DK and Audio Accessory and associated supporting Azure services for the Percept DK will be retired March 30th, 2023.

Effective March 30th, 2023, the Azure Percept DK and Audio Accessory will no longer be supported by any Azure services including Azure Percept Studio, OS updates, containers updates, view web stream, and Custom Vision integration. Microsoft will no longer provide customer success support and any associated supporting services. For more information, please visit the Retirement Notice Blog Post.

This article provides information on troubleshooting no-code vision solutions in Azure Percept Studio.

Delete a vision project

  1. Go to the Custom Vision projects page.

  2. Hover over the project you want to delete, and select the trash can icon to delete the project.

    Screenshot that shows the Projects page in Custom Vision with the delete icon highlighted.

Check which modules are on a device

  1. Go to the Azure portal.

  2. Select the Iot Hub icon.

    Screenshot that shows the Azure portal home page with the Iot Hub icon highlighted.

  3. Select the IoT hub that your target device is connected to.

    Screenshot that shows a list of IoT hubs.

  4. Select IoT Edge, and select your device under the Device ID tab.

    Screenshot that shows the IoT Edge home page.

  5. Your device modules appear in a list on the Modules tab.

    Screenshot that shows the IoT Edge page for the selected device showing the Modules tab contents.

Delete a device

  1. Go to the Azure portal.

  2. Select the Iot Hub icon.

  3. Select the IoT hub that your target device is connected to.

  4. Select IoT Edge, and select the checkbox next to your target device ID. Select Delete to delete your device.

    Screenshot that shows the Delete button highlighted on the IoT Edge home page.

Check the runtime status of azureeyemodule

If there's a problem with WebStreamModule, ensure that azureeyemodule, which handles the vision model inferencing, is running. To check the runtime status:

  1. Go to the Azure portal, and go to All resources > <your IoT hub> > IoT Edge > <your device ID>.

  2. Select the Modules tab to see the runtime status of all installed modules.

    Screenshot that shows the device module runtime status screen.

  3. If the runtime status of azureeyemodule isn't listed as running, select Set modules > azureeyemodule.

  4. On the Module Settings page, set Desired Status to running, and select Update.

    Screenshot that shows the Module Settings configuration screen.

Change how often messages are sent from the azureeyemodule

Your subscription tier may cap the number of messages that can be sent from your device to IoT Hub. For instance, the Free Tier will limit the number of messages to 8,000 per day. Once that limit is reached, your azureeyemodule will stop functioning and you may receive this error:

Error message
Total number of messages on IotHub 'xxxxxxxxx' exceeded the allocated quota. Max allowed message count: '8000', current message count: 'xxxx'. Send and Receive operations are blocked for this hub until the next UTC day. Consider increasing the units for this hub to increase the quota.

Using the azureeyemodule module twin, it's possible change the interval rate for how often messages are sent. The value entered for the interval rate indicates the frequency that each message gets sent, in milliseconds. The larger the number the more time there is between each message. For example, if you set the interval rate to 12,000 it means one message will be sent every 12 seconds. For a model that is running for the entire day this rate factors out to 7,200 messages per day, which is under the Free Tier limit. The value that you choose depends on how responsive you need your vision model to be.


Changing the message interval rate does not impact the size of each message. The message size depends on a few different factors such as the model type and the number of objects being detected in each message. As such, it is difficult to determine message size.

Follow these steps to update the message interval:

  1. Sign in to the Azure portal, and open All resources.

  2. On the All resources page, select the name of the IoT hub that was provisioned to your development kit during setup.

  3. On the left side of the IoT Hub page, under Automatic Device Management, select IoT Edge. On the IoT Edge devices page, find the device ID of your development kit. Select the device ID of your development kit to open its IoT Edge device page.

  4. On the Modules tab, select azureeyemodule.

  5. On the azureeyemodule page, open Module Identity Twin.

    Screenshot of a module page.

  6. Scroll down to properties

  7. Find TelemetryInterval and replace it with TelemetryIntervalNeuralNetworkMs

    Screenshot of Module Identity Twin properties.

  8. Update the TelemetryIntervalNeuralNetworkMs value to the needed value

  9. Select the Save icon.

View device RTSP video stream

View your device's RTSP video stream in Azure Percept Studio or VLC media player.

To open the RTSP stream in VLC media player, go to Media > Open network stream > rtsp://[device IP address]:8554/result.

If your RTSP stream is partially blocked by a gray box, you may be trying to view it over a poor network connection. Check that your connection has sufficient bandwidth for video streams.

Next steps

For more information on troubleshooting your Azure Percept DK instance, see the General troubleshooting guide.