# 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
