Maintenance outage for upgrade on Sunday, September 22

This site, docs.bmc.com, will be inaccessible for two hours starting at 8 AM CDT, Sunday, September 22, for a platform upgrade.

Page tree

Maintenance outage for upgrade on Sunday, September 22

This site, docs.bmc.com, will be inaccessible for two hours starting at 8 AM CDT, Sunday, September 22, for a platform upgrade.

Skip to end of metadata
Go to start of metadata

While analyzing events on in the TrueSight console, you can cross-launch into BMC TrueSight IT Data Analytics to perform root-cause analysis.

Before you begin

To be able to cross-launch, you need to first integrate IT Data Analytics with the TrueSight Presentation Server. See Integrating BMC TrueSight IT Data Analytics with Infrastructure Management for more information.

  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 toClick...
    Monitoring > ApplicationsOne 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 rangeNotes
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 2.7 .

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.

In BMC TrueSight IT Data Analytics, you can search in various ways to troubleshoot problems, perform root-cause analysis, and discover trends and insights in your business operations. For more information, see Searching data in the BMC TrueSight IT Data Analytics 2.7 documentation.

Related topics

Viewing event details in the TrueSight console

Performing probable cause analysis on an event from the TrueSight console