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.

Configura un servidor collectd externo

Si aún no has configurado un servidor collectd externo, tendrás que hacerlo antes de habilitar el redireccionamiento collectd en tu instancia de GitHub Enterprise Server. Tu servidor collectd debe ejecutar la versión 5.x o superior de collectd.

  1. Inicia sesión en tu servidor collectd.
  2. Crea o edita el archivo de configuración collectd para cargar el plugin de red y completar las directivas del servidor y del puerto con los valores adecuados. En la mayoría de las distribuciones, este se ubica en /etc/collectd/collectd.conf

Un ejemplo collectd.conf para ejecutar un servidor collectd:

Red LoadPlugin
...
...
<Red de plugin>
    Escucha "0.0.0.0" "25826"
</Plugin>

Habilita el redireccionamiento collectd en GitHub Enterprise

Por defecto, el redireccionamiento collectd está inhabilitado en GitHub Enterprise. Sigue los pasos que aparecen a continuación para habilitar y configurar el redireccionamiento 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 aún no estás en la página de "Administrador de sitio", en la esquina inferior izquierda, haz clic en Administrador de sitio.

    Captura de pantalla del enlace de "Administrador de sitio"

  3. En la barra lateral izquierda, haz clic en Consola de administración. pestaña Consola de administración en la barra lateral izquierda

  4. A continuación aparecen los ajustes de redireccionamiento, selecciona Enable collectd forwarding (Habilitar el redireccionamiento collectd).

  5. En el campo Server addres (Dirección del servidor), escribe la dirección del servidor collectd al cual quisieras redirreccionar las estadísticas del aparato GitHub Enterprise.

  6. En el campo Port (Puerto), escribe el puerto utilizado para canectarse al servidor collectd. (Predeterminados en 25826)

  7. En el menú desplegable Cryptographic setup (Configuración criptográfica), selecciona el nivel de seguridad de las comunicaciones con el servidor collectd. (Ninguno, paquetes firmados o paquetes encriptados).

  8. Debajo de la barra lateral izquierda, da clic en Guardar configuración. El botón de guardar en la Consola de administración

  9. Espera a que la configuración se ejecute por completo.

Exportar los datos collectd con ghe-export-graphs

La herramienta de la línea de comando ghe-export-graphs exportará los datos que collectd almacene en las bases de datos RRD. This command turns the data into XML and exports it into a single 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 viene con la versión 5.x de collectd. collectd 5.x no es retrocompatible con la serie de lanzamientos 4.x. Tu servidor collectd central debe tener al menos la versión 5.x para aceptar los datos que se envían desde tu instancia de GitHub Enterprise Server.

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