Skip to main content

Esta versión de GitHub Enterprise Server se discontinuó el 2024-07-09. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener rendimiento mejorado, seguridad mejorada y nuevas características, actualice a la versión más reciente de GitHub Enterprise Server. Para obtener ayuda con la actualización, póngase en contacto con el soporte técnico de GitHub Enterprise.

Acerca de los registros del sistema

Para ayudar a los administradores a comprender la actividad y los errores, GitHub Enterprise Server almacena los registros del sistema.

Acerca de los registros del sistema para GitHub Enterprise Server

Para realizar un seguimiento, revisar y solucionar problemas de actividad y excepciones en tu instancia de GitHub Enterprise Server, puede revisar los registros del sistema. La instancia almacena los dos tipos siguientes de registros del sistema.

  • Archivos de registro de texto sin formato en disco, almacenados por syslog o servicios específicos
  • Archivos de registro binarios, almacenados por journald

De forma predeterminada, GitHub Enterprise Server rota los registros del sistema automáticamente cada 24 horas y se conservan durante 7 días. Los registros del sistema incluyen eventos de nivel de sistema, registros de aplicaciones y datos de eventos de Git. Dado que los archivos de registro se escriben a menudo y pueden tener un tamaño grande, es posible que prefiera extraer y analizar entradas de registro en un host independiente de tu instancia de GitHub Enterprise Server.

Las personas con acceso SSH administrativo a una instancia de GitHub Enterprise Server pueden acceder a los registros del sistema y leerlos. Para obtener más información, vea «Acceder al shell administrativo (SSH)».

Puede reenviar registros del sistema y registros de auditoría a un sistema externo para su análisis o retención durante más tiempo. Para obtener más información, consulta: "Redireccionamiento de registro" y "Streaming del registro de auditoría de su empresa".

Además de revisar los registros del sistema, puede supervisar la actividad en la instancia de otras maneras. Por ejemplo, puede revisar los registros de auditoría y los registros de inserción, o configurar webhooks globales. Para obtener más información, vea «Monitorear la actividad en tu empresa».

Nota: La siguiente lista de registros no está pensada para ser completa.

Archivos de registros del sistema

GitHub Enterprise Server escribe varias categorías de registros del sistema en el disco de la instancia en texto sin formato. Las personas con acceso SSH administrativo a la instancia pueden analizar estos archivos mediante herramientas de línea de comandos de Linux, como cat, tail, head, less y more.

Archivos de registro para bases de datos

Los siguientes archivos de registro registran eventos de los servicios de base de datos de la instancia.

Ruta de accesoDescripción
/var/log/mysql/mysql.log
Registra eventos relacionados con la base de datos MySQL de la instancia.
/var/log/mysql/mysql.err
Registra errores relacionados con la base de datos MySQL de la instancia.

Archivos de registro para la aplicación GitHub

Los siguientes archivos de registro registran eventos de la aplicación GitHub en la instancia.

Ruta de accesoDescripción
/var/log/github/audit.log
Registra eventos de usuario, repositorio y sistema para la actividad en la aplicación GitHub en la instancia. Puede filtrar las entradas del registro mediante la palabra clave github_audit.
/var/log/github/exceptions.log
Registra excepciones que encuentra la aplicación GitHub.
/var/log/github/gitauth.log
Registra las solicitudes de autenticación de Git mediante HTTPS o SSH. El servicio babeld procesa las solicitudes de autenticación y actividad de Git.
/var/log/github/production.log
Registra eventos internos para la aplicación GitHub. Para las solicitudes al sitio web, incluye la acción del controlador que respondió. Puede contener entradas con estructuras diferentes, según el origen del trabajo o la solicitud.

Archivos de registro para el servidor HTTP

Los siguientes archivos de registro registran eventos del servidor HTTP de la instancia.

Ruta de accesoDescripción
/var/log/nginx/error.log*
Registra errores para las solicitudes web.
/var/log/nginx/gist.log
Registra solicitudes HTTP relacionadas con gists. Para obtener más información, vea «Crear gists».
/var/log/nginx/gist.error.log
Registra errores relacionados con solicitudes HTTP para gists.
/var/log/nginx/github.log
Registra solicitudes HTTP a la aplicación GitHub.
/var/log/nginx/github.error.log
Registra errores asociados a solicitudes HTTP.
/var/log/nginx/pages.log
Registra solicitudes HTTP asociadas a GitHub Pages. Para obtener más información, vea «Acerca de GitHub Pages».
/var/log/nginx/pages.error.log
Registra errores relacionados con solicitudes HTTP para GitHub Pages.

Archivos de registro para Consola de administración

Los siguientes archivos de registro contienen eventos de Consola de administración de la instancia. Para obtener más información, vea «Acerca de la consola de administración».

Ruta de accesoDescripción
/var/log/enterprise-manage/audit.log
Registra actividades en la Consola de administración de la instancia.
/var/log/enterprise-manage/unicorn.log
Registra las operaciones HTTP y HTTPS que realizan los administradores en Consola de administración mediante la UI web o la API REST.

