Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Esta versión de GitHub Enterprise se discontinuó el 2020-11-12. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener un mejor desempeño, más seguridad y nuevas características, actualiza a la última versión de GitHub Enterprise. Para obtener ayuda con la actualización, contacta al soporte de GitHub Enterprise.

Supervisar por medio de SNMP

GitHub Enterprise proporciona datos sobre el uso del disco, la utilización del CPU, el uso de la memoria y más sobre SNMP.

En este artículo

SNMP es una norma común para controlar dispositivos en una red. Recomendamos firmemente habilitar SNMP para que puedas controlar la salud de tu instancia de servidor de GitHub Enterprise y saber cuándo agregar más memoria, almacenamiento, o rendimiento del procesador a la máquina del servidor.

GitHub Enterprise tiene una instalación SNMP estándar, para poder aprovechar los diversos plugins disponibles para Nagios o para cualquier otro sistema de control.

Configurar SNMP v2c

  1. En la esquina superior derecha de cualquier página, da clic en .
    Ícono de cohete para acceder a las configuraciones de administrador del sitio
  2. En la barra lateral izquierda, haz clic en Consola de administración.
    pestaña Consola de administración en la barra lateral izquierda
  3. En la barra lateral izquierda, da clic en Monitoreo.
    Pestaña de monitoreo
  4. Debajo de "Monitoreando", selecciona Habilitar SNMP.
    Botón para habilitar SNMP
  5. En el campo Community string (Cadena de la comunidad), ingresa una nueva cadena de comunidad. Si se deja en blanco, queda predeterminado como públicp.
    Campo para añadir la cadena de comunidad
  6. Debajo de la barra lateral izquierda, da clic en Guardar configuración.
    El botón de guardar en la Consola de administración
  7. Espera a que la configuración se ejecute por completo.
  8. Prueba tu configuración SNMP al ejecutar el siguiente comando en una estación de trabajo por separado con soporte de SNMP en tu red:
    # community-string is your community string
    # hostname is the IP or domain of your Enterprise instance
    $ snmpget -v 2c -c community-string -O e hostname hrSystemDate.0

Debería devolver la hora del sistema en el host tu instancia de servidor de GitHub Enterprise.

Seguridad basada en el usuario

Si habilitas el SNMP v3, puedes aprovechar la seguridad en base al usuario aumentada a través de User Security Model (USM). Para cada usuario único, puedes especificar un nivel de seguridad:

  • noAuthNoPriv: este nivel de seguridad no brinda autenticación ni privacidad.
  • authNoPriv: este nivel de seguridad brinda autenticación pero no privacidad. Para consultar al aparato deberás usar un nombre de usuario y una contraseña (que debe tener como mínimo ocho caracteres). La información se envía sin encriptación, similar a SNMPv2. El protocolo de autenticación puede ser MD5 o SHA o SHA como predeterminado.
  • authPriv: este nivel de seguridad brinda autenticación con privacidad. Se requiere autenticación, incluida una contraseña de autenticación de ocho caracteres como mínimo, y las respuestas están encriptadas. No se requiere una contraseña de privacidad, pero si se proporciona debe tener como mínimo ocho caracteres. Si no se proporciona una contraseña de privacidad, se usa la contraseña de autenticación. El protocolo de privacidad puede ser DES o AES y queda AES como predeterminado.

Configurando usuarios para SNMP v3

  1. En la esquina superior derecha de cualquier página, da clic en .
    Ícono de cohete para acceder a las configuraciones de administrador del sitio
  2. En la barra lateral izquierda, haz clic en Consola de administración.
    pestaña Consola de administración en la barra lateral izquierda
  3. En la barra lateral izquierda, da clic en Monitoreo.
    Pestaña de monitoreo
  4. Debajo de "Monitoreando", selecciona Habilitar SNMP.
    Botón para habilitar SNMP
  5. Selecciona SNMP v3.
    Botón para habilitar SNMP v3
  6. En "Username (Nombre de usuario)", escribe el nombre de usuario único de tu usuario SNMP v3.
    Campo para escribir el nombre de usuario SNMP v3
  7. En el menú desplegable Security Level (Nivel de seguridad), haz clic en el nivel de seguridad para tu usuario SNMP v3.
    Menú desplegable para el nivel de seguridad del usuario SNMP v3
  8. Para usuarios SNMP v3 con el nivel de seguridad authnopriv:
    Configuración para el nivel de seguridad authnopriv
    • En "Contraseña de autenticación", escribe la contraseña de autenticación.
    • En la parte derecha de "Contraseña de autenticación", en el menú desplegable de Protocolo, da clic en el protocolo de autenticación que quieras utilizar.
  9. Para usuarios SNMP v3 con el nivel de seguridad authpriv:
    Configuración para el nivel de seguridad authpriv
    • En "Contraseña de autenticación", escribe la contraseña de autenticación.
    • En la parte derecha de "Contraseña de autenticación", en el menú desplegable de Protocolo, da clic en el protocolo de autenticación que quieras utilizar.
    • De forma opcional, en "Privacy password" (Contraseña de privacidad), escribe la contraseña de privacidad.
    • Hacia la derecha de "Privacy password" (Contraseña de privacidad), en el menú desplegable Protocol (Protocolo), haz clic en el método de protocolo de privacidad que deseas usar.
  10. Haz clic en Add secret (Agregar secreto).
    Botón para añadir usuario SNMP v3
  11. Debajo de la barra lateral izquierda, da clic en Guardar configuración.
    El botón de guardar en la Consola de administración
  12. Espera a que la configuración se ejecute por completo.
