Configuración de collect en la instancia

Para obtener información sobre el rendimiento de GitHub Enterprise Server, puede revisar los datos de collectd en la instancia u, opcionalmente, enviar los datos a un servidor de collectd externo.

En este artículo

Acerca de collect para GitHub Enterprise Server

collectd es un servicio que se ejecuta en datos tu instancia de GitHub Enterprise Server para recopilar y proporcionar métricas sobre el rendimiento del sistema. Las métricas comunes que collectd recopila incluyen el uso de CPU, el consumo de memoria y disco, el tráfico y los errores de la interfaz de red, y la carga general de un sistema. También puede reenviar los datos a otro servidor de collectd. Para obtener más información, vea la Wiki de collect.

La instancia usa métricas de collectd para mostrar gráficos en el panel de supervisión de Consola de administración. Para más información, consulta Acerca del panel de supervisión.

Puede revisar una lista de las métricas que collectd recopila en los datos tu instancia de GitHub Enterprise Server. Para más información, consulta Métricas collectd para GitHub Enterprise Server.

Configuración de un servidor externo de collectd

Si todavía no ha configurado un servidor externo de collectd, tendrá que hacerlo antes de habilitar el reenvío de collectd en tu instancia de GitHub Enterprise Server. El servidor collectd debe ejecutar la versión 5.x o posterior de collectd.

  1. Inicie sesión en el servidor collectd.
  2. Cree o edite el archivo de configuración collectd para cargar el complemento de red y complete las directivas del servidor y del puerto con los valores adecuados. En la mayoría de las distribuciones, se encuentra en /etc/collectd/collectd.conf

Un ejemplo de collectd.conf para ejecutar un servidor collectd:

LoadPlugin network
...
...
<Plugin network>
    Listen "0.0.0.0" "25826"
</Plugin>

Habilitar el redireccionamiento collectd en GitHub Enterprise

De manera predeterminada, el reenvío de collectd está deshabilitado en GitHub Enterprise. Siga los pasos que se indican a continuación para habilitar y configurar el reenvío de collectd:

  1. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haga clic en .

  2. Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.

  3. En la barra lateral " Administrador del sitio", haz clic en Consola de administración .

  4. Debajo de la configuración de reenvío de registros, seleccione Habilitar reenvío recopilado.

  5. En el campo Dirección del servidor, escriba la dirección del servidor collectd al que quiera reenviar estadísticas del dispositivo de GitHub Enterprise.

  6. En el campo Puerto, escriba el puerto que se usa para conectarse al servidor collectd. (Predeterminados en 25826)

  7. En el menú desplegable Configuración criptográfica, seleccione el nivel de seguridad de las comunicaciones con el servidor collectd. (Ninguno, Paquetes firmados o Paquetes encriptados). 1. En la barra lateral "Configuración" , haga clic en Guardar configuración.

    Note

    Al guardar la configuración en Consola de administración se restablecen los servicios del sistema, lo que podría generar un tiempo de inactividad visible para el usuario.

  8. Espera que se complete la fase de configuración.

Exportación de datos recopilados con ghe-export-graphs

La herramienta de línea de comandos ghe-export-graphs exportará los datos que collectd almacena en las bases de datos de RRD. Este comando convierte los datos en XML y los exporta a un único archivo tarball (.tgz).

Su uso principal es proporcionarle al equipo de Soporte técnico para GitHub Enterprise los datos sobre el desempeño de una VM, sin la necesidad de descargar un paquete de soporte completo. No se debe incluir en tus exportaciones de copias de seguridad regulares y no existe una contraparte de importación. Si te pones en contacto con nosotros mediante Soporte técnico para GitHub Enterprise, puede que te solicitemos estos datos para ayudarte a solucionar los problemas.

Uso

ssh -p 122 admin@[hostname] -- 'ghe-export-graphs' && scp -P 122 admin@[hostname]:~/graphs.tar.gz .

Solución de problemas

El servidor collectd central no recibe datos

GitHub Enterprise se incluye con la versión 5.x de collectd. collectd 5.x no es compatible con versiones anteriores de la serie de versiones 4.x. El servidor central collectd debe ser al menos la versión 5.x para aceptar los datos enviados desde tu instancia de GitHub Enterprise Server.

Para obtener ayuda con más preguntas o problemas, ve a Soporte técnico para GitHub Enterprise.