Dans ce tutoriel, nous allons vous montrer comment afficher les fichiers journaux Nginx sur Linux. Pour ceux d’entre vous qui ne le savaient pas, lors de la gestion des serveurs Web Nginx, l’une des tâches les plus fréquentes que vous effectuerez est de vérifier les fichiers journaux. La journalisation Nginx pour vous aider à dépanner et à résoudre rapidement tout problème que vous pourriez rencontrer sur votre serveur Web Nginx. La journalisation est un outil très puissant qui vous donnera des données précieuses sur toutes les opérations de votre serveur. Nginx écrit des enregistrements de ses événements dans deux types de journaux : les journaux d’accès et les journaux d’erreurs. Les journaux d’accès écrivent des informations sur les demandes des clients et les journaux d’erreurs écrivent des informations sur les problèmes de serveur et d’application.
Cet article suppose que vous avez au moins des connaissances de base sur Linux, que vous savez utiliser le shell et, plus important encore, que vous hébergez votre site sur votre propre VPS. L’installation est assez simple et suppose que vous utilisez le compte root, sinon vous devrez peut-être ajouter ‘sudo
‘ aux commandes pour obtenir les privilèges root. Je vais vous montrer étape par étape les fichiers journaux du serveur Web Nginx sous Linux.
Afficher les fichiers journaux Nginx sur Linux
Étape 1. Journaux d’accès Nginx.
Le Nginx enregistre les activités de tous les visiteurs de votre site dans les journaux d’accès. Ici, vous pouvez trouver quels fichiers sont consultés, comment NGINX a répondu à une demande, quel navigateur un client utilise, l’adresse IP des clients, et bien d’autres.
Par défaut sur la plupart des distributions Linux, telles que Ubuntu, AlmaLinux et Debian, les journaux d’accès et d’erreurs sont situés dans le /var/log/nginx
annuaire.
- Configurez le journal d’accès Nginx.
Le journal d’accès doit être activé par défaut. Si ce n’est pas le cas, vous pouvez l’activer manuellement dans le fichier de configuration Nginx en utilisant le access_log
directif:
access_log /var/log/nginx/access.log;
Si vous souhaitez personnaliser la sortie du journal d’accès, vous pouvez le faire en utilisant le log_format
directif:
log_format personnalisé ‘$remote_addr – $remote_user [$time_local] ‘ ‘”$request” $status $body_bytes_sent ‘ ‘”$http_referer” “$http_user_agent” ;
Les variables utilisées dans le example configurer ci-dessus :
$remote_addr
: adresse IP du client$remote_user
: Informations sur l’utilisateur faisant la demande$time_local
: date et heure locales des serveurs$request
: Demande réelle$status
: Code de réponse$body_bytes_sent
: Taille de la réponse en octets$http_referer
: adresse IP du référent HTTP (source d’origine)$http_user_agent
: Informations détaillées sur le navigateur
Après cela, rechargez le serveur Web Nginx pour appliquer les nouveaux paramètres. Pour afficher les journaux d’accès pour le domaine your-domain.com
dans le fichier /var/log/nginx/your-domain.com.access.log
, utilisez le suivant tail
commande dans le terminal :
tail -f /var/log/nginx/votre-domaine.com.access.log
Étape 2. Journaux d’erreurs Nginx.
Chaque fois que Nginx s’arrête soudainement de fonctionner ou rencontre une erreur, il stocke les données d’événement dans le journal des erreurs. Ceci est particulièrement utile lors du débogage car cela permet de gagner du temps et rend le dépannage plus facile et efficace.
- Configurez le journal des erreurs Nginx.
Le journal des erreurs doit être activé par défaut. Si ce n’est pas le cas, vous pouvez l’activer manuellement dans le fichier de configuration Nginx en utilisant le error_log
directif:
error_log /var/log/nginx/error.log;
Vous trouverez ci-dessous les niveaux répertoriés selon leur gravité (de faible à élevé) :
debug
: messages utilisés pour le débogage (LE PLUS BAS)info
: messages d’informationnotice
: aviswarn
: mises en gardeerror
: erreurs lors du traitement de la demande (ne nécessite pas d’action immédiate)crit
: Erreur critique qui nécessite une action rapidealert
: Erreur nécessitant une action immédiateemerg
: Le système est inutilisable (LE PLUS ÉLEVÉ)
Comme dans le cas du journal d’accès, vous pouvez consigner les erreurs dans plusieurs fichiers. Veuillez noter que le fichier doit être créé manuellement avant de pouvoir vous y connecter :
error_log /var/log/nginx/error_log avertir ;
Pour example pour afficher les journaux d’accès pour le domaine your-domain.com
dans le fichier /var/log/nginx/your-domain.com.error.log
, utilisez le suivant tail
commande dans le terminal :
tail -f /var/log/nginx/votre-domaine.com.error.log
Toutes nos félicitations! Vous avez surveillé avec succès le journal d’accès Nginx et le journal d’erreurs Nginx. Pour plus d’informations sur le Apache journal d’accès et le Apache journal des erreurs, veuillez vérifier le site officiel de Nginx.