Skip to main content

​
Overview

Comprehensive troubleshooting guide for diagnosing and resolving UltraBalancer issues.

Common Issues

Frequently encountered problems

Debug Logs

Interpreting log output

Performance

Performance degradation

Network

Connectivity problems

​
Common Issues

​
Service Won’t Start

Cause: Ports below 1024 require elevated privilegesSolution:
# Option 1: Use setcap
sudo setcap 'cap_net_bind_service=+ep' /usr/local/bin/ultrabalancer

# Option 2: Run with sudo
sudo ultrabalancer -c config.yaml

# Option 3: Use unprivileged port
ultrabalancer -p 8080 -c config.yaml
Solution:
# Use absolute path
ultrabalancer -c /etc/ultrabalancer/config.yaml

# Verify file exists
ls -la /etc/ultrabalancer/config.yaml

# Check permissions
sudo chmod 644 /etc/ultrabalancer/config.yaml

​
Connection Issues

Debug:
# Test backend connectivity
curl http://backend1:8080

# Check DNS resolution
nslookup backend1

# Test network path
traceroute backend1

# Check firewall
sudo iptables -L
telnet backend1 8080

​
Debug Mode

# Enable verbose logging
ultrabalancer -c config.yaml --log-level debug

# Maximum verbosity
ultrabalancer -c config.yaml --log-level trace

Configuration

Configuration reference

Monitoring

Monitor metrics