Documentación de productos
XenServer
8.4 Citrix Hypervisor 8.2 CU1
Ver PDF

Supervise los recursos de host y dom0 con SNMP

Nota: No

La función SNMP está disponible para los clientes de XenServer Premium o Trial Edition. Para obtener más información sobre las licencias de XenServer, consulte Licenciamiento. Para actualizar u obtener una licencia de XenServer, visite la página Sitio web de XenServer.

Con la función Administrador de grupo, puede utilizar SNMP para supervisar de forma remota los recursos consumidos por el host de XenServer y dom0, el dominio de control del host. Un administrador SNMP, también conocido como sistema de administración de red (NMS), envía solicitudes de consulta a un agente SNMP que se ejecuta en un host XenServer. El agente SNMP responde a estas solicitudes de consulta enviando los datos recopilados sobre varias métricas al NMS. Los datos que se pueden recopilar se definen mediante identificadores de objetos (OID) en un archivo de texto denominado base de información de gestión (MIB). Un OID representa una parte específica de información medible sobre un dispositivo de red, como el uso de CPU o memoria.

También puede configurar trampas, que son mensajes iniciados por el agente que alertan al NMS de que se ha producido un evento específico en XenServer. Tanto las solicitudes de consulta como las capturas se pueden utilizar para supervisar el estado de los grupos de XenServer. Estos se definen como objetos métricos y de trampa y se identifican mediante OID en un archivo MIB XENSERVER-MIB.txt, disponible para descargar desde el Página de descargas de XenServer. En las tablas siguientes se proporciona información sobre estos objetos de métrica y trampa.

Objetos métricos

Puede solicitar una información específica sobre los hosts de XenServer mediante las métricas que se enumeran en la tabla siguiente. Estas métricas son utilizadas por el administrador SNMP al enviar solicitudes de consulta a un agente SNMP, por lo que puede ver estos datos en su NMS.

Puede ver los datos devueltos de estos objetos métricos desde su NMS o desde la CLI xe. Para consultar los objetos de métrica de la CLI xe, ejecute host-data-source-query o vm-data-source-query y proporcione la fuente de datos RRDD como un valor para el fuente de datos parámetro. Por ejemplo:

  xe host-data-source-query data-source=cpu_avg host=<host UUID>
<!--NeedCopy-->

Nota: No

De forma predeterminada, el NMS envía solicitudes de consulta OID a los agentes SNMP mediante el puerto 161.

Identificador de objeto (OID) Fuente de datos RRDD Datos devueltos Tipo
1.3.6.1.4.1.60953.1.1.1.1 memory Memoria total Dom0 en MB Unsigned32
1.3.6.1.4.1.60953.1.1.1.2 memory_internal_free Memoria libre Dom0 en MB Unsigned32
1.3.6.1.4.1.60953.1.1.1.3 cpu_usage Uso de CPU Dom0 como porcentaje Flotar
1.3.6.1.4.1.60953.1.1.1.4 memory_total_kib Memoria total del host en MB Unsigned32
1.3.6.1.4.1.60953.1.1.1.5 memory_free_kib Memoria libre del host en MB Unsigned32
1.3.6.1.4.1.60953.1.1.1.6 cpu_avg Uso de CPU del host como porcentaje Flotar
1.3.6.1.4.1.60953.1.1.1.7 (véase la nota 1) Número de pCPUs Unsigned32
1.3.6.1.4.1.60953.1.1.1.8 running_vcpus Número de vCPU en ejecución Unsigned32
1.3.6.1.4.1.60953.1.1.1.9 running_domains Número de máquinas virtuales en ejecución Unsigned32

Notes:

  1. El nombre de una pCPU está en el formato CPU seguido de un número. Para consultar el número de pCPU de la CLI xe, ejecute el siguiente comando:

    xe host-data-source-list host=<host UUID> | grep -E 'cpu[0-9]+$'

    Esto devuelve una lista de las métricas de CPU que coinciden con la expresión regular CPU[0-9]+.

