Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion vendor/actors/docs/content/docs/debugging.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -199,7 +199,7 @@ Returns the configured provider settings per datacenter and the latest pool erro
}
```

`runner_pool_error` mirrors actor scheduling errors such as `serverless_http_error`, `serverless_connection_error`, and `serverless_stream_ended_early`.
`runner_pool_error` mirrors actor scheduling errors such as `serverless_http_error`, `serverless_connection_error`, `serverless_destination_blocked`, and `serverless_stream_ended_early`.

### Check Serverless Provider Health

Expand Down
16 changes: 16 additions & 0 deletions vendor/actors/docs/content/docs/troubleshooting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -97,6 +97,14 @@ Rivet was unable to connect to your serverless endpoint. Check that:
- Your server is publicly reachable from the internet.
- There are no DNS or firewall issues blocking the connection.

### `serverless_destination_blocked`

The configured serverless URL points at a destination Rivet is not allowed to reach. Rivet dials serverless endpoints from inside its own network, so by default it refuses any destination that is not publicly routable: private ranges, link-local and cloud metadata addresses, carrier-grade NAT, and other reserved ranges. Check that:

- Your endpoint URL is publicly reachable, and is not an internal hostname or address.
- The URL scheme is `http` or `https`, and the URL does not embed credentials.
- If you are self-hosting and intentionally point runners at an address on your own network, set `outbound.allow_private_networks` to `true` in your engine config, or list the specific range in `outbound.allow_cidrs`.

### `serverless_stream_ended_early`

The connection to your serverless endpoint was terminated before the actor finished. This usually means your serverless function hit its execution time limit. Ensure that your Rivet provider's request lifespan is configured to match the max duration of your serverless platform.
Expand All @@ -108,6 +116,14 @@ Rivet received an unexpected response from your serverless endpoint. This typica
- Your server routes requests to `registry.start()`, `registry.serve()`, or `registry.handler()` correctly.
- No middleware is modifying the request or response body.

### `serverless_destination_blocked`

The configured serverless URL points at a destination Rivet is not allowed to reach. Rivet dials serverless endpoints from inside its own network, so by default it refuses any destination that is not publicly routable: private ranges, link-local and cloud metadata addresses, carrier-grade NAT, and other reserved ranges. Check that:

- Your endpoint URL is publicly reachable, and is not an internal hostname or address.
- The URL scheme is `http` or `https`, and the URL does not embed credentials.
- If you are self-hosting and intentionally point runners at an address on your own network, set `outbound.allow_private_networks` to `true` in your engine config, or list the specific range in `outbound.allow_cidrs`.

### `internal_error`

An unexpected error occurred within Rivet. If this persists, please [contact support](https://rivet.dev/actors/docs).
Expand Down
Loading
Loading