ManageEngine Integration

  • Updated
Table of Contents:

The article covers how to enable ManageEngine integration and add an instance to sync entities from ManageEngine to Resolution Intelligence Cloud.

Overview

The ManageEngine integration enables you to sync entities such as laptops, desktops, hosts, and other devices from ManageEngine to Resolution Intelligence Cloud. All synced entities are categorized under the Compute & Devices section, while entities without proper classification are categorized in the Unclassified section.

To set up this integration, you need to obtain an API key, Base URI, and Customer ID from your ManageEngine account. These details are required to complete the integration with Resolution Intelligence Cloud.

When adding an instance, you can define conditions to control which entities are synced to Resolution Intelligence Cloud. Once synced, these entities can be continuously monitored for security threats. You can also configure the sync frequency to determine how often entities are updated on the platform. Any new entities in ManageEngine will sync to Resolution Intelligence Cloud only at the specified frequency. However, you also have the option to manually sync new entities to the platform whenever needed.

Prerequisites

  • API key (a token generated from the ManageEngine account). To learn the instructions to generate an API key, refer to the How to generate an API key article.
  • Customer ID. To learn the instructions to generate a customer ID, refer to the how to get the customer ID  article.
  • Base URI

Enabling ManageEngine integration

Use this procedure to enable ManageEngine Integration to add an instance to ingest entities like desktops, laptops and hosts from ManageEngine.

1. Click Configurations to navigate to the Configurations options.

2. Select Integrations, under the Data Ingestion section to see all the data sources and monitoring tools that you want to integrate.

3. Select CMBD from the list to see only the CMDB sources available to integrate with the platform.

(or) Search for ManageEngine integration in the search box.

4. Click on the ManageEngine card to open. This takes you to the ManageEngine page.

5. Click Add and select Add New Integration to add a new integration to the platform. This enables ManageEngine Integration.

Adding a ManageEngine Instance

Use this procedure to add a ManageEngine instance from where you want to sync entities.

1. Click Add Instance. This opens the Add Instance page.

2. Specify the Instance Details:

Field name Field description
Name The unique name to identify this instance
API key The key used to authenticate each request sent from Resolution Intelligence Cloud to ManageEngine for fetching entities.
Customer ID A unique identifier for the customer whose entities should be synced.
Base URI The base URI of the Manage Engine application. 

3. Under Specify Ingestion Criteria, construct the condition expression. Select a field and operator from the drop-down lists. For the value, select a value from the drop-down list or enter it manually, depending on the field type. The condition is used to determine the records to which the rule will apply.

A condition expression can consist of several phrases, joined by an AND (or) OR. For each phrase, select a field, operator, and value. Click the button to add an additional row. Use the parentheses and AND/OR options to join the phrases together to form a condition expression.

The conditions include the following attributes:

  • Alias Name
  • Created time
  • Updated time
  • Name

4. Under Schedule, choose the frequency at which entities should sync from ManageEngine to the Resolution Intelligence Cloud. 

Timezone: Select the appropriate Timezone at which the sync should happen. (for example, (UTC+05:30) Asia/Kolkata)

Time: Select the appropriate date and time at which the sync should happen.

Repeat: From the drop-down, select the following

  • Monthly: Specify the number of months and the day. (for example, for every 6 months on the 30th day according to the Timezone you selected)
  • Weekly: Specify the day (for example, Every Thursday at 10:AM according to the Timezone you selected)
  • Daily: On every day at a specific time based on the time you have specified

5. Click Validate and Save to save the ManageEngine instance.

Viewing the existing instances

Use this procedure to view ManageEngine instances added to this tenant.

1. Select Integrations, under the Data Ingestion section to see all the data sources and monitoring tools that you want to integrate. This opens the Integrations page where you can see all the enabled and available integrations.

2. Click the ManageEngine card in the Enabled Integrations section. This opens the page where you can see the existing instances.

3. Review this information:

Field name Field description
Name The name of the ManageEngine instance.
Customer ID The unique identifier of the customer whose entities will be synced.
Base URI The base URI of ManageEngine
Created by The user who created this instance. 
Updated by The user who last updated this instance.
Updated on The time stamp at which the instance was last updated. 
Schedule The frequency at which the entities should be synced to the platform. 

You can do the following actions on this page, using the ellipses icon:

