Integrating with TrueSight Presentation Server

This topic provides information about integrating with TrueSight Presentation Server to collect and analyze event data.

Notes

An integration with TrueSight Presentation Server is an integration with the TrueSight Infrastructure Management component that is registered with TrueSight Presentation Server.
Unlike other integrations, this integration requires you to register details of the TrueSight IT Data Analytics server on TrueSight Presentation Server (or TrueSight console).

At a high level, this integration helps you perform the following functions:

Get events from TrueSight Presentation Server.
Send events to TrueSight Presentation Server while creating notifications.
Cross-launch from TrueSight Presentation Server into TrueSight IT Data Analytics.

To see all the features (or capabilities) supported with this integration, see the compatibility matrix at Integrating.

Note

The metrics chart is not displayed for events that are generated from the integrated TrueSight Presentation Server.

Integrating with Infrastructure Management and ProactiveNet cells

tspsdeleteprofile CLI command

This topic contains the following information:

Key steps to an effective integration

The high-level steps involved in performing this integration and enabling the functions available with the integration are described in the following table:

Goal	High-level steps		Additional information
Get events	1	Integrate with TrueSight Presentation Server.	Integration process
	2	Create a data collector.	Collecting data from external systems
	3	Perform a search to analyze the events retrieved.	Getting started with search
Send events and fetch applications	1	Integrate with TrueSight Presentation Server.	Integration process
	2	Create a saved search.	Saving and sharing searches for analytics and monitoring
	3	Create a notification to log an event in TrueSight Presentation Server. While creating the notification, you can also search for application names available on TrueSight Presentation Server. With this, the logged event is associated with the application name that you searched while creating the notification.	Setting up notifications to create alerts or reports

You can also perform the following additional functions:

Cross-launch into TrueSight IT Data Analytics from the TrueSight console. For more information, see Cross-launching from the TrueSight console.
Create TrueSight IT Data Analytics dashlets in the TrueSight console. For more information, see Creating dashlets on TrueSight Presentation Server.

Both the preceding functions require you to register details of the TrueSight IT Data Analytics server with TrueSight Presentation Server. For more information, see the integration process.

Enable Remedy Single Sign-On to communicate with TrueSight IT Data Analytics .
Register details of the TrueSight IT Data Analytics server on the TrueSight console.
This configuration is required for performing the various functions available with this integration.

Integration process

To integrate TrueSight Presentation Server with TrueSight IT Data Analytics, you need to perform the following functions:

Enable Remedy Single Sign-On to communicate with TrueSight IT Data Analytics.
Register details of the TrueSight IT Data Analytics server on the TrueSight console.
This configuration is required for performing the various functions available with this integration..
Notes
- Unless you use Remedy Single Sign-On for user authentication, you cannot use TrueSight IT Data Analytics in conjunction with TrueSight Presentation Server.
- It is important that you configure the same Remedy Single Sign-On server that you are using with TrueSight Presentation Server.

An integration with TrueSight Presentation Server involves an integration with TrueSight Infrastructure Management registered with TrueSight Presentation Server. When you integrate TrueSight IT Data Analytics with TrueSight Presentation Server, TrueSight Infrastructure Management cells get listed on TrueSight IT Data Analytics. You can see the cells listed by navigating to Administration > External Configurations, selecting the external configuration (which was automatically created after the integration), and clicking View External Configuration . You can use these cells to achieve the following goals:

Get events from TrueSight Operations Management.
Send events to TrueSight Operations Management.

The following information provides details about registering details of the TrueSight IT Data Analytics server on the TrueSight Presentation Server.

Before you begin
To integrate with TrueSight Presentation Server

Before you begin

Ensure that TrueSight Presentation Serveris up and running in your environment. For more information, see Installing BMC TrueSight Operations Management
Ensure that you have already configured TrueSight Infrastructure Management on TrueSight Presentation Server. For more information, see Registering the components with the Presentation Server.
If you have not already enabled Remedy Single Sign-On to communicate with TrueSight IT Data Analytics, run the enablesso CLI command CLI command.

To integrate with TrueSight Presentation Server

Access the TrueSight Console.
For more information, see Accessing and navigating the TrueSight console.
From the navigation menu , go to Administration > Components.

On the Components page, click the action menu and select Add Component.

Select IT Data Analytics Server and enter the following details:

Field	Description
Host Name	Fully qualified domain name (FQDN) of the TrueSight IT Data Analytics server.
Protocol	Protocol (HTTP or HTTPS) which you want to use for connecting with TrueSight IT Data Analytics. Default: HTTPS
Port	Port number that you want to use to connect to the TrueSight IT Data Analytics server. Depending on the kind of protocol you want to use, you can specify one of the following: HTTP: 9797 HTTPS: 9443 Default: 9443
Tenant	The tenant that you want to use for connecting with TrueSight IT Data Analytics. Default: * Notes: At a time only one component of TrueSight IT Data Analytics can be registered per tenant. Do not use the same component of TrueSight IT Data Analytics for multiple tenants.

