Proporcionar datos al soporte técnico de GitHub

Acerca de los archivos de diagnóstico y paquetes de soporte

Para ayudarle a solucionar problemas con una GitHub Enterprise Server instancia en su entorno, Soporte de GitHub puede solicitar uno o varios tipos de datos.

datos	Formato de archivo	Descripción
Archivo de diagnóstico	Texto no cifrado	Contiene información sobre la configuración y el entorno de la instancia.
Paquete de soporte técnico	Archivo	Contiene un archivo de diagnóstico y archivos de registro corregidos de los últimos dos días de manera predeterminada.
Paquete de soporte extendido	Archivo	Contiene un archivo de diagnóstico y archivos de registro corregidos de los últimos ocho días.

Acerca de la sanitización de los archivos de bitácora

Los tokens de autenticación, llaves y secretos se eliminan de los archivos de registro en los siguientes directorios de registro contenidos dentro de un paquete de soporte o archivo de diagnóstico:

alambic-logs
babeld-logs
codeload-logs
enterprise-manage-logs
github-logs
hookshot-logs
lfs-server-logs
semiotic-logs
task-dispatcher-logs
pages-logs
registry-logs
render-logs
svn-bridge-logs

Los archivos de diagnóstico son una introducción a la configuración y el entorno de una GitHub Enterprise Server instancia que contienen:

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 del anfitrión, modo privado, configuraciones de SSL
Cargar y procesar listas
Configuración de red
Método y detalles de autenticación
Número de repositorios, usuarios y otros datos de instalación

Puede descargar los diagnósticos de la instancia desde Consola de administración o ejecutando la utilidad de línea de comandos ghe-diagnostics.

Creación de un archivo de diagnóstico a partir de Consola de administración

Puede crear un archivo de diagnóstico a partir de Consola de administración si actualmente no tiene acceso SSH.

Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haz clic en .
Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.
En la barra lateral " Site admin", haz clic en Consola de administración.
Si has creado varias cuentas de usuario de la Consola de administración, selecciona Administrador del sitio raíz o Usuario de la Consola de administración . Para más información sobre las cuentas de usuario de Consola de administración, consulta Administración del acceso a la Consola de administración.
Escribe tus credenciales de la Consola de administración. A continuación, haga clic en Continue (Continuar).
En la barra de navegación superior, haga clic en Soporte.
Haga clic en Download diagnostics info (Descargar información de diagnóstico).

Crear un archivo de diagnóstico mediante SSH

Puede usar este método sin iniciar sesión en .Consola de administración

Use la utilidad de la línea de comandos ghe-diagnostics para recuperar el diagnóstico de la instancia.

ssh -p122 admin@HOSTNAME -- 'ghe-diagnostics' > diagnostics.txt

Después de que emites tu solicitud de soporte, podríamos pedirte 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

        Consola de administración registro

        `github-logs/exceptions.log`: información sobre los 500 errores encontrados en el sitio

        `github-logs/audit.log`: GitHub Enterprise Server registros de auditoría

        `babeld-logs/babeld.log`: registros de proxy de Git

        `system-logs/haproxy.log`: registros de HAProxy

        `elasticsearch-logs/github-enterprise.log`: registros de Elasticsearch

        `configuration-logs/`: GitHub Enterprise Server registros de configuración

        `collectd/logs/collectd.log`: registros recopilados

        `mail-logs/mail.log`: registros de entrega de correo electrónico SMTP

Para más información, consulta Registro de auditoría de una empresa.

Los paquetes de soporte incluyen registros de los dos últimos días de manera predeterminada. Puedes especificar una duración exacta en días. Para proporcionar registros de los últimos ocho días, puedes descargar un paquete de soporte extendido. Para obtener más información, consulta Creación y uso compartido de conjuntos de productos de soporte extendido.

Sugerencia

Al ponerse en contacto con Soporte de GitHub, se le enviará un correo electrónico de confirmación que contendrá un enlace de referencia de ticket. Si Soporte de GitHub le pide que cargue un paquete de soporte, puede usar el vínculo de referencia del ticket para cargar el paquete de soporte.

Creación de un paquete de soporte desde el Consola de administración

Puede usar estos pasos para crear y compartir un paquete de soporte técnico si puede acceder a la web Consola de administración y tener acceso saliente a Internet.

Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haz clic en .
Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.
En la barra lateral " Site admin", haz clic en Consola de administración.
Si has creado varias cuentas de usuario de la Consola de administración, selecciona Administrador del sitio raíz o Usuario de la Consola de administración . Para más información sobre las cuentas de usuario de Consola de administración, consulta Administración del acceso a la Consola de administración.
Escribe tus credenciales de la Consola de administración. A continuación, haga clic en Continue (Continuar).
En la barra de navegación superior, haga clic en Soporte.
Haga clic en Download support bundle (Descargar conjunto de soporte técnico).
Si un ingeniero de soporte te dio un enlace de carga para tu paquete de soporte, utiliza este enlace. De lo contrario, visite https://support.github.com/ e inicie sesión (si se le solicita) en una cuenta de empresa que tenga derecho a recibir soporte técnico.
Visite https://support.github.com/uploads y cargue la agrupación de soporte técnico.