Trampas

Las capturas son alertas enviadas por el agente SNMP para notificar al administrador SNMP cuando se producen determinados eventos, lo que le permite supervisar los hosts de XenServer e identificar problemas con antelación. Puede configurar los ajustes de SNMP para generar una trampa cuando se alcance un límite (por ejemplo, si el uso de la CPU del host es demasiado alto). Cuando se genera una trampa, se envía a su NMS y los siguientes campos se devuelven como parte del objeto de trampa.

Nota: No

De forma predeterminada, el agente SNMP en el host coordinador del grupo envía capturas al NMS mediante el puerto UDP 162.

Identificador de objeto (OID) Nombre del campo Tipo Descripción
1.3.6.1.4.1.60953.1.10.1.1 operation Cadena Puede ser uno de los siguientes valores: agregar o Del. operación es agregar si XenServer genera una trampa y la envía a su NMS (también se crea una alerta en XenCenter) o Del Si se destruye una alerta (por ejemplo, si descarta una alerta).
1.3.6.1.4.1.60953.1.10.1.2 ref Cadena Referencia del objeto de captura.
1.3.6.1.4.1.60953.1.10.1.3 uuid Cadena UUID del objeto trampa.
1.3.6.1.4.1.60953.1.10.1.4 name Cadena Nombre del objeto trampa.
1.3.6.1.4.1.60953.1.10.1.5 priority Número entero La severidad de la trampa. Puede ser uno de los siguientes valores: 1:Crítico 2:Destacado 3:Advertencia 4:Menor 5:Información otros:Desconocido.
1.3.6.1.4.1.60953.1.10.1.6 class Cadena La categoría de la trampa generada. Puede ser uno de los siguientes valores: VM, Anfitrión, SR, Piscina, VMPP, VMSS, PVS_proxy, VDIo Certificado.
1.3.6.1.4.1.60953.1.10.1.7 obj-uuid Cadena El UUID del objeto xapi de las distintas clases del campo clase.
1.3.6.1.4.1.60953.1.10.1.8 timestamp Cadena El momento en el que se genera la trampa.
1.3.6.1.4.1.60953.1.10.1.9 body Cadena Información detallada sobre el campo nombre.

Requisitos previos

  • Todos los hosts de un grupo deben ejecutar la misma versión de XenServer y esta versión debe contener el complemento SNMP.

    Nota: No

    Si no puede ver el SNMP en XenCenter, puede deberse a que el host o un miembro del grupo no está ejecutando una versión de XenServer que admita SNMP. Actualice el host o el grupo a la versión más reciente de XenServer.

  • El NMS que está utilizando debe ser compatible con SNMPv2c o SNMPv3.

  • Su NMS y XenServer deben estar conectados a la red.

Restricciones

  • Puede configurar los ajustes de SNMP para un grupo completo o para un host independiente que no forme parte de un grupo. Actualmente, no se pueden configurar los ajustes de SNMP para un host individual en un grupo.

  • Si agrega un host a un grupo que ya tiene SNMP habilitado y configurado en él, XenCenter no aplica automáticamente la configuración de SNMP del grupo al nuevo host. Debe volver a configurar la configuración de SNMP en el grupo después de agregar el nuevo host o configurar el nuevo host con la misma configuración de SNMP antes de agregarlo al grupo.

    Nota: No

    Al reconfigurar la configuración de SNMP en un grupo después de agregar un nuevo host, asegúrese de que el host esté en funcionamiento y no en modo de mantenimiento.

  • Antes de realizar una actualización gradual de un grupo de servidores de Citrix Hypervisor 8.2 CU1 a XenServer 8.4 o de aplicar actualizaciones a sus grupos y hosts de XenServer, haga una copia de seguridad de los siguientes archivos de configuración si los modificó manualmente antes y los necesita:

    • /etc/snmp/snmpd.xs.conf
    • /etc/sysconfig/snmp
    • /var/lib/net-snmp/snmpd.conf
  • Cuando el agente SNMP está sin conexión, no se pueden generar capturas. Por ejemplo, si se reinicia el agente SNMP o se reinicia o se vuelve a designar el coordinador del grupo.

