investigate
Investigate Ethereum Network Issues
This skill routes to the appropriate debugging runbook based on whether the target is a local Kurtosis devnet or a remote hosted deployment.
The user MUST specify which network to debug. If not provided, ask them.
Step 1: Detect local vs remote
Run both checks in parallel:
# Check for local Kurtosis enclaves
kurtosis enclave ls 2>/dev/null
# Check for remote datasources via panda
panda datasources --json 2>/dev/null
Step 2: Route to the right runbook
-
If the target network matches a Kurtosis enclave name → local devnet. Load the local debugging procedure:
panda search runbooks "debug local devnet"Then follow that runbook. It covers Kurtosis service discovery, local Dora/Loki detection (localhost:3100), direct CL/EL API queries, Kurtosis-specific Loki label schema, and
kurtosis service logsfallback. -
If the target network is found in panda datasources (Dora networks, Loki instances) → remote deployment. Load the remote debugging procedure:
panda search runbooks "debug devnet"Then follow that runbook. It covers remote datasource discovery, Dora data collection, remote Loki log investigation, and ethnode RPC validation.
-
If found in neither → stop, tell the user the network was not found in any local enclave or remote datasource.
Notes
- The runbooks are the source of truth for each debugging path — this skill only routes to them.
- Both runbooks use
panda search examplesfor query patterns — search before writing complex queries from scratch. - Both runbooks produce a debug report file at
/workspace/— provide the path to the user at the end.
More from ethpandaops/panda
query
Query Ethereum network data via ethpandaops CLI or MCP server. Use when analyzing blockchain data, block timing, attestations, validator performance, network health, or infrastructure metrics. Provides access to ClickHouse (blockchain data), Prometheus (metrics), Loki (logs), and Dora (explorer APIs).
5self-play
Run schema probing self-play loop to find and fix ClickHouse schema ambiguity in the panda repo. Use when the user wants to improve query reliability by finding where the agent picks different tables for the same question.
3install-mcp
>-
3install-panda
>-
2create-runbook
Extract a reusable runbook from a successful investigation or troubleshooting session. Use after completing a multi-step diagnosis that could help future investigations.
1create-module
Add a new datasource module to ethpandaops/panda. Triggers on: add module, new module, create module, add plugin, new plugin, create plugin, add datasource.
1