Skip to content

Commit

Permalink
chore: add pb runner troubleshooting (#1432)
Browse files Browse the repository at this point in the history
<!-- Please make sure there is an issue that this PR is correlated to. -->

## Changes

<!-- If there are frontend changes, please include screenshots. -->
  • Loading branch information
NathanFlurry committed Nov 22, 2024
1 parent ad50f4a commit a9db3de
Showing 1 changed file with 39 additions and 0 deletions.
39 changes: 39 additions & 0 deletions docs-internal/infrastructure/pegboard/TROUBLESHOOTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# Troubleshooting

## Where are pegboard-manager logs?

```bash
cat /var/lib/rivet-client/logs
```

## Where are rivet-isolate-v8-runner logs?

```bash
cat /var/lib/rivet-client/runner/logs
```

## Why don't my runner logs exist?

If there are no logs at `/var/lib/rivet-client/runner/logs`, the runner binary likely failed to spawn.

Common causes:

- The path to the binary is incorrect
- Error loading libraries
- The binary is not set as executable
- The binary is for the wrong architecture

Trying to manually find and run the binary usually resolves these issues.

## Getting logs of crashed client in Docker

If the container crashes, the logs have to be extracted from the volume.

If log redirection is enabld (you'll see the log `Redirecting all logs to /var/lib/rivet-client/log`), the logs have to be extracted from the volume since the container is down.

For example, to read the log from the volume `dev-full_client-data`, run this:

```bash
docker run --rm -it -v dev-full_client-data:/var/lib/rivet-client busybox cat /var/lib/rivet-client/log
```

0 comments on commit a9db3de

Please sign in to comment.