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

Merged
merged 6 commits into from
Nov 22, 2025
Merged

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

Changes from all commits
Commits
Show all changes
6 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
52a3275
update full error
allisonschiang Nov 22, 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
40 changes: 25 additions & 15 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 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.

**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 All @@ -232,7 +240,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:**

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