Page tree
Skip to end of metadata
Go to start of metadata

For advanced filtering options, such as viewing events from specific devices, you can create custom filters.

The following sections discuss the process of cresting and using custom filters.

The following video (4:04) illustrates how to create custom filters.


 https://www.youtube.com/watch?v=TMT3dip918E

To create custom filters

  1. From the Events action menu, select Create Custom Filter.

    Note:

    If your event source is a remote cell (indicated by the icon on the Events page), then the following filtering categories are not available in the custom filter:

    • Applications
    • Groups
    • Devices
    • Services

    Also, only the event classes and slots that are defined in the Infrastructure Management Server cells are available for filtering.

  2. Select one or more event status and severity. 
    Filtering is disabled if you do not select any event status or severity, and events with any status or severity are considered.
  3. Select any one of the applications, groups, devices, or services category. Use the drop-down box of the selected category to select one or more items.

    Notes

    • The applications, groups, devices, and services categories are populated based on your permissions. For more information, see Creating roles.
    • The Devices list shows only 5000 devices at a time. You can search for a device that is not included in this list by typing the device name or your search text in the list box. The complete device list is searched based on the text and the matching device names are displayed in the list. 
  4. (Optional) Select the Table View if you want to associate the table view with this custom filter. You can associate both global and user defined table views with the custom filter.
  5. (Optional) To add advanced filtering options, select the Add Advanced Filter check box. See Using custom filters to filter events - Advanced filtering for more information.
  6. Click Apply to apply the custom filter.

    Note

    The custom filter is applied but not saved. To make changes to the custom filter before saving it, select Create Custom Filter.

    Ensure to save the custom filter before you navigate to a different page or restore default filters.

  7. From the Events action menu, select Save As New Filter to save the custom filter.
  8. Enter the custom filter name and click OK.

Advanced filtering

  1. From the Class list, select a class.
    The sub-classes for the selected class are automatically selected.
  2. To filter events according to one or more event attributes, specify the following information for each attribute:
    1. (Optional) Select a left parenthesis or a NOT condition.

    2. Select an event attribute.

      Note

      For some event attributes, the internal names are displayed. For example, error_message, error_val.

      If you want to view the display name for an event attribute, you need to add the attribute to the en.json file:

      1. Open the en.json file from the  <installationDirectory>\TrueSightPServer\truesightpserver\modules\tomcat\webapps\infraApp\WEB-INF\classes folder.

      2. Go to the end of the file and add a comma after the last line of code and press ENTER.

      3. Add information for the event attribute in the following format: eventView.slot.<CLASS_NAME>.<SLOT_NAME>=<SLOT_DISPLAY_NAME>
      where, CLASS_NAME = Event class name of your event attribute (slot)

      SLOT_NAME = Internal name of the event attribute that is currently displayed

      SLOT_DISPLAY_NAME = Name of the event attribute that you want to replace the internal name with

      4. Repeat the earlier step for all the event attributes that you want to add.

      5. Restart the Presentation Server.

    3. Select a 749294593.

      Note

      • The search is not case sensitive, except for the List of String slot type. For example, an event with slot value "London" is listed when you specify "london" or "London" for an "==" operator.
      • For operations on strings like ">" or "<", the ASCII values of strings are used for comparison.
        For example, if you use the operator ">" when the Message slot has “cell started” and the comparison string is “b”, this event is listed. If the comparison string is “d”, this event is not listed.
      • The slot type number includes integers, floating point, and real numbers.

    4. Enter a value against which you want the filter to compare.
    5. (Optional) Select a right parenthesis.
    6. To add another filter condition (event attribute), click 

    7. Select a logical operator, AND or OR.
    8. Repeat step a through step g to add as many filter conditions as you want.
    9. To remove a filter condition, click  in the corresponding filter condition row.

Comparison operators

OperatorDescriptionSlot types
==Events are listed only if the slot value matches the comparison value.

Enum, String, Number, List of String

!=Events are listed only if the slot value does not match the comparison value.Enum, String, Number, List of String
>Events are listed only if the slot value is greater than the comparison value.Enum, String, Number
<Events are listed only if the slot value is less than the comparison value.Enum, String, Number
>=Events are listed only if the slot value is greater than or equal to the comparison value.Enum, String, Number
<=Events are listed only if the slot value is less than or equal to the comparison value.Enum, String, Number
Has prefixEvents are listed only if the slot value starts with the comparison value.String, Number
Has suffixEvents are listed only if the slot value ends with the comparison value.String, Number
ContainsEvents are listed only if the slot value contains the comparison value.String, Number, List of String
WithinEvents are listed only if the slot value is an exact match with one of the comma-separated list of comparison values.String, Number
Contains one ofEvents are listed only if the slot value is an exact match with one of the comma-separated list of comparison values.String, Number
OutsideEvents are listed only if the slot value does not match with any of the comma-separated list of comparison values.String, Number
Matches

Events are listed only if the slot value contains the comparison value.

You can provide the following parameters in addition to the comparison value:
%d - decimal integer number
%f - floating point real number
%c - single character
%s - string value

Consider the following example values in the message slot of eight events:

Event 1Memory Consumption - 10 MB – on machine clm-dev-008700
Event 2CPU utilization 85.35% – on machine clm-dev-007890
Event 3Memory Consumption - 5 MB – on machine clm-dev-108781
Event 4CPU utilization 75.95% – on machine clm-dev-087654
Event 5Memory Consumption – 894  MB – on machine clm-dev-54657
Event 6CPU utilization 68.45% – on machine clm-dev-37878
Event 7Consumption of storage space is high on vm-dev-45 machine
Event 8Utilization taking higher trend

When you use the matches operator for the message slot:

  • Message matches Consumption – %d
    Events 1, 3, and 5 are displayed, as the following criteria matches:
    Consumption as a constant and an integer variable listed after Consumption.
  • Message matches machine %s
    Events 1, 2, 3, 4, 5, and 6 are displayed as the following criteria matches:
    machine as a constant and a string variable listed after machine.
String, List of String

Subclass of

Events are listed only if they are a subclass or child class of the provided class.Class
Superclass ofEvents are listed only if they are a super-class or parent class of the provided class.Class

 

To apply custom filters

  1. From the Events action menu, select View Saved Filters .
    The list of saved custom filters is displayed.
  2. Select a custom filter from the list.

  3. If you have associated a table view with this filter, the events are displayed according to the associated table view.

To perform operations on custom filters

  1. From the Events action menu, select View Saved Filters .
    The list of saved custom filters is displayed.
  2. From the action menu for the custom filter, you can edit, rename, or delete the custom filter.