Integrating with TrueSight IT Data Analytics

While analyzing events in the TrueSight console, you can further directly access TrueSight IT Data Analytics (or cross-launch into IT Data Analytics) to perform root-cause analysis. To be able to access IT Data Analytics, you need to first integrate TrueSight IT Data Analytics with the TrueSight Presentation Server.

Additional information

You can install the Collection Station on the node hosting the Integration Service and thereby better utilize the available physical resources. For more information, see Deploying Integration Service and Collection Station on the same node.

 

Before you begin

Enabling access to TrueSight IT Data Analytics from the TrueSight console

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

  2. From the navigation menu TS_navmenu.jpg, go to Administration > Components.

  3. On the Components page, click the action menu and select Add Component.
    ITDA_addComponent.PNG
    Select IT Data Analytics Server and enter the following details:

  4. Verify if the integration completed successfully.

    To do this, log on to 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 IT Data Analytics. You can see the cells listed on 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 view icon.jpg.

  

Notes

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

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

This is important because otherwise the external configuration created on 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 IT Data Analytics, you can run a CLI command on IT Data Analytics to delete the external configuration. For more information, see CLI command in IT Data Analytics.

Analyzing TrueSight Infrastructure Management data in IT Data Analytics

You can analyze TrueSight Infrastructure Management applications and events available on the TrueSight console in IT Data Analytics to investigate a problem or perform root cause analysis. Before you access IT Data Analytics from the TrueSight console, it is important that you access the IT Data Analytics console and 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 Setting up data collection. Creating data collectors beforehand ensures that you can search events after you access IT Data Analytics from the TrueSight console.

To access TrueSight IT Data Analytics from the TrueSight console

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

  2. 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 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 IT Data Analytics, and then select Launch BMC TrueSight IT Data Analytics.

The system cross-launches into 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 IT Data Analytics from an application or event.

Search query with time range

Notes

If you access 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 IT Data Analytics:

  1. Navigate to BMC_ITDA_HOME%\custom\conf\server.
  2. Edit the olaengineCustomConfig.properties file and locate the console.crosslaunch.type=host property.
  3. Change the property value from host to app. 

  4. 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 IT Data Analytics..

Performing the preceding steps in 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 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 IT Data Analytics from an event that is directly associated with the application

Accessing IT Data Analytics from an event directly associated with the application is similar to accessing 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 IT Data Analytics from an application.

Related topic

Network-ports

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*