69 lines
1.6 KiB
Markdown
69 lines
1.6 KiB
Markdown
|
# Troubleshooting Guide
|
||
|
|
|
||
|
|
**Last Updated**: 2025-01-27
|
||
|
|
**Status**: Active
|
||
|
|
|
||
|
|
This is a quick reference guide. For detailed troubleshooting procedures, see [runbooks/troubleshooting.md](../runbooks/troubleshooting.md).
|
||
|
|
|
||
|
|
> **Related Documentation**:
|
||
|
|
> - [Deployment Guide](../deployment/DEPLOYMENT.md) - Deployment instructions
|
||
|
|
> - [Architecture Documentation](../architecture/ARCHITECTURE.md) - System architecture
|
||
|
|
> - [Integration Guide](INTEGRATION_GUIDE.md) - Integration troubleshooting
|
||
|
|
|
||
|
|
## Quick Diagnostics
|
||
|
|
|
||
|
|
### Check Pod Status
|
||
|
|
```bash
|
||
|
|
kubectl get pods -n besu-network
|
||
|
|
```
|
||
|
|
|
||
|
|
### Check Logs
|
||
|
|
```bash
|
||
|
|
kubectl logs -n besu-network <pod-name> --tail=100
|
||
|
|
```
|
||
|
|
|
||
|
|
### Check Events
|
||
|
|
```bash
|
||
|
|
kubectl get events -n besu-network --sort-by='.lastTimestamp'
|
||
|
|
```
|
||
|
|
|
||
|
|
### Check Resource Usage
|
||
|
|
```bash
|
||
|
|
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](../runbooks/troubleshooting.md) for detailed procedures
|
||
|
|
- Review [FAQ](FAQ.md) for common questions
|
||
|
|
- Review monitoring dashboards
|
||
|
|
- Check logs in Loki
|
||
|
|
- Contact on-call engineer
|
||
|
|
- Escalate if needed
|
||
|
|
|
||
|
|
> **Related Documentation**:
|
||
|
|
> - [FAQ](FAQ.md) - Frequently asked questions
|
||
|
|
> - [Best Practices](BEST_PRACTICES.md) - Best practices for operations
|
||
|
|
|