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
- Archivos de registro para la aplicación GitHub
- Archivos de registro para el servidor HTTP
- Archivos de registro para la configuración de instancias
- Archivos de registro para Consola de administración
- Archivos de registro para la búsqueda
- Archivos de registro para servicios del sistema
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 acceso | Descripció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 acceso | Descripció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 acceso | Descripció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 acceso | Descripció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 acceso | Descripció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». |
Archivos de registro para la búsqueda
Los siguientes archivos de registro contienen eventos de los servicios que proporcionan funcionalidad de búsqueda para la instancia.
| Ruta de acceso | Descripció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 servicio | Descripció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 acceso | Descripció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
- Registros de diario para Git
- Registros de diario para el almacenamiento
Registros de diario de la aplicación GitHub
Los registros siguientes registran eventos de la aplicación GitHub en la instancia.
| Nombre del servicio | Descripció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 servicio | Descripció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 servicio | Descripció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».