Integrating with TrueSight Operations Management

TrueSight Operations Management is a software that enables you to monitor performance and availability of the infrastructure and applications that comprise your services; monitor events coming from the infrastructure devices; and monitor transactions from the applications that enable the services they deliver. As a tenant administrator, you use BMC Helix Developer Tools to add, edit, and delete integrations with TrueSight Operations Management.

Before you begin

Ensure that you have downloaded and installed the connector. Without downloading the connector, you cannot proceed with the integration.

Important

Download the script on a docker-enabled Linux server.
Confirm that the TrueSight Operations Management host is accessible from your docker-enabled Linux server.

To integrate with TrueSight Operations Management

Log on to BMC Helix Portal, and click Launch on
BMC Helix Developer Tools
.
Click Available integrations.
On the TrueSight Operations Management tile, click Configure.
Enter the following source details:
- Integration Name: Provide a name for the integration.
- Select Connector: Select the connector you have downloaded. If you didn't download the connector earlier, click Add Connector to download and install the connector.
- User Name and Password: Enter the administrator credentials for the product to be integrated.
- API URL: Add the following information:
  - If TrueSight Operations Management is deployed in a high-availability environment, enter the URL of the TrueSight Presentation Server load balancer.
  - If TrueSight Operations Management is not deployed in a high-availability environment, enter the TrueSight Presentation Server URL.
- Tenant Name: Enter the name of the tenant where TrueSight Operations Management is installed.
- Refresh Time For Event In Seconds: Enter the time interval in seconds to refresh the event data.
- Refresh Time For CI In Hours: Enter the time interval in hours after which the TrueSight Operations Management CI is refreshed.
- Select entities to be registered: Select one or all of the available entities to view their data. You can view the data in BMC Helix Dashboards.
Click Configure.
The added integration appears in the Configured Integrations tab.

To view the configured integration

You can view the configured integrations on the Configured Integrations tab, as shown in the following example:

The configured integration shows the following details:

The name of the integration with its build number.
The incoming data. In this example, 25 CIs and 1,572 events have been received.
The name of the user who modified the integration along with the time of the modification. In this example, it is the admin user.
The connector status. In this example, the status is Active.

To validate the TrueSight Operations Management integration

Ensure that the status of the integration is Connected. The following statuses are also valid:
- Configuring
- Disabled
- Disconnected
From BMC Helix Operations Management, go to Events to ensure that you can see events in BMC Helix Operations Management.
For more information, see Event monitoring.
From BMC Helix Discovery, go to Explore > Data, and then click <number> Import Records in the Miscellaneous section to ensure that you can see the records from the source (host) in BMC Helix Discovery. Use these records further to create a business service model for the source depending on your use case requirements in BMC Helix AIOps. For more information, see Creating a model.

TrueSight Operations Management event slot mapping

The following table shows the event slot mapping between TrueSight Operations Management and BMC Helix Operations Management.

TrueSight Operations Management enum mapping

The following table shows the enum mapping between TrueSight Operations Management and BMC Helix Operations Management.

Frequently asked questions on the TrueSight Operations Management integration

This section provides answers to frequently asked questions.

Why do I see a difference between the number of entities available in the third-party solution and the number of entities fetched in BMC Helix AIOps?

After the specified time interval, BMC Helix AIOps fetches all CIs and event data from the third-party products, even if the data is already fetched in the previous cycle. Therefore, the CIs and events fetched in BMC Helix AIOps appear to be more than the number of CIs and events present in the third-party product. This situation causes no impact on performance.

Why are event classes not created in BMC Helix AIOps?

Event classes might not be created because of an event slot conflict or because the enums in custom classes were not created. To resolve this issue, see Troubleshooting-the-TrueSight-Operations-Management-integration.

Why can't I see events with read-only or internal slots in BMC Helix AIOps?

To view these events, you must add the read-only or internal slots to the event_slot_mapping.json file. For more information, see Troubleshooting-the-TrueSight-Operations-Management-integration.

Are events from the TrueSight Infrastructure Management remote cell propagated to BMC Helix AIOps?

No. Events from the TrueSight Infrastructure Management remove cell are not propagated to BMC Helix AIOps.

Why are the TrueSight Infrastructure Management events missing if the integration was disabled for more than three days?

By default, the BMC Helix Developer Tools collects the historical event data for the last three days (72 hours) only from TrueSight Infrastructure Management. If you disable the TrueSight Infrastructure Management integration and enable it after three days, the maximum historical event data collected is available only for the last three days. For example, If you disabled the integration on July 10th, and enabled it on July 20th, you will see the historical data is from July 17th to July 20th only (for the last three days or 72 hours). Any historical event data before the last three days is not collected.