1.6 KiB
1.6 KiB
Troubleshooting Guide
Last Updated: 2025-01-27
Status: Active
This is a quick reference guide. For detailed troubleshooting procedures, see runbooks/troubleshooting.md.
Related Documentation:
- Deployment Guide - Deployment instructions
- Architecture Documentation - System architecture
- Integration Guide - Integration troubleshooting
Quick Diagnostics
Check Pod Status
kubectl get pods -n besu-network
Check Logs
kubectl logs -n besu-network <pod-name> --tail=100
Check Events
kubectl get events -n besu-network --sort-by='.lastTimestamp'
Check Resource Usage
kubectl top pods -n besu-network
kubectl top nodes
Common Issues
Blocks Not Being Produced
- Check validator status
- Check network connectivity
- Verify validator keys
- Check QBFT configuration
RPC Endpoints Not Responding
- Check RPC pod status
- Check Application Gateway
- Verify network policies
- Check rate limiting
Oracle Not Updating
- Check oracle publisher status
- Verify data sources
- Check RPC connectivity
- Verify private key access
Getting Help
- Check runbooks/troubleshooting.md for detailed procedures
- Review FAQ for common questions
- Review monitoring dashboards
- Check logs in Loki
- Contact on-call engineer
- Escalate if needed
Related Documentation:
- FAQ - Frequently asked questions
- Best Practices - Best practices for operations