IBM Tivoli Composite Application Manager for Transactions, Version 7.4.0.0

Filtering data in topologies

You can customize the information that is displayed in the Agentless topology using filter elements and operands which describe how to manipulate the data.

You can adjust the information displayed in a Transaction Tracking topology using one or more filter elements. Table columns from the Interaction Metrics table corresponding to source and destination contexts and metrics can be used as filter elements. Table 1 lists the most commonly used filter elements.
Table 1. Common filter elements
Filter element Description
Destination Agent Use to specify the agents from which to display data.
Destination Component Name Use to limit the data displayed to particular components, such as IBM HTTP Server, orWebSphere Application Server.
Numerical interaction metric columns. For example, Received Bandwidth Use to display data only above or below a particular threshold.
For each filter element, use an operand described in Table 2 together with a value to limit the data displayed in the topology.
Table 2. Filtering operands for Agentless topologies
Description String Numerical
Include only the data that matches the specified value. == ==
Exclude data that matches the specified value. != !=
Include only data that contains the specified value. LIKE  
Exclude data that contains the specified value. !LIKE  
Include data with a value greater than that specified.   >
Include data with a value less than that specified.   <
Include data with a value greater than or equal to that specified.   >=
Include data with a value less than or equal to that specified.   <=
Tip: When specifying filters in the Properties window, the filters that you have set are displayed in the Formula text box.

As for other Tivoli Enterprise Portal adapters, all filter conditions defined on a single row are combined in an AND statement, and filters on separate rows are added as OR statements.

Described next are some common filters that you might want to apply.

You can also filter Web Response Time data, such as IP addresses and URLs, before it reaches the topology presentation layer. See Using filters.

Specifying a data source

To limit the data shown in the topology to data gathered by a particular agent:
  1. In the topology, click Edit Properties icon Edit Properties.
  2. On the Filter Configuration tab, in the Filters pane, specify a data source:
    Filter Configuration tab in the Properties window, illustrating information in text.
    1. Scroll across and select Destination Agent.
      Note: Metrics are only displayed if there is traffic related to those metrics.
    2. Click in the row and select LIKE.
    3. Enter the agent code of the required destination agent and any additional text that might help isolate the correct agent. Ensure that the value is unique by including additional characters. For example, if you specify T5 for Web Response Time, the value might also match HOST5. Because the agent context is host:T5@TEMS (where host is the hostname, T5 is the product code, and TEMS is the name of the Tivoli Enterprise Monitoring Server) you can instead enter :T5@ to match this agent.
  3. Click OK.
  4. Press F5 to refresh the topology and display your changes.

Displaying data for a single component

You can filter the data so that only the data for a particular component is displayed in the topology. You can either exclude data for those components that you are not interested in, or include only data for those components in which you are interested.

To filter the data so that only the data for a particular component is displayed in the topology:
  1. In the topology, click Edit Properties icon Edit Properties.
  2. On the Filter Configuration tab, in the Filters pane, specify the component:
    1. Scroll across and select Destination Protocol.
      Note: Metrics are only displayed if there is traffic related to those metrics.
    2. To include only IBM HTTP Server, MQ, andWebSphere Application Server:
      • Click in a row, select ==, and enter IBM HTTP Server.
      • Click in the next row, select ==, and enter MQ.
      • Click in the next row, select ==, and enter WebSphere Application Server.
  3. Click OK.
  4. Press F5 to refresh the topology and display your changes.
Topology before and after filter is applied.

Removing links for which there is no traffic

To display only those links between nodes for which there is traffic:
  1. In the topology, click Edit Properties icon Edit Properties.
  2. On the Filter Configuration tab, in the Filters pane, specify the amount of traffic that you want to monitor:
    1. Scroll across and select Received Bandwidth.
      Note: Metrics are only displayed if there is traffic related to those metrics.
    2. Click in the row and select >.
    3. Enter the value O.
  3. Click OK.
  4. Press F5 to refresh the topology and display your changes.

Removing all filters

To remove all filters, in the Filters pane of the Properties window, click Clear.

Parent topic: Customizing the presentation of data in the topology
Related reference:
Transaction Reporter agent configuration parameters
Related information:
Using filters


Last updated: September 2014