<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
<html><body>
<p>New Hawkular blog post from noreply@hawkular.org (Edgar Hernández): http://ift.tt/2ygxRgx<br><br></p>
<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
<p>Hawkular project includes an alerting module that can be used to send notifications when certain conditions are met. The alerting module is bundled in Hawkular Middleware Manager (aka. Hawkular Services)</p>
</div>
<div class="paragraph">
<p>ManageIQ also has alerting capabilities and Hawkular Middleware Manager integrates to it. Once Hawkular is added as a provider, ManageIQ alerting features can be used to monitor servers managed by Hawkular.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_manageiq_alerting_terminology">ManageIQ alerting terminology</h2>
<div class="sectionbody">
<div class="paragraph">
<p>In ManageIQ, two terms are used:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">Alert</dt>
<dd>
<p>Defines the which type of infrastructure item should be monitored, the conditions and the actions to take when the conditions are met.</p>
</dd>
<dt class="hdlist1">Alert profile</dt>
<dd>
<p>It is a relation between a set of alerts and a set of infrastructure items. The set of alerts in the profile will all be applied to the set of infrastructure items. If any of the infrastructure items met the conditions in one of the alerts, the actions of the alert will run.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>ManageIQ has support for several types of infrastructure items, but Hawkular Middleware Manager supports only a subset of them. Middleware servers are an example of infrastructure items that are supported by Hawkular.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_hawkular_alerting_terminology">Hawkular alerting terminology</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Hawkular’s alerting module has several kinds of objects (and terms). The two objects that are relevant from a ManageIQ perspective are:</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">Group trigger</dt>
<dd>
<p>Defines the set of conditions that should be met to fire an alert or an event. A group trigger is a template and no alert nor events will be fired until a member is added to it.</p>
</dd>
<dt class="hdlist1">Group member</dt>
<dd>
<p>It’s an association of a group trigger with the actual data to be evaluated. Internally to Hawkular, group members are managed instances of group triggers. Changes to the group trigger are pushed down to the members.</p>
</dd>
</dl>
</div>
<div class="paragraph">
<p>Currently, ManageIQ creates group triggers that raise events (not alerts) and polls Hawkular to catch the events and run configured actions, if needed.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_terminology_relationships">Terminology relationships</h2>
<div class="sectionbody">
<div class="paragraph">
<p>When a user creates a ManageIQ alert, a Hawkular group trigger is created in the background. From then, any changes to the ManageIQ alert are replicated to the associated Hawkular group trigger until the alert is deleted, which causes the group trigger to also be deleted.</p>
</div>
<div class="paragraph">
<p>While ManageIQ alerts have a direct relation with Hawkular group triggers, ManageIQ alert profiles are a little bit more complicated. For each alert in a ManageIQ profile, one Hawkular group member is created for each infrastructure item in the profile.</p>
</div>
<div class="paragraph">
<p>This means that nothing is created in Hawkular if:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>The alert profile is empty (has no alerts nor infrastructure items)</p>
</li>
<li>
<p>The alert profile has alerts but has no infrastructure items</p>
</li>
<li>
<p>The alert profile has infrastructure items but has no alerts</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>If a ManageIQ alert profile has one alert and has assigned multiple infrastructure items, then the relevant Hawkular group trigger will have as many members as infrastructure items are in the ManageIQ alert profile.</p>
</div>
<div class="imageblock">
<div class="content"><img src="http://ift.tt/2yZoejL" alt="Mapping of a ManageIQ alert profile with one alert and three infrastructure items" width="500"></div>
</div>
<div class="paragraph">
<p>If a ManageIQ alert profile has multiple alerts and has assigned only one infrastructure item, then each Hawkular group trigger will have one member.</p>
</div>
<div class="imageblock">
<div class="content"><img src="http://ift.tt/2zfRnIk" alt="Mapping of a ManageIQ alert profile with three alerts and one infrastructure item" width="500"></div>
</div>
<div class="paragraph">
<p>With these two examples, you should be able to guess what will happen if the ManageIQ alert profile has a set of alerts and a set of infrastructure items.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_creating_manageiq_alerts">Creating ManageIQ alerts</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Alerts are created by navigating to <em>Control > Explorer > Alerts</em>. In the alerts tree, select the <em>All alerts</em> folder. This will enable the <em>Add a New Alert</em> option under the <em>Configuration</em> button.</p>
</div>
<div class="imageblock">
<div class="content"><img src="http://ift.tt/2yZoeQN" alt="Create new ManageIQ alert" width="550"></div>
</div>
<div class="paragraph">
<p>In the form to create/edit an alert, be sure to select <em>Middleware server</em> in the <em>Based On</em> field. Currently, this is the only infrastructure item supported by Hawkular. If you choose something else, the alert won’t be managed by Hawkular. All other options can be filled as desired.</p>
</div>
<div class="imageblock">
<div class="content"><img src="http://ift.tt/2zfRofm" alt="Form to create new ManageIQ alert"></div>
</div>
<div class="paragraph">
<p>When the alert is created, it will be available in the control explorer and will be available to be included in an alert profile. In the background, a Hawkular group trigger is also created.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_creating_an_alert_profile">Creating an alert profile</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Alert profiles are created by navigating to <em>Control > Explorer > Alert Profiles</em>. In the alerts tree, select the <em>Middleware server Alert Profiles</em> item. This will enable the <em>Add a Middleware Server Alert Profile</em> option under the <em>Configuration</em> button.</p>
</div>
<div class="imageblock">
<div class="content"><img src="http://ift.tt/2yZofnP" alt="Create new ManageIQ alert profile" width="750"></div>
</div>
<div class="paragraph">
<p>In the form to create/edit an alert profile, write a description and select the desired alerts to evaluate. At least, one alert is required to be able to create the alert profile.</p>
</div>
<div class="imageblock">
<div class="content"><img src="http://ift.tt/2zfRoMo" alt="Form to create new ManageIQ alert profile" width="600"></div>
</div>
<div class="paragraph">
<p>When the alert profile is created, it will be available in the control explorer which will also list the alerts contained in the profile. Nothing will be created in Hawkular because when the profile is created it is still not assigned to middleware servers.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_assigning_middleware_servers_to_an_alert_profile">Assigning middleware servers to an alert profile</h2>
<div class="sectionbody">
<div class="paragraph">
<p>To assign middleware servers to an alert profile, select the desired profile in the control explorer. In the toolbar, use the <em>Edit assignments for this Alert Profile</em> options under the <em>Configuration</em> button.</p>
</div>
<div class="imageblock">
<div class="content"><img src="http://ift.tt/2yYZwAh" alt="ManageIQ edit assignments option for alert profiles" width="500"></div>
</div>
<div class="paragraph">
<p>This will show the assignments page. An alert profile can be assigned to specific middleware servers or to all inventoried middleware servers (The Enterprise).</p>
</div>
<div class="imageblock">
<div class="content"><img src="http://ift.tt/2zfNRhp" alt="ManageIQ edit assignments screen for alert profiles" width="340"></div>
</div>
<div class="paragraph">
<p>Once you have chosen the desired middleware servers (or the enterprise) and changes are saved, the view page of the alert will be displayed again.</p>
</div>
<div class="paragraph">
<p>In the background, Hawkular group members will be created to make effective the configuration and alerts should start triggering.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_viewing_alerts_in_the_timeline">Viewing alerts in the timeline</h2>
<div class="sectionbody">
<div class="paragraph">
<p>The timeline of ManageIQ Hawkular provider will log events if the configuration of an alert is enabled to show timeline events. Hawkular’s provider timeline can be accessed through the summary page of the provider, under the <em>Monitoring</em> menu:</p>
</div>
<div class="imageblock">
<div class="content"><img src="http://ift.tt/2yZohfr" alt="ManageIQ Hawkular provider timeline menu button" width="700"></div>
</div>
<div class="paragraph">
<p>If the alert has enabled the standard <em>Show on Timeline</em> configuration, the options to query the events are:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Event type: Management Events</p>
</li>
<li>
<p>Category: Alarm/Status Change/Errors</p>
</li>
</ul>
</div>
<div class="imageblock">
<div class="content"><img src="http://ift.tt/2zfRrry" alt="Hawkular timeline alerts" width="700"></div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_conclusion">Conclusion</h2>
<div class="sectionbody">
<div class="paragraph">
<p>ManageIQ and Hawkular, albeit being two independent projects, they can be connected together to complement each other features. In this post is discussed how the alerting integration works and how to configure a basic alert.</p>
</div>
<div class="paragraph">
<p>At the time of writing, ManageIQ supports only <em>Middleware Servers</em> as targets and, also, only a limited set of metrics is available to configure alerts. There is ongoing work to provide a wider range of metrics and this is expected to be available in following versions.</p>
</div>
</div>
</div>
<br><br>
from Hawkular Blog
</body></html>