Configure the introspective instance monitor¶

Available since MOSK 25.1 TechPreview

This section explains how to set up the introspective instance monitor to enhance the reliability of virtual machines in your OpenStack environment.

To configure the introspective instance monitoring:

Verify that the introspective instance monitor is enabled in the OpenStackDeployment custom resource as described in Enabling introspective instance monitor.
Create a high availability (HA) segment to group relevant compute hosts that will participate in monitoring and recovery as described in Group compute nodes into segments.
Ensure the virtual machine image supports the QEMU Guest Agent for monitoring by updating the image with the hw_qemu_guest_agent=yes property:
```
openstack image set --property hw_qemu_guest_agent=yes <IMAGE_NAME>
```

When creating a virtual machine, specify the HA_Enabled=True property to include it in monitoring and recovery:

openstack server create --flavor <FLAVOR> \
                        --image <IMAGE> \
                        --network <NETWORK> \
                        --property HA_Enabled=True <SERVER_NAME>

Install the QEMU Guest Agent to enable communication between the host and guest operating systems and ensure precise monitoring of the instance health.
Linux-based virtual machines
1. Install the QEMU Guest Agent using the system package manager. For example:
  sudo apt install qemu-guest-agent
2. Verify that the agent is up and running:
  systemctl status qemu-guest-agent
Windows-based virtual machines
Note

This procedure uses a generic approach to adding drivers to Windows. The exact steps may vary depending on the Windows version. Refer to the installation documentation specific to your Windows version for detailed instructions.
1. Download the VirtIO driver ISO file (virtio-win.iso).
2. Install the VirtIO Serial Driver:
  1. Attach virtio-win.iso to your Windows virtual machine.
  2. Log in to the virtual machine.
  3. Open the Windows Device Manager.
  4. Locate PCI Simple Communications Controller in the device list.
  5. Right-click on it and select Update Driver.
  6. Browse to the mounted ISO directory DRIVE:\vioserial\<OSVERSION>\, where <OSVERSION> corresponds to the Windows version of your Windows virtual machine.
  7. Click Next to install the driver.
  8. Reboot the virtual machine to complete the driver installation.
3. Install the QEMU Guest Agent:
  1. Log in to the virtual machine.
  2. Use the File Explorer to navigate to the guest-agent directory in the virtio-win CD drive.
  3. Run the installer: qemu-ga-x86_64.msi (64-bit) or qemu-ga-i386.msi (32-bit).
  4. Verify that the qemu-guest-agent is up and running. For example, in the PowerShell:
    
    Get-Service QEMU-GA
    
    Expected system response:
    
    Status Name DisplayName ------ ---- ----------- Running QEMU-GA QEMU Guest Agent