Versión del artículo: Enterprise Server 2.17
Proporcionar datos al soporte de GitHub
Dado que Soporte de GitHub no tiene acceso a tu entorno, te solicitaremos información adicional.
Crear y compartir archivos de diagnóstico
Los diagnósticos son una descripción general de los parámetros de una instancia de GitHub Enterprise Server y del entorno que contiene:
- Información de licencia de cliente, incluido el nombre de la empresa, fecha de validez y cantidad de licencias de usuario
- Números de versión y SHAs
- Arquitectura VM
- Nombre de host, modo privado, entorno de SSL
- Cargar y procesar listas
- Parámetros de red
- Método y detalles de autenticación
- Número de repositorios, usuarios y otros datos de instalación
Puedes descargar el diagnóstico para tu instancia desde la Consola de administración o al ejecutar la utilidad de la línea de comando ghe-diagnostics
.
Crear un archivo de diagnóstico desde Consola de administración
Puedes usar este método si no tienes tu clave SSH fácilmente disponible.
- En la esquina superior derecha de cualquier página, da clic en .
- En la barra lateral izquierda, haz clic en Consola de administración.
- Si se te solicita, teclea tu contraseña de Consola de administración.
- En la parte superior derecha de Consola de administración, da clic en Soporte.
- Haz clic en Download diagnostics info (Descargar información de diagnóstico).
Crear un archivo de diagnóstico mediante SSH
Puedes usar este método sin iniciar sesión en Consola de administración.
Usa la utilidad de la línea de comando ghe-diagnostics para recuperar el diagnóstico para tu instancia.
$ ssh -p122 admin@hostname -- 'ghe-diagnostics' > diagnostics.txt
Crear y compartir paquetes de soporte
Después de enviar tu solicitud de soporte, es posible que te pidamos que compartas un paquete de soporte con nuestro equipo. El paquete de soporte es un archivo tar comprimido en gzip que incluye diagnósticos y registros importantes desde tu instancia, como:
- Registros relacionados con la autenticación que pueden resultar útiles al solucionar problemas de errores de autenticación, o configurar LDAP, CAS o SAML
- Registro Consola de administración
github-logs/exceptions.log
: Información sobre 500 errores encontrados en el sitiogithub-logs/audit.log
: registros de auditoría GitHub Enterprise Serverbabeld-logs/babeld.log
: registros proxy Gitsystem-logs/haproxy.log
: registros HAProxyelasticsearch-logs/github-enterprise.log
: registros Elasticsearchconfiguration-logs/ghe-config.log
: registros de configuración GitHub Enterprise Servercollectd/logs/collectd.log
: registros Collectdmail-logs/mail.log
: registros de entrega por correo electrónico SMTPhookshot-logs/exceptions.log
: errores de entrea de Webhook
Para obtener más información, consulta "Audit logging (Registro de auditoría".
Los paquetes de soporte incluyen registros de los dos últimos días. Para obtener registros de los últimos siete días, puedes descargar un paquete de soporte extendido. Para obtener más información, consulta "Crear y compartir paquete de soporte extendido".
Sugerencias: Cuando te comuniques con Soporte de GitHub, recibirás un correo electrónico de confirmación con un enlace de referencia del ticket. Si Soporte de GitHub te pide que cargues un paquete de soporte, puedes usar el enlace de referencia del ticket para cargar el paquete de soporte.
Crear un paquete de soporte desde la Consola de administración
Puedes usar estos pasos para crear y compartir un paquete de soporte si puedes acceder a la Consola de administración basada en la web y tienes acceso a internet de salida.
- En la esquina superior derecha de cualquier página, da clic en .
- En la barra lateral izquierda, haz clic en Consola de administración.
- Si se te solicita, teclea tu contraseña de Consola de administración.
- En la parte superior derecha de Consola de administración, da clic en Soporte.
- Haz clic en Download support bundle (Descargar paquete de soporte).
- Visita https://enterprise.github.com/support e inicia sesión en (si se solicita que lo hagas).
- Visita https://enterprise.github.com/support/bundles/new y carga tu paquete de soporte.
Crear un paquete de soporte mediante SSH
Puedes usar estos pasos para crear y compartir un paquete de soporte si tienes acceso a SSH para tu aparato GitHub Enterprise Server y tiene acceso a Internet de salida.
Nota: Si vas a usar una configuración de Replicación geográfica o una Agrupación de GitHub Enterprise, debes usar el comando ghe-cluster-support-bundle
para recuperar el paquete de soporte. Para obtener más información, consulta "Utilidades de la línea de comandos".
- Descargar el paquete de soporte mediante SSH:
Para obtener más información acerca del comando$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -o' > support-bundle.tgz
ghe-support-bundle
, consulta "Utilidades de la línea de comandos". - Visita https://enterprise.github.com/support e inicia sesión en (si se solicita que lo hagas).
- Visita https://enterprise.github.com/support/bundles/new y carga tu paquete de soporte.
Cargar paquete de soporte mediante SSH
Puedes cargar directamente un paquete de soporte a nuestro servidor si:
- Tienes acceso a SSH para tu aparato GitHub Enterprise Server.
- Las conexiones HTTPS de salida sobre el puerto TCP 443 están permitidas desde tu aparato GitHub Enterprise Server.
- Cargar el paquete a nuestro servidor de paquete de soporte:
$ ssh -p122 admin@hostname -- 'ghe-support-bundle -u'
Crear y compartir paquetes de soporte extendido
Los paquetes de soporte incluyen registros de los últimos dos días, mientras que los paquetes de soporte extendidos incluyen registros de los últimos siete días. Si los eventos que Soporte de GitHub estás investigando se produjeron hace más de dos días, es posible que te pidamos que compartas un paquete de soporte extendido. Deberás tener acceso a SSH para descargar un soporte extendido, no puedes descargar un paquete extendido desde Consola de administración.
Para evitar que los paquetes sean demasiado grandes, solo pueden contener registros que no hayan sido rotados y comprimidos. La rotación de los registros en GitHub Enterprise Server se produce en diferentes frecuencias (diarias o semanales) para los diferentes archivos de registro, según el tamaño que pretendamos que tengan los registros.
Crear un paquete de soporte extendido mediante SSH
Puedes usar estos pasos para crear y compartir un paquete de soporte extendido si tienes acceso a SSH para tu aparato GitHub Enterprise Server y tienes acceso a internet de salida.
- Descarga el paquete de soporte extendido mediante SSH al agregar el marcador
-x
al comandoghe-support-bundle
:$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -o -x' > support-bundle.tgz
- Visita https://enterprise.github.com/support e inicia sesión en (si se solicita que lo hagas).
- Visita https://enterprise.github.com/support/bundles/new y carga tu paquete de soporte.
Cargar un paquete de soporte extendido directamente usando SSH
Puedes cargar directamente un paquete de soporte a nuestro servidor si:
- Tienes acceso a SSH para tu aparato GitHub Enterprise Server.
- Las conexiones HTTPS de salida sobre el puerto TCP 443 están permitidas desde tu aparato GitHub Enterprise Server.
- Cargar el paquete a nuestro servidor de paquete de soporte:
$ ssh -p122 admin@hostname -- 'ghe-support-bundle -u -x'