Configuración de SNMP mediante la CLI de xe

Puede configurar SNMP mediante la CLI de xe o XenCenter. Para obtener más información sobre cómo configurar SNMP mediante XenCenter, consulte Supervisión de recursos de host y dom0 con SNMP.

resultado Objetos

Al configurar SNMP, todas las respuestas se devuelven en formato JSON. Si un comando se ejecuta correctamente, devuelve el par clave-valor "código": 0. Algunos comandos (como el get-config comando) devuelve un objeto JSON anidado llamado resultado. El resultado JSON también es necesario para el objeto set-config que se utiliza para actualizar la configuración SNMP.

El resultado El objeto JSON se compone de los siguientes objetos común, agentey nmss:

common

Campo Valores permitidos Valor predeterminado
enabled No (deshabilitar el servicio SNMP) o Sí (habilitar el servicio SNMP) no
debug_log No (deshabilitar el registro de depuración) o Sí (habilitar el registro de depuración) no
max_nmss N/A (este campo es de solo lectura y especifica el número máximo de NMS compatibles) 1

agent

Campo Valores permitidos Valor predeterminado
v2c No (deshabilitar SNMPv2c) o Sí (habilitar SNMPv2c) yes
community COMMON_STRING_TYPE (véase la nota 1) public
v3 No (deshabilitar v3) o Sí (Habilitar v3) no
user_name COMMON_STRING_TYPE (véase la nota 1)  
authentication_password COMMON_STRING_TYPE donde la longitud >= 8 (véase la nota 1)  
authentication_protocol MD5 o SHA  
privacy_password COMMON_STRING_TYPE donde la longitud >= 8 (véase la nota 1)  
privacy_protocol DES o AES  
engine_id N/A (este campo es de solo lectura y se genera cuando el agente SNMP se inicia por primera vez)  

nmss

Campo Valores permitidos Valor predeterminado
uuid UUID de NMS (se establece cuando se configura el receptor de trampas NMS y este valor debe ser coherente en todos los hosts de un grupo)  
address Dirección IPv4 NMS o nombre de host (FQDN)  
port 1 Para 65535 162
v2c No (deshabilitar SNMPv2c), Sí (habilite SNMPv2c) o admita SNMPv2c o v3. yes
community COMMON_STRING_TYPE (véase la nota 1) public
v3 No (desactivar v3), Sí (habilitar v3) o admitir SNMPv2c o SNMPv3. no
user_name COMMON_STRING_TYPE (véase la nota 1)  
authentication_password COMMON_STRING_TYPE donde la longitud >= 8 (véase la nota 1)  
authentication_protocol MD5 o SHA  
privacy_password COMMON_STRING_TYPE donde la longitud >= 8 (véase la nota 1)  
privacy_protocol DES o AES  