Consultar datos de SNMP

Tanto la información del nivel de software como de hardware sobre tu aparato está disponible con SNMP v3. Debido a la falta de encriptación y privacidad para los niveles de seguridad noAuthNoPriv y authNoPriv, excluimos la tabla hrSWRun (1.1.3.6.1.2.1.25.41) de los informes SNMP resultantes. Incluimos esta tabla si estás usando el nivel de seguridad authPriv.

Con SNMP v2c, solo está disponible la información del nivel de hardware de tu aparato. Estas aplicaciones y servicios dentro de GitHub Enterprise no tienen configurado OID para informar métricas. Hay varios MIB disponibles, que puedes ver ejecutando snmpwalk en una estación de trabajo separada con soporte SNMP en tu red:

# community-string es tu cadena de comunidad
# hostname es la IP o dominio de tu instancia de empresa
$ snmpwalk -v 2c -c community-string -O e hostname

De los MIB disponibles para SNMP, el más útil es HOST-RESOURCES-MIB (.1.3.6.1.2.1.25). Consulta la tabla de abajo para ver algunos objetos importantes en este MIB:

NombreOIDDescripción
hrSystemDate.2.1.3.6.1.2.1.25.1.2La noción de servidores de los datos locales y de la hora del día.
hrSystemUptime.0.1.3.6.1.2.1.25.1.1.0Cuánto tiempo ha pasado desde que el servidor se inició por última vez.
hrMemorySize.0.1.3.6.1.2.1.25.2.2.0La cantidad de RAM en el servidor.
hrSystemProcesses.0.1.3.6.1.2.1.25.1.6.0La cantidad de contextos de proceso actualmente cargados o ejecutándose en el servidor.
hrStorageUsed.1.1.3.6.1.2.1.25.2.3.1.6.1La cantidad de espacio de almacenamiento consumido en el servidor, en hrStorageAllocationUnits.
hrStorageAllocationUnits.1.1.3.6.1.2.1.25.2.3.1.4.1El tamaño, en bytes, de una hrStorageAllocationUnit

Por ejemplo, para consultar hrMemorySize con SNMP v3, ejecuta el siguiente comando en una estación de trabajo separada con apoyo de SNMP en tu red:

# username es el nombre de usuario único de tu usuario SNMP v3
# auth password es la contraseña de autenticación
# privacy password es la contraseña de privacidad
# hostname es la IP o el dominio de tu instancia de empresa
$ snmpget -v 3 -u username -l authPriv \
  -A "auth password" -a SHA \
  -X "privacy password" -x AES \
  -O e hostname HOST-RESOURCES-MIB::hrMemorySize.0

Con SNMP v2c, para consultar hrMemorySize, ejecuta el siguiente comando en una estación de trabajo separada con apoyo de SNMP en tu red:

# community-string es tu cadena de comunidad
# hostname es la IP o el dominio de tu instancia de empresa
snmpget -v 2c -c community-string hostname HOST-RESOURCES-MIB::hrMemorySize.0

Nota: para evitar que se filtre información sobre los servicios que se están ejecutando en tu aparato, excluimos la tabla hrSWRun (1.1.3.6.1.2.1.25.41) de los informes SNMP resultantes excepto que estés usando el nivel de seguridad authPriv con SNMP v3. Si estás utilizando el nivel de seguridad authPriv, incluimos la tabla hrSWRun.

Para obtener más información sobre los mapeos OID para los atributos de sistema comunes en SNMP, consulta "OID SNMP de Linux para CPU, memoria y estadísticas de disco".