<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><p><strong>In this guide we will cover:</strong></p><p><strong>- What is the Nagios XI Integration?</strong></p><p><strong>- Connecting to Nagios XI</strong></p><p><strong>- Receiving Alerts</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the Nagios XI Integration?</span></strong></p><p>Nagios XI can be integrated with Halo to create tickets for alerts sent from Nagios XI, matching these to assets to provide easy to digest information on the issue presented.</p><p><br></p><p><strong><span style="font-size: 14pt;">Connecting to Nagios XI</span></strong></p><p><br></p><p>Navigate to Configuration > Integrations, and hover over the Nagios XI module. Click the "plus" icon to enable it.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImI0M2FhNDU4LTc1MzktNDkwYS1hOWVmLWI1OWZhMTlkMDlmOSJ9.rV7Nn-s0wktbTXXUxOrYkIRLgydM1Em_o3Qm6ImUs-0" class="fr-fic fr-fil fr-dib" width="342" height="151"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enabling the Nagios XI integration.</span></strong></p><p><br></p><p>Clicking into this, you will see a "Password" field near the top. Create your own password, and remember this. It will need to be added to the curl in Nagios XI to validate the request.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImYyY2IyNTdlLWNiODctNDk2Yi1hYzVhLWIyZmJmY2Y0NTM1YSJ9.znAmyDRZlNONUQn0ma5pg-D7PABbB5Ooe22GtO6Lw-0" class="fr-fic fr-fil fr-dib" width="678" height="99"></p><p><strong><span style="font-size: 10pt;">Fig 2. Creating a password.</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Mappings</span></strong></p><p>Underneath, you can set the Ticket Type that the Alerts will be logged under, and the End-User to log the Alerts against.</p><p><br></p><p>You can also map different states from Nagios XI into Halo Priorities. Each status mapped here will create a Ticket of the corresponding Priority if detected.</p><p><br></p><p>Fields to use for Asset matching can be set if "ip_address" and/or "hostname" is included in the JSON of the curl. This is the field in Halo that will be scanned for the matching data. This will also create a "faultdevice" record within Halo, and if the field "Asset" is added to the Ticket Type, it will appear as a "Related Asset". </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjJmZGY1ZDdjLTdiMDMtNDY4ZS1iMmYxLWJlZmY5Yzk3ZTExMyJ9.z2rZJOHjnRTknocjwz1sivR0jPTTHNncd-W_xVqyu_w" class="fr-fic fr-fil fr-dib" width="1224" style="width: 1226px; height: 509.863px;" height="510"></p><p><strong><span style="font-size: 10pt;">Fig 3. Setting Priority mappings and matching fields.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Receiving Alerts </span></strong></p><p id="isPasted">In Nagios XI, an outgoing webhook will need to be created for the "Host-Alert" and "Service-Alert" events. Nagios XI will then send this curl to Halo to create the Alert when any of the mapped statuses are detected.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY1YTU4OTk0LTM3M2ItNDhhMy1iZmI2LTI3MWY1NjZiOGVhMCJ9.o6AUFC7Dn-tasbzTKcoBXflc1-jP4hyfwKrhVbfkqZI" class="fr-fic fr-fil fr-dib" width="704" height="187"></p><p><strong><span style="font-size: 10pt;">Fig 4. Alert events.</span></strong></p><p><br></p><p>The password created previously will need to be added to <strong>both </strong>curls to authorise them, in the gap shown here<strong> "Authorization: {Use Password token here without these brackets}"</strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU4YTU3NzhlLTEwNDAtNGU4Ni1iNTNkLTFkYzA2N2M1ODQzYyJ9.7y1PM7-gXzP4SsLlKXYgavQkfAG7jjcl9TmMwvni9Sk" class="fr-fic fr-fil fr-dib" width="707" height="382"></p><p><strong><span style="font-size: 10pt;">Fig 5. Curl request for the Host-Alert.</span></strong></p><p><br></p><p>When Alert Tickets are created, "description" will be used as the Ticket Summary by default. If this is not populated, "hostname" will be used.</p><p><br></p><p id="isPasted">Alerts match on "metric_name", "problem_id" and "hostname". If these are all the same it will relate to the same ticket, and Alert updates will be added as Actions on the raised Ticket. Status updates will be posted as Actions to the same Ticket.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc0NjM0ODkwLTgzMTMtNDdiYi04MGJjLTI5ODFjMjczNjczMCJ9.VEg3Qkb2wA_U7qbkeMziAaeU9HS7853thUkRoI0W8fM" class="fr-fic fr-fil fr-dib" width="390" height="567"></p><p><strong><span style="font-size: 10pt;">Fig 6. Alert ticket logged.</span></strong></p><p><br></p><p id="isPasted">"Up" and "Ok" are statuses that will resolve an Alert with a detailed Action to close the Ticket. If another Alert is then triggered with "metric_name", "problem_id", and "hostname" all the same, another Ticket will be created.</p>
