<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Title" content="">
<meta name="Keywords" content="">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
        {font-family:"Courier New";
        panose-1:2 7 3 9 2 2 5 2 4 4;}
@font-face
        {font-family:Wingdings;
        panose-1:5 0 0 0 0 0 0 0 0 0;}
@font-face
        {font-family:"Cambria Math";
        panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
        {font-family:Calibri;
        panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
        {margin:0cm;
        margin-bottom:.0001pt;
        font-size:12.0pt;
        font-family:Calibri;}
a:link, span.MsoHyperlink
        {mso-style-priority:99;
        color:#0563C1;
        text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
        {mso-style-priority:99;
        color:#954F72;
        text-decoration:underline;}
p.MsoListParagraph, li.MsoListParagraph, div.MsoListParagraph
        {mso-style-priority:34;
        margin-top:0cm;
        margin-right:0cm;
        margin-bottom:0cm;
        margin-left:36.0pt;
        margin-bottom:.0001pt;
        font-size:12.0pt;
        font-family:Calibri;}
span.EmailStyle17
        {mso-style-type:personal-compose;
        font-family:Calibri;
        color:windowtext;}
span.msoIns
        {mso-style-type:export-only;
        mso-style-name:"";
        text-decoration:underline;
        color:teal;}
.MsoChpDefault
        {mso-style-type:export-only;
        font-family:Calibri;}
@page WordSection1
        {size:612.0pt 792.0pt;
        margin:72.0pt 72.0pt 72.0pt 72.0pt;}
div.WordSection1
        {page:WordSection1;}
/* List Definitions */
@list l0
        {mso-list-id:915551171;
        mso-list-type:hybrid;
        mso-list-template-ids:-225812880 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l0:level1
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:Symbol;}
@list l0:level2
        {mso-level-number-format:bullet;
        mso-level-text:o;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:"Courier New";}
@list l0:level3
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:Wingdings;}
@list l0:level4
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:Symbol;}
@list l0:level5
        {mso-level-number-format:bullet;
        mso-level-text:o;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:"Courier New";}
@list l0:level6
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:Wingdings;}
@list l0:level7
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:Symbol;}
@list l0:level8
        {mso-level-number-format:bullet;
        mso-level-text:o;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:"Courier New";}
@list l0:level9
        {mso-level-number-format:bullet;
        mso-level-text:;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;
        font-family:Wingdings;}
ol
        {margin-bottom:0cm;}
ul
        {margin-bottom:0cm;}
--></style>
</head>
<body bgcolor="white" lang="EN-US" link="#0563C1" vlink="#954F72">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:11.0pt">( I have been having a discussion with Adam Spiers on [openstack-dev][vitrage][nova] on this topic ... thought I would switchover to [masakari] )<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">I am interested in contributing an implementation of Intrusive Instance Monitoring,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">initially specifically VM Heartbeat / Heath-check Monitoring thru the QEMU Guest Agent (<a href="https://wiki.libvirt.org/page/Qemu_guest_agent)">https://wiki.libvirt.org/page/Qemu_guest_agent)</a>.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><b><i><span style="font-size:11.0pt">I’d like to know whether Masakari project leaders would consider a blueprint on “VM Heartbeat / Health-check Monitoring”.<o:p></o:p></span></i></b></p>
<p class="MsoNormal"><span style="font-size:11.0pt">See below for some more details,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">Greg.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">-------------------------------------<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;color:black">VM Heartbeating / Health-check Monitoring would introduce intrusive / white-box type monitoring of VMs / Instances to Masakari.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;color:black"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;color:black">Briefly, “<u>VM Heartbeat / Health-check Monitoring</u>”</span><span style="color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:36.0pt;text-indent:-18.0pt"><span style="font-size:11.0pt;color:black">·</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">         </span><span style="font-size:11.0pt;color:black">is optionally
 enabled thru a Nova flavor extra-spec,</span><span style="color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:36.0pt;text-indent:-18.0pt"><span style="font-size:11.0pt;color:black">·</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">         </span><span style="font-size:11.0pt;color:black">is a service
 that runs on an OpenStack Compute Node,</span><span style="color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:36.0pt;text-indent:-18.0pt"><span style="font-size:11.0pt;color:black">·</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">         </span><span style="font-size:11.0pt;color:black">it sends
 periodic Heartbeat / Health-check Challenge Requests to a VM<br>
