Skip to content
Open
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
31 changes: 31 additions & 0 deletions docs/LOCAL_LOGGING_TROUBLESHOOTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# Local Logging & Troubleshooting Guide

This document describes a few small helpers for working with a local Base node.

## 1. Check running services

To see which services are up, run:

docker compose ps

This helps you confirm that the node and execution clients are running.

## 2. Tail node logs

Use the helper script to follow logs:

./scripts/tail_node_logs.sh

Or tail a specific service only (for example, the op-node):

./scripts/tail_node_logs.sh op-node

## 3. Quick RPC health check

You can verify that the JSON-RPC endpoint is responding with a simple script:

./scripts/check_node_health.sh
./scripts/check_node_health.sh http://localhost:8545

If the script prints a latest block number, your node is responding to `eth_blockNumber`.
If it reports an HTTP error or empty result, check your environment variables and Docker logs.