Les journaux sont très utiles pour surveiller les activités de n’importe quelle application en plus de vous fournir des informations précieuses pendant que vous les dépannez.
comme toute autre application, NGINX enregistre également des événements tels que les visiteurs de votre site, les problèmes rencontrés et plus encore dans les fichiers journaux. Ces informations vous permettent de prendre des mesures préventives au cas où vous remarqueriez des divergences graves dans les événements du journal.,
Cet article vous guidera dans les détails sur la façon de configurer la journalisation NGINX afin que vous ayez une meilleure idée de ses activités.
Préalable
- Vous avez déjà installé NGINX en suivant notre tutoriel ici.
Logs dans NGINX
par défaut, NGINX écrit ses événements dans deux types de logs – le journal d’erreur et le journal d’accès., Dans la plupart des distributions Linux populaires comme Ubuntu, CentOS ou Debian, le journal des accès et des erreurs se trouve dans /var/log/nginx
, en supposant que vous ayez déjà activé les journaux des accès et des erreurs dans le fichier de configuration Nginx de base.
laissez-nous en savoir plus sur le journal d’accès NGINX, le journal des erreurs et comment les activer si vous ne l’avez pas fait plus tôt.
qu’est-Ce que NGINX journal d’accès?
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 accessibles, comment NGINX a répondu à une demande, quel navigateur un client utilise, adresse IP des clients et plus encore. Il est possible d’utiliser les informations du journal d’accès pour analyser le trafic afin de trouver les usages des sites au fil du temps. De plus, en surveillant correctement les journaux d’accès, on peut savoir si un utilisateur envoie une demande inhabituelle pour trouver des failles dans l’application web déployée.
qu’est-ce que le journal des erreurs NGINX?
d’autre part, si NGINX fait face à des problèmes, il enregistrera l’événement dans le journal des erreurs., Cela peut se produire s’il y a une erreur dans le fichier de configuration. Par conséquent, si NGINX ne peut pas démarrer ou s’arrête brusquement de fonctionner, vous devez vérifier les journaux d’erreurs pour trouver plus de détails. Vous pouvez également trouver quelques avertissements dans le journal des erreurs, mais cela n’indique pas qu’un problème s’est produit, mais l’événement peut poser un problème sérieux dans un proche avenir.
comment activer le journal d’accès NGINX?
en général, le journal d’accès peut être activé avec la directiveaccess_log
dans http ou dans la section Serveur., Le premier argument log_file est obligatoire tandis que le deuxième argument log_format est facultatif. Si vous ne spécifiez aucun format, les journaux seront écrits au format combiné par défaut.
access_log log_file log_format;
le journal d’accès est activé par défaut dans le contexte http du fichier de configuration core NGINX. Cela signifie que le journal d’accès de tout l’hôte virtuel sera enregistré dans le même fichier.
http { ... ... access_log /var/log/nginx/access.log; ... ...}
Il est toujours préférable de séparer les journaux d’accès de tous les hôtes virtuels en les enregistrant dans un fichier séparé., Pour ce faire, vous devez remplacer la directiveaccess_log
définie dans la section http par une autre directiveaccess_log
dans le contexte du serveur.
rechargez NGINX pour appliquer les nouveaux paramètres. Pour afficher les journaux d’accès du domaine domain1.com dans le fichier /var/log/nginx/domain1.access.log
, utilisez la commande tail suivante dans le terminal.
# tail -f /var/log/nginx/domain1.access.log
Appliquer un Format Personnalisé dans le Journal d’Accès
Le journal par défaut, le format utilisé pour enregistrer un événement dans le journal des accès est combiné format de journal., Vous pouvez remplacer le comportement par défaut en créant votre propre format de journal personnalisé, puis spécifiez le nom du format personnalisé dans la access_log directive.
l’exemple suivant définit un format de journal personnalisé en étendant le format combiné prédéfini avec la valeur du taux de compression gzip de la réponse. Le format est ensuite appliqué en indiquant le format du journal avec la directiveaccess_log
.
Une fois que vous avez appliqué le format de journal ci-dessus dans votre environnement, rechargez NGINX. Maintenant, suivez le journal d’accès pour trouver le rapport gzip à la fin de l’événement de journal.,
comment activer le journal des erreurs NGINX?
la directive error_log
configure la journalisation des erreurs sur file ou stderr, ou syslog en spécifiant le niveau de gravité minimal des messages d’erreur à consigner. La syntaxe de la directive error_log est la suivante:
error_log log_file log_level;
le premier argument log_file définit le chemin du fichier journal et le second argument log_level définit le niveau de gravité de l’événement de journal à enregistrer. Si vous ne spécifiez pas le niveau log_level, par défaut, seuls les événements de journal avec un niveau d’erreur de gravité sont enregistrés.,
par exemple, l’exemple suivant définit le niveau de gravité des messages d’erreur à enregistrer sur crit
. De plus, la directive error_log dans le contexte http implique que le journal des erreurs de tout l’hôte virtuel sera disponible dans un seul fichier.
http { ... error_log /var/log/nginx/error_log crit; ...}
Il est également possible d’enregistrer les journaux d’erreurs pour tous les hôtes virtuels séparément en remplaçant la directive error_log dans le contexte du serveur. L’exemple suivant le fait exactement en remplaçant la directive error_log dans le contexte du serveur.,
Tous les exemples décrits ci-dessus enregistrent les événements de journal dans un fichier. Vous pouvez également configurer la directive error_log pour envoyer les événements de journal à un serveur syslog. La directive error_log suivante envoie les journaux d’erreurs au serveur syslog avec une adresse IP de 192.168.10.11 au format debug.
error_log syslog:server=192.168.10.11 debug;
dans certaines situations, vous pouvez désactiver le journal des erreurs. Pour ce faire, définissez le nom du fichier journal sur /dev/null
.,
error_log /dev/null;
Nginx Journal des Erreurs Niveaux de Gravité
Il existe de nombreux types de niveaux de journal qui sont associés à un événement de journal et avec une priorité différente. Tous les niveaux de journal sont répertoriés ci-dessous. Dans les niveaux de journal suivants, le débogage a la priorité absolue et inclut également le reste des niveaux. Par exemple, si vous spécifiez error comme niveau de journal, il capturera également les événements de journal étiquetés comme crit, alert et emergency.
- emerg: messages D’urgence lorsque votre système peut être instable.
- alerte: messages D’alerte de problèmes graves.,
- crit: problèmes critiques qui doivent être pris en charge immédiatement.
- erreur: Une erreur s’est produite. Quelque chose s’est mal passé lors du traitement d’une page.
- warn: un message d’avertissement que vous devriez regarder en elle.
- avis: Un avis de journal simple que vous pouvez ignorer.
- info: juste un message d’information que vous voudrez peut-être savoir.
- debug: informations de débogage utilisées pour localiser l’emplacement de l’erreur.,
résumé
Les journaux d’accès et d’erreur dans NGINX garderont non seulement un onglet sur l’activité des utilisateurs, mais économiseront également votre temps et vos efforts dans le processus de débogage. En outre, vous pouvez également personnaliser le journal d’accès si vous avez besoin de plus d’informations à votre disposition. Il est toujours préférable d’activer les journaux d’accès et d’erreur car ces deux fichiers contiennent tous les indices pour une meilleure maintenance du serveur NGINX.