<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 data-pasted="true"><strong>In this guide we will cover:</strong></p><p><strong>- What is the Opsgenie Integration?</strong></p><p><strong>- Enabling the Opsgenie Integration</strong></p><p><strong>- Creating an API Key in Opsgenie</strong></p><p><strong>- Triggering the Runbook</strong></p><p><br></p><p><br></p><p data-pasted="true"><strong><span style="font-size: 14pt;">What is the Opsgenie Integration?</span></strong></p><p>The Opsgenie integration can create an alert in Opsgenie when a P1 ticket is raised in Halo.</p><p><br></p><p><strong><span style="font-size: 14pt;">Enabling the Opsgenie Integration</span></strong></p><p>In Configuration > Integrations, find the Opsgenie module in the "Incident Management" section. Hover over the module, and click the plus "+" icon to enable it.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdjMzFjZjVjLTk3YWYtNGJmYS1hMjhkLTc3OGY3ZGEzNTVjZSJ9.ixTIGRseGSwnsYQ1kKd5G-ZLYAfSDKAxb8OLlzhR8nU" class="fr-fic fr-fil fr-dib" width="245" height="149"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enabling the module</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Creating an API Key in Opsgenie</span></strong></p><p>Clicking into the Opsgenie module, the credentials can be set here.</p><p><br></p><ul><li><strong>Region: </strong>Region your Opsgenie instance uses.</li><li><strong>Instance URL:</strong> URL of your Opsgenie instance.</li><li><strong>API Key: </strong>The API key from the "Settings" page in Opsgenie.</li></ul><p><br></p><p>API Keys are <a href="https://support.atlassian.com/opsgenie/docs/api-key-management/" target="_blank" rel="noopener noreferrer"><strong>generated in Opsgenie</strong></a>, and if linked to a specific team in Opsgenie, will automatically set the responder for the alert.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFkNDkzNDRiLTI1NjQtNDBjMy05YTNhLThlYThjM2IwZWJmYSJ9.PEBPiwHnAL2zH8iiibdxuLrdO2Y9m8F3YafE-3QPzWw" class="fr-fic fr-fil fr-dib" width="605" height="383"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 2. Connecting to Opsgenie</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Triggering the Runbook</span></strong></p><p>Once connected, click the "Opsgenie Runbook" button to view the runbook. This is downloaded when enabling the module, so ensure that has been done first.</p><p><br></p><p>This runbook can also be found by navigating to Configuration > Integrations > Custom Integrations > Integration Runbooks > "Opsgenie Alert".</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImYxYjYyYWUxLWRiN2EtNDYzMC1hMmUwLTUyOTNhOGY0MWJjNyJ9.5OM28LPFCqz0G-NIlxSqH7Idc9koCYElNb8i2IAB_RM" class="fr-fic fr-fil fr-dib" width="880" height="168"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 3. Navigating to the runbook</span></strong></p><p><br></p><p>The Opsgenie runbook is configured to create an alert in Opsgenie, then update the Halo ticket with the ID of the alert in Opsgenie. If any other behaviours are desired, such as closing the alert once resolved, the runbook can be edited accordingly. The contents of the alerts can also be customised the same way.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE4MTlmMjNmLWEyN2EtNGUzMi04MDAzLWEyNjFlNTMzMzlkNSJ9.V2e0HLmVmJWtGFqAidP0UFKEV84X96TX1w61Uy49OAg" class="fr-fic fr-fil fr-dib" width="1301" height="594"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 4. Opsgenie runbook</span></strong></p><p><br></p><p>In the "Details" tab, use the "Events" table to configure when the runbook will trigger. For example, this one will run whenever a P1 ticket is logged in Halo. The body of the runbook step is configured to log a P1 alert in Opsgenie, so this will match the best.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjVhMWY1ZmRiLTBmZTctNDlkZi05NDMxLTEwZmFjMzAwNTE3ZiJ9.TZpjoMt0_yal_lMBcA5e99CmDvaPvGCyK5V5Jyu1-QI" class="fr-fic fr-fil fr-dib" width="1699" style="width: 1701px; height: 311.516px;" height="312"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 5. Triggering the runbook</span></strong></p><p><br></p><p>Tickets that have an Opsgenie alert logged from them will show the Opsgenie ID in the "Third Party ID" field, and this will link to the alert in Opsgenie.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFlYjVjMjEwLWQyZTktNDAwMi04YTQyLTM2YWRmZjhmMDllNiJ9.F-9nFuEOTGd3HkTYjMlZYBp6cpHIFAhfRfvfXh18Vfc" class="fr-fic fr-fil fr-dib" width="237" height="276"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 6. Opsgenie ID and link showing in the ticket details</span></strong></p><p><br></p>
