Skip to content

Commit e031ba5

Browse files
authored
Merge pull request #218830 from PatAltimore/patricka-troubleshoot
Categorize common errors
2 parents bed1f12 + cf36f3e commit e031ba5

File tree

3 files changed

+261
-220
lines changed

3 files changed

+261
-220
lines changed

articles/azure-video-analyzer/video-analyzer-docs/edge/troubleshoot.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -92,9 +92,9 @@ If you've run all the preceding checks and are still encountering issues, gather
9292

9393
Video Analyzer edge module works collaboratively with the IoT Edge agent and hub modules. Some of the common errors that you'll encounter with its deployment are caused by issues with the underlying IoT infrastructure. The errors include:
9494

95-
- [The IoT Edge agent stops after about a minute](../../../iot-edge/troubleshoot-common-errors.md#iot-edge-agent-stops-after-about-a-minute).
95+
- [IoT Edge agent stops after a minute](../../../iot-edge/troubleshoot-common-errors.md#iot-edge-agent-stops-after-a-minute).
9696
- [The IoT Edge agent can't access a module's image (403)](../../../iot-edge/troubleshoot-common-errors.md#iot-edge-agent-cant-access-a-modules-image-403).
97-
- [The IoT Edge agent module reports "empty config file" and no modules start on the device](../../../iot-edge/troubleshoot-common-errors.md#edge-agent-module-reports-empty-config-file-and-no-modules-start-on-the-device).
97+
- [Edge Agent module reports 'empty config file' and no modules start on the device](../../../iot-edge/troubleshoot-common-errors.md#edge-agent-module-reports-empty-config-file-and-no-modules-start-on-the-device).
9898
- [The IoT Edge hub fails to start](../../../iot-edge/troubleshoot-common-errors.md#iot-edge-hub-fails-to-start).
9999
- [The IoT Edge security daemon fails with an invalid hostname](../../../iot-edge/troubleshoot-common-errors.md#iot-edge-security-daemon-fails-with-an-invalid-hostname).
100100
- [The Video Analyzer or any other custom IoT Edge module fails to send a message to the edge hub with 404 error](../../../iot-edge/troubleshoot-common-errors.md#iot-edge-module-fails-to-send-a-message-to-edgehub-with-404-error).
@@ -131,7 +131,7 @@ Using pipeline extension processors you can extend the pipeline to send and rece
131131
> [!TIP]
132132
> Use **[Docker inspect command](https://docs.docker.com/engine/reference/commandline/inspect/)** to find the IP address of the machine.
133133
134-
- If you're running one or more live pipelines that uses the pipeline extension processor, you should use the `samplingOptions` field to manage the frames per second (fps) rate of the video feed.
134+
- If you're running one or more live pipelines that use the pipeline extension processor, you should use the `samplingOptions` field to manage the frames per second (fps) rate of the video feed.
135135

136136
- In certain situations, where the CPU or memory of the edge machine is highly utilized, you can lose certain inference events. To address this issue, set a low value for the `maximumSamplesPerSecond` property on the `samplingOptions` field. You can set it to 0.5 ("maximumSamplesPerSecond": "0.5") on each instance of the pipeline and then re-run the instance to check for inference events on the hub.
137137

@@ -156,14 +156,14 @@ To gather the relevant logs that should be added to the ticket, follow the instr
156156
1. [Turn on Debug Logs](#video-analyzer-edge-module-debug-logs)
157157
1. Reproduce the issue
158158
1. Restart the Video Analyzer edge module.
159-
> [!NOTE]
160-
> This step is required to gracefully terminate the edge module and get all log files in a usable format without dropping any events.
161-
162-
On the IoT Edge device, use the following command after replacing `<avaedge>` with the name of your Video Analyzer edge module:
163-
164-
```cmd
165-
sudo iotedge restart <avaedge>
166-
```
159+
> [!NOTE]
160+
> This step is required to gracefully terminate the edge module and get all log files in a usable format without dropping any events.
161+
162+
On the IoT Edge device, use the following command after replacing `<avaedge>` with the name of your Video Analyzer edge module:
163+
164+
```cmd
165+
sudo iotedge restart <avaedge>
166+
```
167167
168168
You can also restart modules remotely from the Azure portal. For more information, see [Monitor and troubleshoot IoT Edge devices from the Azure portal](../../../iot-edge/troubleshoot-in-portal.md).
169169
1. Connect to the virtual machine from the **IoT Hub** page in the portal
@@ -250,7 +250,7 @@ To configure the Video Analyzer edge module to generate debug logs, do the follo
250250

251251
[Monitoring and logging](monitor-log-edge.md) should help in understanding the taxonomy and how to generate logs that will help in debugging issues with Video Analyzer.
252252

253-
As gRPC server implementation differ across languages, there is no standard way of adding logging inside in the server.
253+
As gRPC server implementation differs across languages, there is no standard way of adding logging inside in the server.
254254

255255
As an example, if you build a gRPC server using .NET core, gRPC service adds logs under the **Grpc** category. To enable detailed logs from gRPC, configure the Grpc prefixes to the Debug level in your appsettings.json file by adding the following items to the LogLevel sub-section in Logging:
256256

articles/iot-edge/offline-capabilities.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ One way to create this trust relationship is described in detail in the followin
9696

9797
## Specify DNS servers
9898

99-
To improve robustness, it is highly recommended you specify the DNS server addresses used in your environment. To set your DNS server for IoT Edge, see the resolution for [Edge Agent module continually reports 'empty config file' and no modules start on device](troubleshoot-common-errors.md#edge-agent-module-reports-empty-config-file-and-no-modules-start-on-the-device) in the troubleshooting article.
99+
To improve robustness, it is highly recommended you specify the DNS server addresses used in your environment. To set your DNS server for IoT Edge, see the resolution for [Edge Agent module reports 'empty config file' and no modules start on the device](troubleshoot-common-errors.md#edge-agent-module-reports-empty-config-file-and-no-modules-start-on-the-device) in the troubleshooting article.
100100

101101
## Optional offline settings
102102

0 commit comments

Comments
 (0)