Red Hat Training

A Red Hat training course is available for RHEL 8

Capítulo 19. Diagnóstico de los problemas de las máquinas virtuales

Al trabajar con máquinas virtuales (VM), puede encontrar problemas con diferentes niveles de gravedad. Algunos problemas pueden tener una solución rápida y fácil, mientras que para otros, es posible que tenga que capturar datos y registros relacionados con las VM para informar o diagnosticar los problemas.

Las siguientes secciones proporcionan información detallada sobre la generación de registros y el diagnóstico de algunos problemas comunes de las máquinas virtuales, así como sobre la notificación de estos problemas.

19.1. Generación de registros de depuración de máquinas virtuales

Para diagnosticar los problemas de la máquina virtual (VM), es útil generar y revisar los registros de depuración. Adjuntar los registros de depuración también es útil a la hora de solicitar soporte para resolver problemas relacionados con la VM.

Las siguientes secciones explican qué son los registros de depuración, cómo se pueden configurar para que sean persistentes, habilitarlos durante el tiempo de ejecución y adjuntarlos al informar de problemas.

19.1.1. Entender los registros de depuración de la máquina virtual

Los registros de depuración son archivos de texto que contienen datos sobre eventos que ocurren durante el tiempo de ejecución de la máquina virtual (VM). Los registros proporcionan información sobre funcionalidades fundamentales del lado del servidor, como las bibliotecas del host y el servicio libvirtd. Los archivos de registro también contienen la salida de error estándar (stderr) de todas las VMs en ejecución.

El registro de depuración no está habilitado por defecto y tiene que ser habilitado cuando libvirt se inicia. Puede habilitar el registro para una sola sesión o de forma persistente. También puede habilitar el registro cuando una sesión del demonio libvirtd ya se está ejecutando modificando la configuración del tiempo de ejecución del demonio.

Adjuntar los registros de depuración de libvirt también es útil cuando se solicita apoyo con un problema de VM.

19.1.2. Activación de la configuración persistente para los registros de depuración de la máquina virtual

Puede configurar el registro de depuración de la máquina virtual (VM) para que se active automáticamente cada vez que se inicie libvirt editando el archivo de configuración libvirtd.conf que se encuentra en el directorio /etc/libvirt.

Procedimiento

  1. Abra el archivo libvirtd.conf en un editor.

  2. Sustituya o ajuste los filtros según sus necesidades.

    Fijar el valor del filtro en:

    • 1: registra todos los mensajes generados por libvirt.
    • 2: registra toda la información no relacionada con la depuración.
    • 3: registra todos los mensajes de advertencia y error. Este es el valor por defecto.
    • 4: registra sólo los mensajes de error.

    Por ejemplo, el siguiente comando:

    • Registra todos los mensajes de error y advertencia de las capas remote, util.json, y rpc
    • Registra sólo los mensajes de error de la capa event.

    • Guarda los registros filtrados en /var/log/libvirt/libvirtd.log 

      log_filters="3:remote 4:event 3:util.json 3:rpc"
log_outputs="1:file:/var/log/libvirt/libvirtd.log"
  3. Guardar y salir.

  4. Reinicie el servicio libvirtd. 

    $ systemctl restart libvirtd.service

19.1.3. Activación de los registros de depuración de la máquina virtual durante el tiempo de ejecución

Puede modificar la configuración de tiempo de ejecución del demonio libvirt para habilitar los registros de depuración y guardarlos en un archivo de salida.

Esto es útil cuando no es posible reiniciar libvirtd porque el reinicio soluciona el problema, o porque hay otro proceso, como la migración o la copia de seguridad, ejecutándose al mismo tiempo. Modificar la configuración en tiempo de ejecución también es útil si quieres probar un comando sin editar los archivos de configuración o reiniciar el demonio.

Requisitos previos

  • Asegúrese de que el paquete libvirt-admin está instalado.

Procedimiento

  1. Optional: Realiza una copia de seguridad del conjunto de filtros de registro activos. 

    # virt-admin daemon-log-filters >> virt-filters-backup
    Nota

    Se recomienda hacer una copia de seguridad del conjunto de filtros activos para poder restaurarlos después de generar los registros. Si no restaura los filtros, los mensajes seguirán registrándose, lo que puede afectar al rendimiento del sistema.

  2. Utilice la utilidad virt-admin para activar la depuración y establecer los filtros según sus necesidades.

    Fijar el valor del filtro en:

    • 1: registra todos los mensajes generados por libvirt.
    • 2: registra toda la información no relacionada con la depuración.
    • 3: registra todos los mensajes de advertencia y error. Este es el valor por defecto.
    • 4: registra sólo los mensajes de error.

    Por ejemplo, el siguiente comando:

    • Registra todos los mensajes de error y advertencia de las capas remote, util.json, y rpc

    • Registra sólo los mensajes de error de la capa event. 

      # virt-admin daemon-log-filters "3:remote 4:event 3:util.json 3:rpc"

  3. Utilice la utilidad virt-admin para guardar los registros en un archivo o directorio específico.
    Por ejemplo, el siguiente comando guarda la salida del registro en el archivo libvirt.log en el directorio /var/log/libvirt/. 

    # virt-admin daemon-log-outputs "1:file:/var/log/libvirt/libvirtd.log"

  4. Optional: También puede eliminar los filtros para generar un archivo de registro que contenga toda la información relacionada con la VM. Sin embargo, no se recomienda ya que este archivo puede contener una gran cantidad de información redundante producida por los módulos de libvirt.

    • Utilice la utilidad virt-admin para especificar un conjunto vacío de filtros. 

      # virt-admin daemon-log-filters
  Logging filters:
  5. Optional: Restaurar los filtros a su estado original utilizando el archivo de copia de seguridad.
    Realice el segundo paso con los valores guardados para restaurar los filtros.

19.1.4. Adjuntar registros de depuración de máquinas virtuales a las solicitudes de asistencia

Es posible que tenga que solicitar soporte adicional para diagnosticar y resolver los problemas de la máquina virtual (VM). Se recomienda encarecidamente adjuntar los registros de depuración a la solicitud de soporte para garantizar que el equipo de soporte tenga acceso a toda la información que necesita para proporcionar una rápida resolución del problema relacionado con la VM.

Procedimiento

  • Para informar de un problema y solicitar asistencia, abra un caso de asistencia.

  • Basándose en los problemas encontrados, adjunte los siguientes registros junto con su informe:

    • En caso de problemas con el servicio libvirt, adjunte el archivo /var/log/libvirt/libvirtd.log del host.

    • Para problemas con una VM específica, adjunte su respectivo archivo de registro.

      Por ejemplo, para la máquina virtual testguest1, adjunte el archivo testguest1.log, que se encuentra en /var/log/libvirt/qemu/testguest1.log.

Recursos adicionales