Verify if the integration completed successfully.
To do this, log on to TrueSight IT Data Analytics, navigate to Administration > External Configurations, and verify if there is an entry with the external configuration, "TrueSight Presentation Server". Note that the Presentation Server hosts the web-based console functions of the TrueSight console.
Also, after you integrate, TrueSight Infrastructure Management cells get automatically listed in the external configuration, which is created on TrueSight IT Data Analytics. You can see the cells listed on TrueSight IT Data Analytics by navigating to Administration > External Configurations, selecting the external configuration (which was automatically created after the integration), and then clicking View External Configuration .

You might want to see some troubleshooting scenarios regarding the integration. For more information, see Troubleshooting common issues.

Notes

The following notes are important to keep in mind before deleting the TrueSight IT Data Analytics registration details:

Ensure that you delete any data collectors or notifications on TrueSight IT Data Analytics that are still communicating with the TrueSight Presentation Server.
Ensure that TrueSight IT Data Analytics is up and running.

This is important because otherwise the external configuration created on TrueSight IT Data Analytics might not be deleted after you delete the component registration on the TrueSight Presentation Server. If the external configuration still continues to show on TrueSight IT Data Analytics, you can run a CLI command on TrueSight IT Data Analytics to delete the external configuration. For more information, see CLI command in Log Analytics. Open link

Cross-launching from the TrueSight console

To enable cross-launch from the TrueSight console into TrueSight IT Data Analytics, you must first register details of the TrueSight IT Data Analytics Server with TrueSight Presentation Server (on the TrueSight console). For more information, see the integration process.

You can cross-launch into TrueSight IT Data Analytics from applications and events available on the TrueSight console. Before you cross-launch into TrueSight IT Data Analytics, it is important that you create a data collector for the following items:

Each device (host) included in the application from which you want to cross-launch.
Each host associated with the event from which you want to cross-launch.

Data collectors are objects that help you collect data records (or events) from the target hosts and make it available for search and analysis. For more information, see Collecting data into the system. Creating data collectors beforehand ensures that you can search events after you cross-launch from the TrueSight console into TrueSight IT Data Analytics.

To cross-launch from the TrueSight console into TrueSight IT Data Analytics

Access the TrueSight console.
For more information, see Accessing and navigating the TrueSight console.

From the navigation menu, navigate to one of the following pages:

Navigate to	Click...
Monitoring > Applications	One of the application names, then click the action menu (vertical three dots) next to the application name and then select Launch BMC TrueSight IT Data Analytics.
Monitoring > Events	The action menu next to one of the events that you want to investigate in TrueSight IT Data Analytics, and then select Launch BMC TrueSight IT Data Analytics.
Monitoring > Applications	One of the application names, then click the Events tab. Click the action menu next to one of the events that you want to investigate in TrueSight IT Data Analytics, and then select Launch BMC TrueSight IT Data Analytics.

The system cross-launches into TrueSight IT Data Analytics, and the Search page is displayed. You can see search results for one of the following search queries depending on whether you tried to access TrueSight IT Data Analytics from an application or event.

Search query with time range	Notes
If you access TrueSight IT Data Analytics from an application
`((HOST=HostName1.) \|\| HOST=HostName1) \|\| (HOST=HostName2.) \|\| (HOST=HostName2)`	In the search query syntax, the following definitions apply: `HostName1` and `HostName2` refer to the various host names associated with the application node. `ApplicationName` refers to the name of the application. By default, the search query displays a list of host names (corresponding to the devices) associated with the application. If you have a large number of devices included in the application, then the default search query can be very long because it will have a large number of host names. Instead of searching for a list of host names to find event data associated with those hosts, you can search for the application context. To be able to search by the application context, you need to perform the following steps in TrueSight IT Data Analytics: Navigate to BMC_ITDA_HOME%\custom\conf\server. Edit the olaengineCustomConfig.properties file and locate the `console.crosslaunch.type=host` property. Change the property value from `host` to `app`. While creating data collectors for each of the devices (hosts) associated with the application, add a tag named ApplicationContext with the tag value set to the application name. For more information, see Creating data collectors in Log Analytics. . Performing the preceding steps in TrueSight IT Data Analytics is optional, however, this can be useful to simplify the search query.
`(ApplicationContext="ApplicationName")`
Time range: 30 minutes before and 30 minutes after the last time when the application state changed.
If you access TrueSight IT Data Analytics from an event
`(HOST=hostName1` `.*) \|\| (HOST=HostName1)`	In the search query syntax, `hostName1` refers to the host name associated with the event.
Time range: 30 minutes before and 30 minutes after the event time.
If you access TrueSight IT Data Analytics from an event that is directly associated with the application
Accessing TrueSight IT Data Analytics from an event directly associated with the application is similar to accessing TrueSight IT Data Analytics from an application because an application level event is associated with a group of hosts or devices and not with a specific device or host. Therefore, use the same search query parameters that are used for cross-launching from an application. For search query parameters, see the search query and notes on accessing Log Analytics from an application.

Where to go from here

Create data collectors to start the collection of event data from TrueSight Presentation Server. For more information, see Monitor using external configuration data collector.

Create notifications on the event data collected and subsequently log events on TrueSight Presentation Server. For more information, see Setting up notifications to create alerts or reports.