From 9bc3d4d1b04dc33deab58ca6a60cd61ce2bc2abd Mon Sep 17 00:00:00 2001 From: Allison Chiang Date: Mon, 10 Nov 2025 17:39:11 -0500 Subject: [PATCH 1/6] Update common-errors.md --- docs/dev/tools/common-errors.md | 39 +++++++++++++++++++++------------ 1 file changed, 25 insertions(+), 14 deletions(-) diff --git a/docs/dev/tools/common-errors.md b/docs/dev/tools/common-errors.md index 42f0d32a6c..eef47a5742 100644 --- a/docs/dev/tools/common-errors.md +++ b/docs/dev/tools/common-errors.md @@ -213,6 +213,14 @@ resource build error: unknown resource type: API "rdk:component:camera" with mod 1. Check the logs for other errors. It may be that the instantiation of the model is failing, for other reasons such as the hardware being disconnected. +### Failed to connect to robot within time limit + +**Full Error:** `Failed to connect to robot within time limit. Check network connection and try again.` + +**Description:** This error occurs when the host fails to connect to the robot within the time limit + +**Solution:** See [Network Troubleshooting](/dev/tools/common-errors/#Network-Troubleshooting) section + ### Could not connect to machine part **Full Error:** `Could not connect to machine part: error updating resources: rpc error: code = ResourceExhausted desc = exceeded request limit 100 on resource viam.robot.v1.RobotService` @@ -296,8 +304,24 @@ If not, look for other related errors in your logs. **Description:** This error indicates a networking or connection issue. -**Solution:** +**Solution:** See [Network Troubleshooting](/dev/tools/common-errors/#Network-Troubleshooting) section + +### Unable to create PeerConnection with module + +**Full Warning:** `Unable to create PeerConnection with module. Ignoring.` + +**Description:** Indicates that while the gRPC connection to the module is working as expected, the connection to the module does not support efficient video streaming over WebRTC. +Only some Go-based camera modules support optimized video streaming over WebRTC. + +{{% hiddencontent %}} +You can use any Viam SDK to implement a camera module, but only Go-based modules can access optimized video streaming over WebRTC. +{{% /hiddencontent %}} +**Solution:** This warning can be safely ignored. + +## Network Troubleshooting + +**Steps:** 1. Check networking: 1. Check if your machine is showing as online on Viam and [check its logs](/manage/troubleshoot/troubleshoot/#check-logs). @@ -350,19 +374,6 @@ If not, look for other related errors in your logs. 1. If you have multiple tabs open with your machine's page, close all but one. Having too many connections can cause instability on some machines. -### Unable to create PeerConnection with module - -**Full Warning:** `Unable to create PeerConnection with module. Ignoring.` - -**Description:** Indicates that while the gRPC connection to the module is working as expected, the connection to the module does not support efficient video streaming over WebRTC. -Only some Go-based camera modules support optimized video streaming over WebRTC. - -{{% hiddencontent %}} -You can use any Viam SDK to implement a camera module, but only Go-based modules can access optimized video streaming over WebRTC. -{{% /hiddencontent %}} - -**Solution:** This warning can be safely ignored. - ## Known application and plugin conflicts ### macOS applications From 151e988a39018e6a5753d313b3479870c75579d1 Mon Sep 17 00:00:00 2001 From: Allison Chiang Date: Tue, 11 Nov 2025 10:38:17 -0500 Subject: [PATCH 2/6] Update common-errors.md --- docs/dev/tools/common-errors.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/dev/tools/common-errors.md b/docs/dev/tools/common-errors.md index eef47a5742..273c26a990 100644 --- a/docs/dev/tools/common-errors.md +++ b/docs/dev/tools/common-errors.md @@ -213,13 +213,13 @@ resource build error: unknown resource type: API "rdk:component:camera" with mod 1. Check the logs for other errors. It may be that the instantiation of the model is failing, for other reasons such as the hardware being disconnected. -### Failed to connect to robot within time limit +### Failed to connect to robot within time limit {#conn-time-out} **Full Error:** `Failed to connect to robot within time limit. Check network connection and try again.` -**Description:** This error occurs when the host fails to connect to the robot within the time limit +**Description:** This error occurs when the host fails to connect to the robot within the time limit. -**Solution:** See [Network Troubleshooting](/dev/tools/common-errors/#Network-Troubleshooting) section +**Solution:** See [Network Troubleshooting](/dev/tools/common-errors/#network-troubleshooting) section. ### Could not connect to machine part @@ -304,7 +304,7 @@ If not, look for other related errors in your logs. **Description:** This error indicates a networking or connection issue. -**Solution:** See [Network Troubleshooting](/dev/tools/common-errors/#Network-Troubleshooting) section +**Solution:** See [Network Troubleshooting](/dev/tools/common-errors/#network-troubleshooting) section ### Unable to create PeerConnection with module @@ -321,7 +321,6 @@ You can use any Viam SDK to implement a camera module, but only Go-based modules ## Network Troubleshooting -**Steps:** 1. Check networking: 1. Check if your machine is showing as online on Viam and [check its logs](/manage/troubleshoot/troubleshoot/#check-logs). From cfe26f340928b7cdf0b17cae865a59aa3a40bd71 Mon Sep 17 00:00:00 2001 From: Allison Chiang Date: Tue, 11 Nov 2025 10:46:33 -0500 Subject: [PATCH 3/6] Update common-errors.md --- docs/dev/tools/common-errors.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/dev/tools/common-errors.md b/docs/dev/tools/common-errors.md index 273c26a990..972ba2d756 100644 --- a/docs/dev/tools/common-errors.md +++ b/docs/dev/tools/common-errors.md @@ -304,7 +304,7 @@ If not, look for other related errors in your logs. **Description:** This error indicates a networking or connection issue. -**Solution:** See [Network Troubleshooting](/dev/tools/common-errors/#network-troubleshooting) section +**Solution:** See [Network Troubleshooting](/dev/tools/common-errors/#network-troubleshooting) section. ### Unable to create PeerConnection with module From d1da5aeee1eb6afea1748edf24135caacd97418f Mon Sep 17 00:00:00 2001 From: Allison Chiang Date: Tue, 11 Nov 2025 16:37:19 -0500 Subject: [PATCH 4/6] Update common-errors.md --- docs/dev/tools/common-errors.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/dev/tools/common-errors.md b/docs/dev/tools/common-errors.md index 972ba2d756..b99bc9af2c 100644 --- a/docs/dev/tools/common-errors.md +++ b/docs/dev/tools/common-errors.md @@ -4,6 +4,8 @@ linkTitle: "Common Errors" weight: 50 type: "docs" description: "A guide to troubleshooting a Viam-based machine or system of machines with fixes to common problems." +aliases: + - "/err/" date: "2022-01-01" no_list: true # updated: "" # When the content was last entirely checked @@ -240,7 +242,7 @@ To adjust the per-resource limit for modules, you can set the `VIAM_RESOURCE_REQ **Solution:** To adjust the initial app connection timeout, you can set the `VIAM_CONFIG_READ_TIMEOUT` [environment variable on your machine](/manage/reference/viam-agent/#environment-variables-for-viam-server) to a positive integer higher than the default, 15. -### exceeded request limit on resource +### exceeded request limit on resource {#req-limit-exceeded} **Full Error:** From ab2cc8937683d3df0bf03707d2a9eb3d4a267b55 Mon Sep 17 00:00:00 2001 From: Allison Chiang Date: Tue, 11 Nov 2025 16:38:01 -0500 Subject: [PATCH 5/6] oops --- docs/dev/tools/common-errors.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/dev/tools/common-errors.md b/docs/dev/tools/common-errors.md index b99bc9af2c..be6eb1c98c 100644 --- a/docs/dev/tools/common-errors.md +++ b/docs/dev/tools/common-errors.md @@ -4,8 +4,6 @@ linkTitle: "Common Errors" weight: 50 type: "docs" description: "A guide to troubleshooting a Viam-based machine or system of machines with fixes to common problems." -aliases: - - "/err/" date: "2022-01-01" no_list: true # updated: "" # When the content was last entirely checked From 52a3275517b45ab731fefe698458d0bdc54285f9 Mon Sep 17 00:00:00 2001 From: Allison Chiang Date: Fri, 21 Nov 2025 21:41:23 -0800 Subject: [PATCH 6/6] update full error --- docs/dev/tools/common-errors.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/dev/tools/common-errors.md b/docs/dev/tools/common-errors.md index be6eb1c98c..52ba66bdc5 100644 --- a/docs/dev/tools/common-errors.md +++ b/docs/dev/tools/common-errors.md @@ -215,7 +215,7 @@ resource build error: unknown resource type: API "rdk:component:camera" with mod ### Failed to connect to robot within time limit {#conn-time-out} -**Full Error:** `Failed to connect to robot within time limit. Check network connection and try again.` +**Full Error:** `failed to connect to machine within time limit. check network connection, whether the viam-server is running, and try again. see https://docs.viam.com/dev/tools/common-errors/#conn-time-out for troubleshooting steps` **Description:** This error occurs when the host fails to connect to the robot within the time limit.