Files
masakari-monitors/doc/source/instancemonitor.rst
suzhengwei fe85b8debb [doc] Add masakari monitors usage
Change-Id: Ibf89716c2d5df04541aa746a0b3c54a897710015
2021-08-03 18:08:00 +00:00

1.3 KiB

masakari-instancemonitor

Monitor Overview

The masakari-instancemonitor provides Virtual Machine High Availability for OpenStack clouds by automatically detecting VMs domain events via libvirt. If it detects specific libvirt events, it sends notifications to the masakari-api.

How does it work?

  • It runs libvirt event loop in a background thread.
    • Invoking libvirt.virEventRegisterDefaultImpl() will register libvirt's default event loop implementation.
    • Invoking libvirt.virEventRunDefaultImpl() will perform one iteration of the libvirt default event loop.
    • Invoking conn.domainEventRegisterAny() will register event callbacks against libvirt connection instances. The callbacks registered will be triggered from the execution context of libvirt.virEventRunDefaultImpl(), which will send notifications to the masakari-api.
  • It will reconnect to libvirt and reprocess if disconnected.

This section in masakarimonitors.conf shows an example of how to configure the monitor.

[libvirt]
# Override the default libvirt URI.
connection_uri = qemu:///system