Skip to main content

Cette version de GitHub Enterprise Server ne sera plus disponible le 2024-08-29. Aucune publication de correctifs n’est effectuée, même pour les problèmes de sécurité critiques. Pour de meilleures performances, une sécurité améliorée et de nouvelles fonctionnalités, effectuez une mise à niveau vers la dernière version de GitHub Enterprise. Pour obtenir de l’aide sur la mise à niveau, contactez le support GitHub Enterprise.

À propos des journaux système

Pour aider les administrateurs à comprendre l’activité et les erreurs, GitHub Enterprise Server stocke les journaux système.

À propos des journaux système pour GitHub Enterprise Server

Pour suivre, examiner et résoudre les problèmes d’activité et d’exceptions sur votre instance GitHub Enterprise Server, vous pouvez examiner les journaux système. Votre instance stocke les deux types de journaux système suivants.

  • Fichiers journaux de texte brut sur disque, stockés par syslog ou par des services spécifiques
  • Fichiers journaux binaires, stockés par journalisation

Par défaut, GitHub Enterprise Server effectue une rotation automatique des journaux du système toutes les 24 heures et conserve les journaux en rotation pendant sept jours. Les journaux système sont constitués d’événements de niveau système, des journaux d’application et des données d’événements Git. Étant donné que les fichiers journaux sont souvent écrits et peuvent être volumineux, vous pouvez préférer extraire et analyser des entrées de journal sur un hôte distinct de votre instance GitHub Enterprise Server.

Des personnes avec accès SSH administratif à une instance GitHub Enterprise Server peuvent accéder et lire des journaux système. Pour plus d’informations, consultez « Accès à l’interpréteur de commandes d’administration (SSH) ».

Vous pouvez transférer les journaux système et les journaux d’audit vers un système externe pour une analyse ou une rétention plus longue. Pour plus d’informations, consultez « Transfert de journaux » et « Streaming de journaux d’audit pour votre entreprise ».

En plus de passer en revue vos journaux système, vous pouvez surveiller l’activité sur votre instance de différentes façons. Par exemple, vous pouvez passer en revue les journaux d’audit et envoyer les journaux d’activité, ou configurer des webhooks globaux. Pour plus d’informations, consultez « Supervision de l’activité dans votre entreprise ».

REMARQUE : La liste des journaux d’activité suivante ne vise pas à être exhaustive.

Fichiers journaux système

GitHub Enterprise Server écrit plusieurs catégories de journaux système sur le disque de l’instance en texte brut. Des personnes avec un accès SSH administratif à l’instance peut analyser ces fichiers à l’aide d’outils en ligne de commande Linux tels que cat, tail, head, less et more.

Fichiers journaux pour la base de données

Les fichiers journaux suivants enregistrent les événements des services de base de données sur votre instance.

PathDescription
/var/log/mysql/mysql.log
Enregistre les événements liés à la base de données MySQL de l’instance.
/var/log/mysql/mysql.err
Enregistre les erreurs liées à la base de données MySQL de l’instance.

Fichiers journaux pour l’application GitHub

Les fichiers journaux suivants enregistrent les événements de l’application GitHub sur votre instance.

PathDescription
/var/log/github/audit.log
Enregistre les événements utilisateur, référentiel et système pour l’activité dans l’application GitHub sur votre instance. Vous pouvez filtrer les entrées dans le journal à l’aide du mot clé github_audit.
/var/log/github/exceptions.log
Enregistre les exceptions que l’application GitHub rencontre.
/var/log/github/gitauth.log
Enregistre les demandes d’authentification Git à l’aide de HTTPS ou SSH. Le service babeld traite toutes les demandes et activités d'authentification de Git.
/var/log/github/production.log
Enregistre les événements internes pour l’application GitHub. Pour les demandes adressées au site web, inclut l’action du contrôleur qui a répondu. Peut contenir des entrées avec différentes structures, en fonction de l’origine du travail ou de la demande.

Fichiers journaux pour le serveur HTTP

Les fichiers journaux suivants enregistrent les événements du serveur HTTP de l’instance.

PathDescription
/var/log/nginx/error.log*
Enregistre les erreurs pour les requêtes web.
/var/log/nginx/gist.log
Enregistre les requêtes HTTP liées aux gists. Pour plus d’informations, consultez « Création de gists ».
/var/log/nginx/gist.error.log
Enregistre les erreurs liées aux requêtes HTTP pour les gists.
/var/log/nginx/github.log
Enregistre les requêtes HTTP dans l’application GitHub.
/var/log/nginx/github.error.log
Enregistre les erreurs associées aux requêtes HTTP.
/var/log/nginx/pages.log
Enregistre les requêtes HTTP associées à GitHub Pages. Pour plus d’informations, consultez « À propos de GitHub Pages ».
/var/log/nginx/pages.error.log
Enregistre les erreurs liées aux requêtes HTTP pour GitHub Pages.

Fichiers journaux pour la Management Console.

Les fichiers journaux suivants contiennent des événements à partir de votre instance Management Console. Pour plus d’informations, consultez « À propos de la console de gestion ».

PathDescription
/var/log/enterprise-manage/audit.log
enregistre les activités dans l’instance Management Console
/var/log/enterprise-manage/unicorn.log
Enregistre les opérations HTTP et HTTPS effectuées par les administrateurs dans Management Console à l’aide de l’interface utilisateur web ou de l’API REST.

