Skip to content

DOCS-4171: Add troubleshooting for error when webrtc, mDNS, and gRPC fail #4742

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open

DOCS-4171: Add troubleshooting for error when webrtc, mDNS, and gRPC fail #4742

Changes from 3 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
9bc3d4d
Update common-errors.md
allisonschiang Nov 10, 2025
151e988
Update common-errors.md
allisonschiang Nov 11, 2025
cfe26f3
Update common-errors.md
allisonschiang Nov 11, 2025
d1da5ae
Update common-errors.md
allisonschiang Nov 11, 2025
ab2cc89
oops
allisonschiang Nov 11, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 24 additions & 14 deletions docs/dev/tools/common-errors.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 {#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.

**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`
Expand Down Expand Up @@ -296,7 +304,22 @@ 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

1. Check networking:

Expand Down Expand Up @@ -350,19 +373,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
Expand Down
Loading