Crear un paquete de soporte mediante SSH

Puede usar estos pasos para crear y compartir un paquete de soporte si tiene acceso SSH a tu instancia de GitHub Enterprise Server y acceso saliente a Internet.

Nota:

Si tu instancia de GitHub Enterprise Server está en una configuración de replicación geográfica o si la instancia es un clúster, debes usar el comando ghe-cluster-support-bundle para recuperar el conjunto de soporte técnico. Para más información, consulta Utilidades de la línea de comandos.

Descargar el paquete de soporte mediante SSH:
```
ssh -p 122 admin@HOSTNAME -- 'ghe-support-bundle -o' > support-bundle.tgz
```
Para obtener más información sobre el comando ghe-support-bundle, consulta Utilidades de la línea de comandos.
Si un ingeniero de soporte te dio un enlace de carga para tu paquete de soporte, utiliza este enlace. De lo contrario, visite https://support.github.com/ e inicie sesión (si se le solicita) en una cuenta de empresa que tenga derecho a recibir soporte técnico.
Visite https://support.github.com/uploads y cargue la agrupación de soporte técnico.

Cargar un paquete de soporte utilizando tu cuenta empresarial

Vaya a GitHub Enterprise Cloud.
En la esquina superior derecha de GitHub, haz clic en la fotografía de perfil.
En función de su entorno, haga clic en Enterprise o en Empresas y, a continuación, haga clic en la empresa que desea ver.
En el lado izquierdo de la página, en la barra lateral de la cuenta de empresa, haz clic en Settings.
En Settings, haz clic en License.
En "GitHub Enterprise Ayuda", haga clic en Cargar un paquete de soporte técnico.
En "Seleccionar una cuenta de empresa", use el menú desplegable para seleccionar la cuenta asociada del conjunto de soporte técnico.
En "Cargar un paquete de soporte técnico para Soporte técnico para GitHub Enterprise", para seleccionar el paquete de soporte técnico, haga clic en Elegir archivo o arrastre el archivo de agrupación de soporte técnico a Elegir archivo.
Haga clic en Cargar.

Cargar paquete de soporte mediante SSH

Puedes cargar directamente un paquete de soporte a nuestro servidor si:

Tiene acceso SSH a tu instancia de GitHub Enterprise Server.
Las conexiones HTTPS salientes a través del puerto TCP 443 se permiten de tu instancia de GitHub Enterprise Server a enterprise-bundles.github.com y esbtoolsproduction.blob.core.windows.net.

Sube el conjunto a nuestro servidor de conjuntos de soporte:
```
ssh -p122 admin@HOSTNAME -- 'ghe-support-bundle -u'
```

Los conjuntos de productos de soporte incluyen registros de los últimos dos días de manera predeterminada, mientras que los conjuntos de productos de soporte extendido incluyen registros de los últimos ocho días. Si los eventos que Soporte de GitHub investiga ocurrieron hace más de dos días, es posible que le pidamos que comparta un paquete de soporte extendido. Necesitará acceso SSH para descargar un paquete extendido: no puede descargar un lote extendido desde Consola de administración.

Para evitar que los paquetes sean demasiado grandes, estos solo contienen registros que no han sido rotados ni comprimidos. La rotación de registros en GitHub Enterprise Server se produce a varias frecuencias (diarias o semanales) para diferentes archivos de registros, dependiendo de lo grandes que esperamos que sean los registros.

Crear un paquete de soporte extendido mediante SSH

Puede usar estos pasos para crear y compartir un paquete de soporte extendido si tiene acceso SSH a tu instancia de GitHub Enterprise Server y acceso saliente a Internet.

Descargue el conjunto de productos de soporte extendido mediante SSH agregando la marca -x al comando ghe-support-bundle:
```
ssh -p 122 admin@HOSTNAME -- 'ghe-support-bundle -o -x' > support-bundle.tgz
```
Si un ingeniero de soporte te dio un enlace de carga para tu paquete de soporte, utiliza este enlace. De lo contrario, visite https://support.github.com/ e inicie sesión (si se le solicita) en una cuenta de empresa que tenga derecho a recibir soporte técnico.
Visite https://support.github.com/uploads y cargue la agrupación de soporte técnico.

Cargar un paquete de soporte extendido directamente usando SSH