À 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
- Fichiers journaux pour l’application GitHub
- Fichiers journaux pour le serveur HTTP
- Fichiers journaux pour la configuration d’instance
- Fichiers journaux pour la Management Console
- Fichiers journaux pour la recherche
- Fichiers journaux pour les services système
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.
| Path | Description |
|---|---|
/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.
| Path | Description |
|---|---|
/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.
| Path | Description |
|---|---|
/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 ».
| Path | Description |
|---|---|
/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.
| Path | Description |
|---|---|
/data/user/common/ghe-config.log | Enregistre les événements associés à la dernière 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 ». |
/data/user/config-apply/logs/YYYYMMDD/* | Stocke les fichiers journaux pour les exécutions de configuration précédentes. L’instance stocke les fichiers dans un répertoire qui reflète la date, et chaque nom de fichier reflète le nœud et l’ID de l’exécution. |
Fichiers journaux pour la recherche
Les fichiers journaux suivants contiennent des événements provenant de services qui fournissent des fonctionnalités de recherche pour votre instance.
| Path | Description |
|---|---|
/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 service | Description |
|---|---|
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.
| Path | Description |
|---|---|
/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
- Journaux d’activité des journaux pour Git
- Journaux d’activité des journaux pour le stockage
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 service | Description |
|---|---|
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 service | Description |
|---|---|
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 service | Description |
|---|---|
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 ».