Syncing ManageEngine Entities

Use this procedure to sync the ManageEngine entities to the Resolution Intelligence Cloud instantly.

To sync the ManageEngine entities:

  1. Select Integrations, under the Data Ingestion section to see all the data sources and monitoring tools that you want to integrate. This opens the Integrations page where you can see all the enabled and available integrations.
  2. Click the ManageEngine card in the Enabled Integrations section. This opens the page where you can see the existing instances.
  3. Click the ellipses icon corresponding to the ManageEngine instance you want to sync and select Sync now to manually sync any new entities to the Resolution Intelligence Cloud. 

Viewing the job history

Use this procedure to track the job history. This gives you details, such as when the job was performed and what is the outcome of the job.

To view the history of job runs:

  1. Select Integrations, under the Data Ingestion section. This opens the Integrations page where you can see all the enabled and available integrations.
  2. Click the ManageEngine card in the Enabled Integrations section. This displays the existing instances.
  3. Click the ellipses icon corresponding to the ManageEngine instance whose job history you want to view and select Job History. This displays the Job History tab.
  4. Review the following job details:
Field name Field description
Job ID A unique ID generated for every run. Click on the ID to view the job logs. 
Start time The time when the job was started.
End time The time when the job ended.
Execution time The time taken to run a job. 
Status

The status of the job run. Possible values:

  • Success – Indicates that the job run was successful.
  • Failed – Indicates the job has failed to execute successfully.
  • Running – Indicates the job run is in progress.

Note: If the job is failed, you can use the Retry button to re-run the job

Viewing the job logs for a specific job run

Use this procedure to view the job logs of a specific job run. You can use the search box to quickly find the log you need.

To view the history of job runs:

  1. Go to Integrations under the Data Ingestion section. This opens the Integrations page, where you can see all enabled and available integrations.
  2. Click the ManageEngine card in the Enabled Integrations section to view existing instances.
  3. Click the ellipsis icon next to the ManageEngine instance whose job history you want to view, then select Job History. This opens the Job History tab.
  4. Click the Job ID hyperlink of the job whose logs you want to view.
  • Status – Indicates whether the entity was successfully synced to the platform. Possible values: Success or Failed.
  • Message – Provides details on the success or failure of the job.
  • Event Time – The timestamp when the log was generated.

To view real-time logs, click the Refresh button.

To download logs to a CSV file, click Download.

Deleting an Instance

Use this procedure to delete a ManageEngine Instance.

  1. Select Integrations, under the Data Ingestion section. This opens the Integrations page where you can see all the enabled and available integrations.
  2. Click the ManageEngine card in the Enabled Integrations section. This displays the existing instances.
  3. Click the ellipses icon corresponding to the ManageEngine instance you want to delete and select Delete Instance. A pop-up window appears.
  4. Click Yes to delete.

Deleting a schedule

Use this procedure to delete a schedule associated with the ManageEngine instance. You cannot view the Delete schedule option when no schedules are set for this instance.

  1. Select Integrations, under the Data Ingestion section. This opens the Integrations page where you can see all the enabled and available integrations.
  2. Click the ManageEngine card in the Enabled Integrations section. This displays the existing instances.
  3. Click the ellipses icon corresponding to the ManageEngine instance and select Delete Schedule to delete the scheduled job for this instance.
    You can now view the scheduler being removed from this instance.

Modifying the Instance details

Use this procedure to modify the instance details.

  1. Select Integrations, under the Data Ingestion section. This opens the Integrations page where you can see all the enabled and available integrations.
  2. Click the ManageEngine card in the Enabled Integrations section. This displays the existing instances.
  3. Click the ellipses icon corresponding to the ManageEngine instance you want to modify and select Edit Instance. This takes you to the Edit Instance page.
  4. Change the Instance details and Click Validate and Save to validate and save the updated changes.

Deactivating ManageEngine Integration

Use this procedure to deactivate the ManageEngine Integration for the tenant.

  1. Select Integrations, under the Data Ingestion section. This opens the Integrations page where you can see all the enabled and available integrations.
  2. Click the ManageEngine card in the Enabled Integrations section.
  3. Click the ellipses icon and select Deactivate to remove the existing entities from the platform. However, reactivating will retrieve all the entities.

Related articles

Comments

0 comments

Please sign in to leave a comment.