Archivos de registro para la configuración de instancias

Los siguientes archivos de registro contienen eventos relacionados con la configuración de la instancia.

Ruta de accesoDescripción
/data/user/common/ghe-config.log
Registra eventos asociados a cada ejecución de configuración. Si se produce un error en una ejecución de configuración, se detiene la salida al registro.. Este registro también registra información sobre las migraciones que se ejecutan durante el proceso de actualización del software de una instancia. Para obtener más información, vea «Utilidades de la ea de comandos».

Los siguientes archivos de registro contienen eventos de los servicios que proporcionan funcionalidad de búsqueda para la instancia.

Ruta de accesoDescripción
/var/log/elasticsearch/github-enterprise.log
Registra eventos asociados al servicio Elasticsearch, que la instancia usa para proporcionar servicios de búsqueda.

Registros de diario para webhooks

Los siguientes archivos de registro contienen eventos relacionados con webhooks que envía la instancia.

Nombre del servicioDescripción
hookshot-go
Registra eventos para toda la actividad de webhooks en la instancia, incluidos los webhooks desencadenados, las entregas y los errores.

Archivos de registro para servicios del sistema

Los registros siguientes contienen eventos de los servicios del sistema en la instancia.

Ruta de accesoDescripción
/var/log/coredumps.log
Registra información sobre los procesos del sistema que finalizan inesperadamente.
/var/log/boot.log
Registra información sobre el proceso de arranque de la instancia.
/var/log/chrony/
Este directorio contiene registros relacionados con la sincronización del Protocolo de tiempo de redes (NTP) y el reloj del sistema de la instancia. Para obtener más información, vea «Configuración de la sincronización de la hora».
/var/log/haproxy.log
Registra todas las solicitudes web y de API a la instancia. En el caso de las conexiones HTTP, las entradas incluyen la dirección URL solicitada por el cliente, así como el método HTTP para la solicitud.
/var/log/ssh-console-audit.log
Registra los comandos que los administradores ejecutan mediante el shell administrativo (SSH). Para obtener más información, vea «Acceder al shell administrativo (SSH)».
/var/log/mail-replies/metroplex.log
Registra información sobre el correo que recibe la instancia. Para obtener más información, vea «Configurar el correo electrónico para notificaciones».

Registros del sistema en el diario de systemd

Varios servicios de GitHub Enterprise Server, como el servicio babeld, se incluyen en contenedores. GitHub Enterprise Server escribe registros del sistema para estos servicios en el diario de systemd en un formato binario.

Las personas con acceso SSH administrativo a la instancia pueden analizar estos registros mediante el comando journalctl. Para obtener más información, consulte journalctl(1) en las páginas del manual de Linux en línea.

Para ver los registros en el diario de systemd, ejecute el comando siguiente, reemplazando SERVICE-NAME por un nombre de servicio de la siguiente lista de registros.

journalctl -t SERVICE-NAME

Registros de diario de la aplicación GitHub

Los registros siguientes registran eventos de la aplicación GitHub en la instancia.

Nombre del servicioDescripción
github-resqued
Registra eventos relacionados con trabajos en segundo plano. Si el trabajo implica autenticación integrada o externa, este registro incluye información sobre la solicitud.

Si la instancia usa la autenticación LDAP y la sincronización LDAP está habilitada, los eventos para la sincronización LDAP aparecen en este registro. Para más información, consulta "Usar LDAP".
github-unicorn
Registra las operaciones HTTP y HTTPS que realizan los usuarios en la UI web de la instancia o mediante las API. Si la operación implica autenticación integrada o externa, este registro incluye información sobre la solicitud.

Si el registro de depuración está habilitado para la autenticación LDAP o SAML, la información de nivel de depuración para las solicitudes autenticadas aparece en este registro. Para más información, consulte "Usar LDAP" o "Autenticación SAML".

Registros de diario para Git

Los registros siguientes contienen eventos relacionados con la actividad de Git en la instancia.

Nombre del servicioDescripción
babeld
Registra eventos para toda la actividad de Git en la instancia, incluida la autenticación para acceder al repositorio.
codeload
Registra eventos de actividad relacionados con la generación o recuperación de archivos de código para repositorios en la instancia.
gpgverify
Registra eventos relacionados con la comprobación de la firma de confirmación. Para obtener más información, vea «Acerca de la verificación de firma de confirmación».

Registros de diario para el almacenamiento

Los registros siguientes contienen eventos de servicios que almacenan o recuperan datos en la instancia.

Nombre del servicioDescripción
alambic
Registra eventos relacionados con el almacenamiento y recuperación de archivos, como los objetos de Git LFS, imágenes de avatar, archivos adjuntos de comentarios en la UI web y archivos de versión.

Acerca de los registros del sistema en paquetes de soporte técnico

Si genera un paquete de soporte técnico, el archivo incluye los registros de sistema. Para obtener más información, vea «Cómo proporcionar datos al servicio de soporte técnico de GitHub».