over a virtio-serial-device setup between the Compute Node and the VM thru QEMU,<br>
( <a href="https://wiki.libvirt.org/page/Qemu_guest_agent">https://wiki.libvirt.org/page/Qemu_guest_agent</a> )</span><span style="color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:36.0pt;text-indent:-18.0pt"><span style="font-size:11.0pt;color:black">·</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">         </span><span style="font-size:11.0pt;color:black">on loss
 of heartbeat or a failed health check status will result in fault event, against the VM, being <br>
reported to Masakari and any other registered reporting backends like Mistral, or Vitrage.</span><span style="color:black"><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Times New Roman";color:black"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;color:black">I realize this is somewhat in the gray-zone of what a cloud should be monitoring or not,</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;color:black">but I believe it provides an alternative for Applications deployed in VMs that do not have an external monitoring/management entity like a VNF Manager in the MANO architecture.</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;color:black">And even for VMs with VNF Managers, it provides a highly reliable alternate monitoring path that does not rely on Tenant Networking.</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;color:black"> </span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;color:black">VM HB/HC Monitoring would leverage  <a href="https://wiki.libvirt.org/page/Qemu_guest_agent"><span style="color:purple">https://wiki.libvirt.org/page/Qemu_guest_agent</span></a></span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;color:black">that would require the agent to be installed in the images for talking back to the compute host.</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;color:black">( there are other examples of similar approaches in openstack ... the murano-agent for installation, the swift-agent for object store management )</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;color:black">Although here, in the case of VM HB/HC Monitoring, via the QEMU Guest Agent, the messaging path is internal thru a QEMU virtual serial device.  i.e. a very simple interface with very few dependencies
 ... it’s up and available very early in VM lifecycle and virtually always up.</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;color:black"> </span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;color:black">Wrt failure modes / use-cases</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:36.0pt;text-indent:-18.0pt"><span style="font-size:11.0pt;font-family:"Times New Roman";color:black">·</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">         </span><span style="font-size:11.0pt;color:black">a
 VM’s response to a Heartbeat Challenge Request can be as simple as just ACK-ing,<br>
this alone allows for detection of:</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:72.0pt;text-indent:-18.0pt"><span style="font-size:11.0pt;font-family:"Courier New";color:black">o</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">    </span><span style="font-size:11.0pt;color:black">a
 failed or hung QEMU/KVM instance, or</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:72.0pt;text-indent:-18.0pt"><span style="font-size:11.0pt;font-family:"Courier New";color:black">o</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">    </span><span style="font-size:11.0pt;color:black">a
 failed or hung VM’s OS, or</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:72.0pt;text-indent:-18.0pt"><span style="font-size:11.0pt;font-family:"Courier New";color:black">o</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">    </span><span style="font-size:11.0pt;color:black">a
 failure of the VM’s OS to schedule the QEMU Guest Agent daemon, or</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:72.0pt;text-indent:-18.0pt"><span style="font-size:11.0pt;font-family:"Courier New";color:black">o</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">    </span><span style="font-size:11.0pt;color:black">a
 failure of the VM to route basic IO via linux sockets.</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:36.0pt;text-indent:-18.0pt"><span style="font-size:11.0pt;font-family:"Times New Roman";color:black">·</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">         </span><span style="font-size:11.0pt;color:black">I
 have had feedback that this is similar to the virtual hardware watchdog of QEMU/KVM (<a href="https://libvirt.org/formatdomain.html#elementsWatchdog"><span style="color:purple">https://libvirt.org/formatdomain.html#elementsWatchdog</span></a> )</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:36.0pt;text-indent:-18.0pt"><span style="font-family:"Times New Roman";color:black">·</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">         </span><span style="font-size:11.0pt;color:black">However,
 the VM Heartbeat / Health-check Monitoring</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:72.0pt;text-indent:-18.0pt"><span style="font-family:"Courier New";color:black">o</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">   </span><span style="font-size:11.0pt;color:black">provides
 a higher-level (i.e. application-level) heartbeating</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:108.0pt;text-indent:-18.0pt"><span style="font-family:Wingdings;color:black">§</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">  </span><span style="font-size:11.0pt;color:black">i.e. if
 the Heartbeat requests are being answered by the Application running within the VM</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:72.0pt;text-indent:-18.0pt"><span style="font-family:"Courier New";color:black">o</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">   </span><span style="font-size:11.0pt;color:black">provides
 more than just heartbeating, as the Application can use it to trigger a variety of audits,</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:72.0pt;text-indent:-18.0pt"><span style="font-family:"Courier New";color:black">o</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">   </span><span style="font-size:11.0pt;color:black">provides
 a mechanism for the Application within the VM to report a Health Status / Info back to the Host / Cloud,</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:72.0pt;text-indent:-18.0pt"><span style="font-family:"Courier New";color:black">o</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">   </span><span style="font-size:11.0pt;color:black">provides
 notification of the Heartbeat / Health-check status to higher-level cloud entities thru Masakari, Mistral and/or Vitrage</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal" style="margin-left:108.0pt;text-indent:-18.0pt"><span style="font-family:Wingdings;color:black">§</span><span style="font-size:7.0pt;font-family:"Times New Roman";color:black">  </span><span style="font-size:11.0pt;color:black">e.g.   VM-Heartbeat-Monitor
 - to - Vitrage - (EventAlarm) - Aodh - ... - VNF-Manager<br>
                                                                                - (StateChange) - Nova - ... - VNF Manager</span><span style="font-family:"Times New Roman";color:black"><o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Times New Roman";color:black"> <o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Times New Roman";color:black">NOTE: perhaps the reporting to Vitrage would be a separate blueprint within Masakari.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-family:"Times New Roman""><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
</div>
</body>
</html>