Dans ce didacticiel, nous allons vous montrer comment afficher les fichiers journaux Nginx sous 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 'll effectuer 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 fournira 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 s'exécutent dans le compte root, sinon vous devrez peut-être ajouter 'sudo
‘ aux commandes pour obtenir les privilèges root. Je vais vous montrer la vue étape par étape des fichiers journaux du serveur Web Nginx sous Linux.
Prérequis
- Un serveur exécutant l'un des systèmes d'exploitation suivants :Ubuntu et toute autre distribution basée sur Debian ou basée sur RHEL.
- Il est recommandé d'utiliser une nouvelle installation du système d'exploitation pour éviter tout problème potentiel.
- Accès SSH au serveur (ou ouvrez simplement Terminal si vous êtes sur un ordinateur).
- Un
non-root sudo user
ou l'accès à l'root user
. Nous vous recommandons d'agir en tant qu'non-root sudo user
, cependant, car vous pouvez endommager votre système si vous ne faites pas attention lorsque vous agissez en tant que root.
Afficher les fichiers journaux Nginx sous Linux
Étape 1. Journaux d'accès Nginx.
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, ce le navigateur qu'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 se trouvent dans le /var/log/nginx
répertoire.
- Configurer 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 à l'aide de access_log
instruction :
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
instruction :
log_format custom '$remote_addr - $remote_user [$time_local] ' '"$request" $status $body_bytes_sent ' '"$http_referer" "$http_user_agent";
Variables utilisées dans l'exemple de configuration ci-dessus :
$remote_addr
:Adresse IP du client$remote_user
:Informations sur l'utilisateur à l'origine de la demande$time_local
:Date et heure locales du serveur$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 originale)$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 la tail
suivante commande dans le terminal :
tail -f /var/log/nginx/your-domain.com.access.log
Étape 2. Journaux d'erreurs Nginx.
Chaque fois que Nginx s'arrête soudainement 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 facilite le dépannage et plus efficace.
- Configurer 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 à l'aide de error_log
instruction :
error_log /var/log/nginx/error.log;
Vous trouverez ci-dessous les niveaux classés par gravité (de bas en haut) :
debug
: messages utilisés pour le débogage (LE PLUS BAS)info
:messages d'informationnotice
:aviswarn
:avertissementserror
:erreurs lors du traitement de la demande (ne nécessite pas d'action immédiate)crit
:Erreur critique nécessitant 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 warn;
Par exemple pour afficher les logs d'accès pour le domaine your-domain.com
dans le fichier /var/log/nginx/your-domain.com.error.log
, utilisez la tail
suivante commande dans le terminal :
tail -f /var/log/nginx/your-domain.com.error.log
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 journal d'accès Apache et le journal d'erreurs Apache, veuillez consulter le site Web officiel de Nginx.