Service backend down

Problème 1 : PHP-FPM down

C’est la cause la plus fréquente de 502/503 quand Nginx fonctionne.

Diagnostic

# État du service
$ systemctl status php8.2-fpm
● php8.2-fpm.service - The PHP 8.2 FastCGI Process Manager
     Active: failed (Result: exit-code) ❌
     Process: 1234 ExecStart=... (code=exited, status=78)

# Logs détaillés
$ journalctl -u php8.2-fpm -n 50 --no-pager

# Logs PHP-FPM
$ tail -50 /var/log/php8.2-fpm.log

Erreurs courantes et solutions

Erreur : « unable to bind listening socket »

$ journalctl -u php8.2-fpm | grep "bind"
unable to bind listening socket for address '/run/php/php8.2-fpm.sock'

Cause : Le socket existe déjà (crash précédent) ou permissions incorrectes.

Solution :

$ rm -f /run/php/php8.2-fpm.sock
$ systemctl start php8.2-fpm

Erreur : « pm.max_children reached »

$ grep "max_children" /var/log/php8.2-fpm.log
WARNING: [pool www] server reached pm.max_children setting (5)

Cause : Tous les workers PHP sont occupés, les nouvelles requêtes sont refusées.

Solution : Augmenter pm.max_children dans la config du pool :

pm = dynamic
pm.max_children = 50      ; Augmenter selon RAM disponible
pm.start_servers = 10
pm.min_spare_servers = 5
pm.max_spare_servers = 20

Erreur : « OOM killer » (Out Of Memory)

$ dmesg | grep -i "killed process"
[12345.678] Out of memory: Killed process 9876 (php-fpm)

Cause : Le serveur manque de RAM, le kernel tue PHP-FPM pour survivre.

Solution :

• Réduire pm.max_children
• Ajouter de la RAM
• Optimiser la consommation mémoire des scripts

Redémarrage et vérification

# Redémarrer PHP-FPM
$ systemctl restart php8.2-fpm

# Vérifier qu'il tourne
$ systemctl status php8.2-fpm
● php8.2-fpm.service
     Active: active (running) ✅
     
# Vérifier que le socket existe
$ ls -la /run/php/php8.2-fpm.sock
srw-rw---- 1 www-data www-data 0 Dec 26 14:30 /run/php/php8.2-fpm.sock

# Tester une page PHP
$ curl -I https://monsite.com
HTTP/1.1 200 OK ✅

Problème 3 : Problème de socket / communication

Nginx et PHP-FPM communiquent via un socket Unix ou un port TCP. Si la configuration ne correspond pas, 502/503.

Vérifier la configuration Nginx

$ grep -r "fastcgi_pass" /etc/nginx/
/etc/nginx/sites-available/monsite.conf:    fastcgi_pass unix:/run/php/php8.2-fpm.sock;

Vérifier la configuration PHP-FPM

$ grep "listen" /etc/php/8.2/fpm/pool.d/www.conf
listen = /run/php/php8.2-fpm.sock

Les deux doivent correspondre !

Vérifier que le socket existe et est accessible

$ ls -la /run/php/php8.2-fpm.sock
srw-rw---- 1 www-data www-data 0 Dec 26 14:30 /run/php/php8.2-fpm.sock

# L'utilisateur Nginx doit pouvoir y accéder
$ ps aux | grep nginx
www-data  1234  ... nginx: worker process
# ✅ Nginx tourne en www-data, qui est propriétaire du socket

Configuration correcte

[www]
user = www-data
group = www-data

listen = /run/php/php8.2-fpm.sock
listen.owner = www-data
listen.group = www-data
listen.mode = 0660

location ~ \\.php$ {
    fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
    
    # Timeouts (évite les 504)
    fastcgi_read_timeout 300;
    fastcgi_send_timeout 300;
}

Script de diagnostic complet

#!/bin/bash
# Script de diagnostic des services backend

echo "=== DIAGNOSTIC BACKEND ==="
echo ""

# Fonction de check
check_service() {
    local service=$1
    local name=$2
    
    if systemctl is-active --quiet $service; then
        echo "✅ $name : OK"
    else
        echo "❌ $name : DOWN"
        echo "   → systemctl start $service"
    fi
}

# Vérifier les services
check_service nginx "Nginx"
check_service php8.2-fpm "PHP-FPM"
check_service mysql "MySQL"
check_service redis-server "Redis"

echo ""
echo "=== RESSOURCES ==="

# RAM
free -h | awk 'NR==2{printf "RAM: %s / %s (%.1f%% utilisé)\
", $3, $2, $3/$2*100}'

# Disque
df -h / | awk 'NR==2{printf "Disque: %s / %s (%s utilisé)\
", $3, $2, $5}'

# Load
echo "Load: $(uptime | awk -F'load average:' '{print $2}')"

echo ""
echo "=== CONNEXIONS ==="

# Connexions MySQL
mysql -u root -pPASSWORD -e "SELECT COUNT(*) as 'MySQL connexions' FROM information_schema.processlist;" 2>/dev/null || echo "MySQL: impossible de se connecter"

# Workers PHP
echo "PHP-FPM workers: $(ps aux | grep 'php-fpm: pool' | wc -l)"

echo ""
echo "=== ERREURS RECENTES ==="
echo "-- PHP-FPM --"
tail -5 /var/log/php8.2-fpm.log 2>/dev/null | grep -i error || echo "Aucune erreur récente"

echo "-- MySQL --"
tail -5 /var/log/mysql/error.log 2>/dev/null | grep -i error || echo "Aucune erreur récente"

echo ""
echo "=== FIN DIAGNOSTIC ==="

$ chmod +x /usr/local/bin/check-backend.sh
$ check-backend.sh

Automatiser le redémarrage des services

Avec systemd (service auto-restart)

[Service]
Restart=on-failure
RestartSec=5s

$ systemctl daemon-reload
$ systemctl restart php8.2-fpm

Avec un script cron de surveillance

#!/bin/bash
# Redémarre automatiquement les services down

restart_if_dead() {
    local service=$1
    if ! systemctl is-active --quiet $service; then
        echo "$(date): $service down, redémarrage..." >> /var/log/backend-watch.log
        systemctl restart $service
    fi
}

restart_if_dead php8.2-fpm
restart_if_dead mysql
restart_if_dead redis-server

# Cron toutes les minutes
$ crontab -e
* * * * * /usr/local/bin/watch-backend.sh