Fichiers journaux pour la configuration d’instance

Les fichiers journaux suivants contiennent des événements liés à la configuration de votre instance.

PathDescription
/data/user/common/ghe-config.log
Enregistre les événements associés à chaque exécution de configuration. En cas d’échec d’une exécution de configuration, la sortie vers le journal s’arrête. Ce journal enregistre également des informations sur les migrations qui s’exécutent durant le processus de mise à niveau du logiciel d’une instance. Pour plus d’informations, consultez « Utilitaires de ligne de commande ».

Les fichiers journaux suivants contiennent des événements provenant de services qui fournissent des fonctionnalités de recherche pour votre instance.

PathDescription
/var/log/elasticsearch/github-enterprise.log
Enregistre les événements associés au service Elasticsearch, que votre instance utilise pour fournir des services de recherche.

Journaux d’activité des webhooks

Les fichiers journaux suivants contiennent des événements liés aux webhooks envoyés par votre instance.

Nom du serviceDescription
hookshot-go
Enregistre les événements de toutes les activités de webhook sur l’instance, notamment les webhooks déclenchés, les livraisons et les échecs.

Fichiers journaux pour les services système

Les journaux d’activité suivants contiennent des événements provenant des services système sur votre instance.

PathDescription
/var/log/coredumps.log
Enregistre des informations sur les processus système qui se terminent de façon inattendue.
/var/log/boot.log
Enregistre des informations sur le processus de démarrage de l’instance.
/var/log/chrony/
Cet annuaire contient des journaux liés à la synchronisation NTP (Network Time Protocol) et à l’horloge système de l’instance. Pour plus d’informations, consultez « Configuration de la synchronisation de l’heure ».
/var/log/haproxy.log
Enregistre toutes les requêtes web et API à l’instance. Pour les connexions HTTP, les entrées incluent l’URL demandée par le client, ainsi que la méthode HTTP pour la requête.
/var/log/ssh-console-audit.log
Enregistre les commandes que les administrateurs exécutent à l’aide de l’interpréteur de commandes d’administration (SSH). Pour plus d’informations, consultez « Accès à l’interpréteur de commandes d’administration (SSH) ».
/var/log/mail-replies/metroplex.log
Enregistre des informations sur le courrier reçu par votre instance. Pour plus d’informations, consultez « Configuration de la messagerie pour les notifications ».

Journaux système dans le journal système

Plusieurs services GitHub Enterprise Server, comme le service babeld, sont conteneurisés. GitHub Enterprise Server écrit les journaux système pour ces services dans le journal système dans un format binaire.

Des personnes avec l’accès SSH administratif à l’instance peut analyser ces journaux à l’aide de la commande journalctl. Pour plus d’informations, consultez journalctl(1) dans les pages manuelles Linux en ligne.

Pour afficher les journaux dans le journal système, exécutez la commande suivante, en remplaçant SERVICE-NAME par un nom de service dans la liste suivante des journaux.

journalctl -t SERVICE-NAME

Journaux d’activité des journaux de l’application GitHub

Les journaux suivants enregistrent les événements à partir de l’application GitHub sur votre instance.

Nom du serviceDescription
github-resqued
Enregistre les événements liés aux travaux en arrière-plan. Si le travail implique une authentification intégrée ou externe, ce journal comprend des informations sur la demande.

Si l’instance utilise l’authentification LDAP et que la synchronisation LDAP est activée, les événements de synchronisation LDAP s’affichent dans ce journal. Pour plus d’informations, consultez « Utilisation de LDAP ».
github-unicorn
Enregistre les opérations HTTP et HTTPS effectuées par les utilisateurs dans l’interface utilisateur web de l’instance ou via les API. Si l’opération implique une authentification intégrée ou externe, ce journal comprend des informations sur la demande.

Si la journalisation du débogage est activée pour l’authentification LDAP ou SAML, les informations au niveau du débogage pour les demandes authentifiées s’affichent dans ce journal. Pour plus d’informations, consultez « AUTOTITRE » et « AUTOTITRE ».

Journaux d’activité des journaux pour Git

Les journaux suivants contiennent des événements liés à l’activité Git sur votre instance.

Nom du serviceDescription
babeld
Enregistre les événements de toutes les activités Git sur l’instance, y compris l’authentification pour accéder au référentiel.
codeload
Enregistre les événements d’activité liés à la génération ou à la récupération d’archives de code pour les référentiels sur l’instance.
gpgverify
Enregistre les événements liés à la vérification de signature de validation. Pour plus d’informations, consultez « À propos de la vérification des signatures de commit ».

Journaux d’activité des journaux pour le stockage

Les journaux suivants contiennent des événements des services qui stockent ou récupèrent des données sur votre instance.

Nom du serviceDescription
alambic
Enregistre les événements liés au stockage et à la récupération de fichiers, tels que les objets, images avatar, pièces jointes de fichiers Git LFS à partir de commentaires dans l’interface utilisateur web et archives de publication.

À propos des journaux système dans les bundle de support

Si vous générez un bundle de support, le fichier comprend des journaux système. Pour plus d’informations, consultez « Fournir des données au support GitHub ».