Notes:

  1. COMMON_STRING_TYPE hace referencia a una cadena que cumple los siguientes requisitos:

    • Cualquier combinación de letra, número, guión (-), punto (.), libra (#), signo arroba (@), igual a (=), dos puntos (:) o caracteres de subrayado (_).
    • Longitud entre 6 y 32 inclusive.

  2. Las contraseñas no se almacenan en texto plano en ningún archivo de configuración de XenServer. Se convierten en una clave localizada y se almacenan. El get-config muestra la contraseña como una constante oculta compuesta por asteriscos (*).

Configurar el servicio SNMP

Obtenga el estado del servicio SNMP:

  xe host-call-plugin host-uuid=<host-uuid> plugin=snmp fn=status
<!--NeedCopy-->

Inicie, detenga o reinicie el servicio SNMP:

  xe host-call-plugin host-uuid=<host-uuid> plugin=snmp fn=<operation>
<!--NeedCopy-->

Dónde operación es empezar, pararo reanudar.

Obtenga los detalles de configuración de SNMP:

  xe host-call-plugin host-uuid=<host-uuid> plugin=snmp fn=get-config
<!--NeedCopy-->

Si se ejecuta correctamente, este comando devuelve el par clave-valor "código": 0 y el resultado JSON que contiene los detalles de configuración del servicio SNMP. Por ejemplo:

  "code": 0,
    "result": {
      "common": {
        "enabled": "no",
        "debug_log": "no",
        "max_nmss": 1
      },
      "agent": {
        "v2c": "yes",
        "v3": "no",
        "community": "public",
        "user_name": "",
        "authentication_password": "",
        "authentication_protocol": "",
        "privacy_password": "",
        "privacy_protocol": "",
        "engine_id": "<engine_id>"
      },
      "nmss": []
    }
<!--NeedCopy-->

Copie el archivo resultado JSON a su editor de texto preferido y elimine todos los objetos nuevos (\n) del archivo. Actualice los campos con los detalles de configuración de SNMP. Configure su NMS consultando la documentación de su NMS y especificando valores para los campos requeridos para el nmss objeto. Para obtener más información, consulte la Objetos enumerados anteriormente.

Para configurar el servicio SNMP, ejecute el comando set-config y proporcione el comando editado resultado JSON como un valor de parámetro para el objeto args:config parámetro.

Establezca la configuración SNMP:

  xe host-call-plugin host-uuid=<host-uuid> plugin=snmp fn=set-config args:config='<result>'
<!--NeedCopy-->

Dónde resultado es el resultado JSON devuelto desde el objeto get-config que ha copiado y editado.

Nota: No

Para configurar SNMP para un grupo completo, debe ejecutar el comando set-config para cada host del grupo.

Si los cambios de configuración se realizan correctamente, el comando devuelve el par clave-valor "código": 0. Si los cambios de configuración no se realizan correctamente, el set-config devuelve uno de los siguientes pares clave-valor que indican que se ha producido un error:

  • "código": 1: Cadena de error común. Por ejemplo, una excepción desconocida.
  • "código": 2: Cadena de error (falta el parámetro).
  • "código": 3: Devuelve un Mensaje object como una lista donde cada elemento está en el formato de [field_path, clave, valor, cadena de error].

También puede enviar una trampa SNMP de prueba a su NMS para verificar que la información especificada del receptor de trampa sea correcta.

Envíe una captura SNMP de prueba:

  xe host-call-plugin host-uuid=<host-uuid> plugin=snmp fn=send-test-trap args:config='{"nmss":[{"uuid":"<uuid>","address":"<address>","port":162,"v2c":"yes","v3":"no","community":"public","user_name":"<user_name>","authentication_password":"<authentication_password>","authentication_protocol":"<authentication_protocol>","privacy_password":"<privacy_password>","privacy_protocol":"<privacy_protocol>"}]}'
<!--NeedCopy-->

Este comando envía una trampa de prueba a su NMS con el msg_name de TEST_TRAP y el msg_body de Esta es una trampa de prueba del grupo XenServer "&lt;pool name&gt;" para verificar la configuración del receptor de trampas NMS.

Si no recibe la trampa de prueba, vuelva a comprobar la configuración de SNMP. Si no tiene éxito, el send-test-trap también devuelve uno de los siguientes pares clave-valor que indican que se ha producido un error:

  • "código": 1: Cadena de error común. Por ejemplo, una excepción desconocida.
  • "código": 2: Cadena de error (falta el parámetro).
  • "código": 3: Devuelve un Mensaje object como una lista donde cada elemento está en el formato de [field_path, clave, valor, cadena de error].
  • "código": 4: Devuelve un Mensaje object como una lista donde cada elemento está en el formato de [dirección nms, puerto nms, cadena de error].
Supervise los recursos de host y dom0 con SNMP

En este artículo

Comentarios sobre el sitio | Your privacy choices footer linkSus opciones de privacidad | Condiciones legales y de privacidad | Parámetros de consentimiento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.