Integrating with TrueSight Intelligence for metric data

Supported till version 11.3.02

TrueSight Intelligence is supported until version 11.3.02 only.

You can integrate TrueSight Intelligence and TrueSight Infrastructure Management to view metric data in TrueSight Intelligence. You can filter based on services, applications, or devices.

The integration is enabled through the TrueSight Intelligence Metric Adapter. Each installation of the adapter can be associated to a single tenant only. To configure the integration for multiple tenants, you must perform multiple installations of the adapter. BMC recommends that you install each instance of the adapter on a separate host computer.

Setting up applications for monitoring Open link

Setting metrics as KPIs for analysis Open link

Performing analytics using data exploration Open link

Performing advanced analytics using machine learning Open link

TrueSight Operations Management component requirements

Component	Required version
TrueSight Presentation Server	11.0.00 or later
TrueSight Infrastructure Management	11.0.00 or later
Java Runtime Environment (JRE)	1.8 or later

To enable the integration

Perform the following steps to enable the integration:

Step #	Details	Reference
1	Download the TrueSight Intelligence Metric Adapter software from the Downloads console.	Log on to the TrueSight console. In the navigation pane, expand Configuration and select Managed Devices. Select the TrueSight Infrastructure Management server where you want to download the software. Click the common action menu and select Launch Downloads console. The Downloads console opens in a new browser tab or window. Select the appropriate TrueSight Intelligence Metric Adapter zip file depending on the operating system, and save the file to the computer on which you want to install the software.
2	Install the TrueSight Intelligence Metric Adapter on the TrueSight Presentation Server, or on a remote computer.	Extract the TrueSight Intelligence Metric Adapter zip file to a folder. On Linux, ensure that the folder name does not contain spaces. For example, TDA. Ensure that the environment variable JAVA_HOME is set to the JRE folder. For example, `JAVA_HOME` is set to `C:\JRE` Set the TrueSight Intelligence Metric Adapter environment variable TDA_HOME to the folder that contains the extracted files. For example, `TDA_HOME` is set to `C:\TDA` Use one of the following options to register the TrueSight Intelligence Metric Adapter as a service: (Windows) Open a command prompt and from the TDA\bin folder, and run the following command: `tda service register` The command creates and starts the Windows service BMC TrueSight Intelligence Metric Adapter automatically after it is successfully registered. (Linux) As a root user, from the TDA/bin folder, type the following command: `./tda service register` The command creates the service BMCTDASvc in /etc/init.d Start the TrueSight Intelligence Metric Adapter by running the following command: `./tda server start`
3	Add the TrueSight Intelligence Metric Adapter as a component in the TrueSight Presentation Server.	Registering the components with the Presentation Server

To manage the TrueSight Intelligence Metric Adapter

Run the following commands from the installedDirectory\bin folder to perform actions on the TrueSight Intelligence Metric Adapter.

Action	Windows	Linux
Register the TrueSight Intelligence Metric Adapter service.	`tda service register`	`./tda service register`(Root user only)
Start the TrueSight Intelligence Metric Adapter	`tda server start`	`./tda server start`
Check if the TrueSight Intelligence Metric Adapter is running	`tda server status`	`./tda server status`
Stop the TrueSight Intelligence Metric Adapter	`tda server stop`	`./tda server stop`
Unregister the TrueSight Intelligence Metric Adapter service. Stop the TrueSight Intelligence Metric Adapter before unregistering it.	`tda service deregister`	`./tda service deregister`(Root user only)

To customize the TrueSight Intelligence Metric Adapter

The tda.conf file located in the installedDirectory\conf folder lets you customize the TrueSight Intelligence Metric Adapter. The following table lists a couple of properties:

Property	Value
tda.server.protocol	The protocol (http or https) for communication between the TrueSight Presentation Server and the TrueSight Intelligence Metric Adapter.
tda.server.port	The port for communicating with the TrueSight Intelligence Metric Adapter.

Known limitations

The following limitations exist when you integrate with TrueSight Intelligence for metric data:

Limitation	Impact
Special characters	TrueSight Intelligence allows the following special characters in the source field: _ . - / @ % Any data that contains other special characters is dropped.
Instance and application mapping	In TrueSight Intelligence, a source can be associated with only one application at any point. A source may not always be associated with the same application.
Source length limitation	TrueSight Intelligence has a 100-character limitation on the source length. A full-path representation of an instance that is more than 100 characters cannot be represented in TrueSight Intelligence. Workaround: To disable the full-path representation, add the following entry in the <installation directory>\pw\custom\conf\pronto.conf file of the TrueSight Infrastructure Management server: `tda.sourcename.showfullpath=false`

Where to go from here

Configure the TrueSight Intelligence metric filter from the TrueSight console. For more information, see Configuring the TrueSight Intelligence metric filter Open link .