Skip to main content

Configurar collectd

GitHub Enterprise puede reunir datos con collectd y enviarlos a un servidor collectd externo. Entre otras métricas, reunimos un conjunto estándar de datos, como la utilización de la CPU, el consumo de memoria y de disco, el tráfico y los errores de la interfaz de red y la carga general de la VM.

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 your GitHub Enterprise Server instance. 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>

Habilita 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, haz clic en .

    Captura de pantalla del icono de cohete para acceder a los ajustes administrativos

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

    Captura de pantalla del vínculo "Administrador del sitio" 1. En la barra lateral de la izquierda, haga clic en Consola de administración . Pestaña Consola de administración en la barra lateral de la izquierda

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

  4. 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.

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

  6. 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 de la izquierda, haga clic en Guardar configuración.

    Captura de pantalla del botón para guardar los ajustes en la Consola de administración

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

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

    Configurar tu instancia

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 de 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 contactas con Soporte de 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 collectd central debe ser al menos la versión 5.x para aceptar los datos enviados desde your GitHub Enterprise Server instance.

Para obtener ayuda con más preguntas o problemas, contacta a Soporte de GitHub Enterprise.