<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><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 LogicMonitor Integration?</strong></p><p><strong>- Connecting to LogicMonitor</strong></p><p><strong>- Asset Import</strong></p><p><strong>- Alert Processing</strong></p><p><strong>- Halo Integrator</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the LogicMonitor Integration?</span></strong></p><p id="isPasted">LogicMonitor can be integrated with Halo to import and manage assets, as well as create alert tickets matched to the asset.</p><p><br></p><p><strong><span style="font-size: 14pt;">Connecting to LogicMonitor</span></strong></p><p>Create a ‘Halo’ User in LogicMonitor.<br><br></p><p>Enable the integration module in Halo, by navigating to Configuration > Integrations > Asset Management and Alerting.</p><p><br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE3Y2JmZjBjLTU0MTktNDFkZC1iYzk3LWRhMzhhZDQ1YTQ3OCJ9.d_b3Bm79xZKWojDgn23PFcywyO9iqmZjVQUL404W-3I" class="fr-fic fr-fil fr-dib" width="530" height="247"><strong><span style="font-size: 10pt;">Fig 1. Enabling the module</span></strong></p><p><br></p><p>Under the Halo User, there will be an ‘API Tokens’ Section (<a href="https://www.logicmonitor.com/support/settings/users-and-roles/api-tokens#:~:text=Token%20Type%20field.-,In%20the%20User%20field%2C%20select%20an%20email%20address%20for%20log,it%20to%20a%20secure%20location." rel="noopener noreferrer" target="_blank"><strong>guide here</strong></a>). In this section, you will need to retrieve the Access Key and Access ID, and input them into the below Halo fields (found in LogicMonitor Integration section).</p><p><br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImY0NmMzZmYxLTU2OTUtNDQ0Zi1iMDkzLTRjZDBmYzc2MGNjYiJ9.uUcRg26IJjETFpdV-Tr8VwrueVu5PMC50vPpM9Y5GKc" class="fr-fic fr-fil fr-dib" width="745" style="width: 747px; height: 154.21px;" height="154"><strong><span style="font-size: 10pt;">Fig 2. Entering the details</span></strong></p><p><strong><span style="font-size: 10pt;"><br></span></strong></p><p>Next, you will need to input your LogicMonitor URL into the Halo URL field.<br><br><strong><span style="font-size: 14pt;">Asset Import</span></strong></p><p>You will need to map your assets in the ‘Asset Imports’ section in the Halo LogicMonitor Integration page.</p><p><br></p><p>To map assets, first choose a matching field (we recommend serial number as this will be unique to each asset).</p><p><br></p><p>Also choose a default site in Halo for any assets that are imported. LogicMonitor Alerts created with webhooks will now match the Site from the Device if not matched using halo_customer_name or halo_customer_id properties.</p><p><br></p><p>Then you will need to determine how assets imported from LogicMonitor are assigned an asset type in Halo. </p><p><br></p><p><strong><span style="font-size: 12pt;">Determine an Asset's Type</span></strong></p><p>When assets are imported from LogicMonitor a new asset in Halo will be created, as all assets in Halo must have an asset type we will need to configure how the type of new assets created from LogicMonitor are determined. This is done using the 'Determining an Asset's type' field. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImI5YTU4YWExLTY5OTAtNDUxZC05MWRjLWRkNDE3ZmEwNmEwMCJ9.ERQEq-MNtIwd-uJA8iElD13GDsW5gijUi2h6cQ62x4E" class="fr-fic fr-fil fr-dib" width="767" height="167"></p><p><strong><span style="font-size: 10pt;">Fig 3. Field to set how an Asset's Type is determined</span></strong></p><p><br></p><p data-pasted="true"><strong>Use the same type for all Assets</strong></p><p>If you would like all imported assets to have the same asset type when imported set the 'Determining an Asset's type' field to be 'use the same type for all Assets' then set the 'Asset Type' field to be the asset type you would like assets from LogicMonitor to be.</p><p><br></p><p data-pasted="true"><strong>Use a field to determine each Asset's type</strong></p><p>If you would like all imported assets' types to be determined by a particular field, set the set the 'Determining an Asset's type' field to be 'Use a field to determine each Asset's type'. Then in 'Field for determining an Asset's type' choose the field you would like the type to depend on. The field you choose must contain the name of the desired asset type, if this name can be matched to an existing asset type in Halo, it will be assigned this asset type. If the name is not the same as an asset type in Halo, a new asset type will be created. Note that the names must be identical in order to match. This setting is used if you have a field in LogicMonitor that already determines an asset's type and you would like the types to be consistent between Halo and LogicMonitor. You will still need to populate the default asset type and group fields as assets that do not have the selected field populated will be imported as the default asset type. </p><p><br></p><p>In the Figure 4 example new assets will be assigned to an asset type in Halo based on their 'deviceTypeName' field. If the data in the deviceTypeName field matches the name of an asset type in Halo this asset will be created under the matched asset type. If a match cannot be made a new asset type will be created, under the asset group 'Network Equipment'. If the asset does not have the 'productType' field populated the asset will be created under the default asset type, 'Workstation'. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFiMzcwNjg4LWFmODktNDM1Ny1iMmEyLTMyM2EwMThmMTc4NSJ9.L9eAr5NxpPuX3V5KFh9ChkMEoID3FlUZn_Nwn2Yoy7I" class="fr-fic fr-fil fr-dib" width="1938" style="width: 1940px; height: 293.745px;" height="294"></p><p><strong><span style="font-size: 10pt;">Fig 4. Using field to determine asset's type example</span></strong></p><p><br></p><p data-pasted="true"><strong>Determine Asset type using rules</strong></p><p>If you would like asset types to be determined by asset rules set the set the 'Determining an Asset's type' field to be 'Determine asset type using rules'. Now you will be able to set asset's types based on rules, These rules are based on field values, and if matched will assign an asset to the chosen asset type. When creating a rule first add criteria for the rule, select the Halo field that you would like to base the criteria on, then set the rule type and the outcome needed in the field to match the rule. If an asset matches this rule it will be imported as this asset type.</p><p><br></p><p>If an asset is imported that does not match any of these rules, it will be created under the default asset type. Alternatively, if you would like to not import assets that do not match these rules, set the 'Default Asset type' to 'Don't import assets that do not match any rules'.</p><p><br></p><p>Once you have setup how asset types are determined, set up the field mappings in the "Field Mappings" table.</p><p><br></p><p><strong><span style="font-size: 12pt;">Field Mappings</span></strong></p><p>In the field mappings table you can map Halo asset fields to LogicMonitor fields.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjA4NmJhM2MxLWZiNGYtNDJhMy1iMjlmLTdkYmYzYmU3NjY4MiJ9.jmTqGDCPa2Qihwsu_Xs7jNYHBqll9buuYdxsMtTjQqY" class="fr-fic fr-fil fr-dib" width="1854" style="width: 1856px; height: 336.188px;" height="336"></p><p><strong><span style="font-size: 10pt;">Fig 5. Add new Field Mapping</span></strong></p><p><br></p><p>When creating a mapping choose the type of LogicMonitor field you would like to map, such as if it is a standard property or auto property. This filters the results in the "LogicMonitor Field" selection, making it easier to choose.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRkMTVjZDVhLTg3OTUtNDIwOC05MDcwLTA0YmZkZWQ1ZWM4NSJ9.SrrEj2KqUuY7pnhtLyDwriY5E1H5mLkK9_HIZnF-Afk" class="fr-fic fr-fil fr-dib" width="617" style="width: 619px; height: 493.293px;" height="493"></p><p><strong><span style="font-size: 10pt;">Fig 6. Example Field Mapping</span></strong></p><p><br></p><p><strong><em>Note: Custom properties in LogicMonitor can be imported into Halo. </em></strong></p><p><br></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;" data-pasted="true"><strong>Field Type -</strong> This will be the type of Halo field the data will be imported into. See our guide on <a href="https://usehalo.com/haloitsm/guides/1785/" target="_blank" rel="noopener noreferrer">Asset Fields</a> if you are unsure on the difference between asset fields and custom fields in Halo.</p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;"><br></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;">Now choose the Halo field to map this to.</p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;"><br></p><p data-pasted="true"><strong>Only apply this mapping to new Assets and Assets where the Asset field does not currently have a value -</strong> When this is enabled if the Halo field already has data within it, different to the data in the mapped LogicMonitor field, the field data will not change. Fields will only be populated when they contain no data or when new assets are being created. </p><p><br></p><p>Once mappings are complete, hit "Import Assets".</p><p><br></p><p><strong><span style="font-size: 14pt;">Alert Processing</span></strong></p><p>Tick "Enable alert processing".</p><p><br></p><p>You will now need to create a webhook within LogicMonitor to sent to Halo. To set this up in LogicMonitor, you will need to create a custom HTTP delivery (guide: <a data-fr-linked="true" href="https://www.logicmonitor.com/support/alerts/integrations/custom-http-delivery">https://www.logicmonitor.com/support/alerts/integrations/custom-http-delivery</a>)</p><p><br></p><p>You will need to set up the HTTP method to be ‘Post’ and the URL will need to be ‘HTTPS’ NOT HTTP. The URL will be <a data-fr-linked="true" href="https://support.zuri-tec.com/api/notify/LogicMonitor">https://{Your instance Domain}/api/notify/LogicMonitor</a>. The URL, Username and Password can be found in your Halo LogicMonitor Integration Page.</p><p><br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjBiNDg3Y2MxLTQ3NjAtNGMxNC1hZDNjLWY5MjZkZTAxYzkwYiJ9.HyiXJcMyDEs7UTMapeLXnL2xIlv05KWXxRBW89evM-k" class="fr-fic fr-fil fr-dib" width="646" style="width: 646px; height: 191.67px;" height="191.67"><strong><span style="font-size: 10pt;">Fig 7. LogicMonitor details</span></strong></p><p><br></p><p>In the ‘Alert data’ section of the custom HTTP delivery setup, you will need to choose ‘Raw’ and the format is ‘JSON’. Then, copy and paste the Custom HTTP Method Raw data from your Halo integration page. (Custom properties can also be added to the body of the JSON and used to match Halo Customer Name and ID with the following format halo_customer_name and halo_customer_id).</p><p><br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImI2NGIzMmYwLTBiMzktNDE1Zi1iNTEzLWJjYjJjMGU0NjY3YSJ9.09Ffa-QBoF6zBIsIpfSEEZtU6eC3GfPO79yCfceRxRk" class="fr-fic fr-fil fr-dib" width="1002" height="94"><strong><span style="font-size: 10pt;">Fig 8. HTTP Method</span></strong></p><p><br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImYzNWI0YTgxLTZlM2UtNDhlZS1iNWYzLWU5YTY3MTMyZWM2OSJ9.K3JutWxZ36WG6kuy7u41JqrMtvdUpzr6NphyYyg1Omg" width="972" height="584" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; text-align: left; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; max-width: none !important;" class="fr-fil fr-dib"><strong><span style="font-size: 10pt;">Fig 9. HTTP settings</span></strong></p><p><br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFhYWZlMDczLTA4YmYtNDc5NS04MDQ0LWU5MTI4ODgyMjIxNCJ9.7ECAHSwxoILNnrfH6LGtI-GSNxcInCBSdfo0EbFNM5k" width="911" height="794" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; text-align: left; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; max-width: none !important;" class="fr-fil fr-dib"><strong><span style="font-size: 10pt;">Fig 10. HTTP settings.</span></strong></p><p><br></p><p>After setting up your custom HTTP Delivery in LogicMonitor you must then include the method as a contact method for a recipient in an escalation change which is itself referenced by an alert rule in LogicMonitor.<br><br></p><p>Finally, you can choose the status for alerts created in Halo, that are cleared in LogicMonitor – usually this is "Closed".</p><p><br></p><p><strong><span style="font-size: 14pt;">Halo Integrator</span></strong></p><p>You can also enable the Halo Integrator to automatically sync the assets.<br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjIwNTg5YTAxLTI4MjEtNDQ3Ny04M2E1LTJjMzJhNDFmNDIzZSJ9.iCWxlpwfS_QXuF4KFztAvpyffKWuCy1aPSZ2KJSRRC0" class="fr-fic fr-fil fr-dib" width="2"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjAwN2M3MDQxLTgyZGMtNDE4Ni1hNWRjLWQ1NzBhMjgzODY3ZiJ9.f9F944oZY5sEW0YQpW-FWkyAl8m9LdagRLP4o8eoaLA" class="fr-fic fr-fil fr-dib" width="466" height="292"></p><p><strong><span style="font-size: 10pt;">Fig 11. Enabling the integrator</span></strong></p><p><br></p>
