Filters
Filters are used to screen the displayed data, and may be used for dashboards, tables, reports, and alerts.
Adding a filter
Click Add Filter. A panel is displayed for entering and applying a new filter.
Figure 1. Add filter panel
Use this panel as follows:
A filter is a combination of a field, an operator and a value. The section at the top allows you to move between those parts and enter values. As you enter text, the following results refresh to display results that include only the string you entered.
Use the integration capabilities checkboxes (API C, App C and MQ) to show or hide fields and filters that are relevant only for these capabilities.
Suggested fields: Suggested filter fields, based on your usage history. Once clicked, the field is applied and the panel updates so you can select the values.
All fields: All available fields. Once clicked, the field is applied and the panel updates so you can select the values.
Suggested filters: Suggested combinations of filter fields and values based on your usage history. Once clicked, the filter is applied to the page.
Saved filters: Saved filters for this page (see below for more information). Once clicked, the saved filters are applied to the page.
Operators: Operators valid for the selected filter field. Once clicked, the operator is applied and the panel updates so you can select the values.
Suggested values: Suggested values, based on your usage history. Once clicked, the filter is applied to the page.
All values: All available values that exist. Once clicked, the filter is applied to the page.
Multiple values: Allows you to apply multiple values for the filter, for example, Client IP=192.168.1.100,192.168.1.200.
Add another: Causes the panel to open again automatically after you add a filter. This is useful for quickly adding several filters, one after the other.
Modifying filters
Click existing filters to edit, temporarily disable, or invert them. Click the "X" button to remove a filter.
Figure 2. Modify a filter
To clear all filters, click the Clear all button on the far-right side.
Figure 3. Clear all filters
Saving frequently used filters
Frequently-used filters can be saved for later use. To save filters, first add them to the page as described before, then click the Save button on the far right side.
Figure 4. Save filters
A panel is displayed for saving the applied filters.
Figure 5. Save filters panel
Provide the following information to save the filters:
Name: The name that will appear in the Saved filters list.
Scope: If scope is set to All pages, you will be able to apply these saved filters in all pages that have filters. If scope is set to This page only, you will be able to see and apply these saved filters in the current page, only.
Share: If the share option is set to Only for myself, those filters are available only for you. Administrators of Operations Dashboard may set this option to Share with everyone to create saved filters that all users can see and apply.
Modifying saved filters
Saved filters can be edited or deleted. To edit, click the pencil icon next to the Saved filters title.
Figure 6. Edit saved filters
A panel is displayed for editing saved filters.
Figure 7. Saved filters
This panel allows to delete saved filters or edit their properties - rename them and change their scope and share options. Only Operations Dashboard administrators can edit and delete saved filters that are shared with everyone.
Commonly used filters
Table 1. General filters
General Filter | Use and effect |
---|---|
Time | Spans occurring at the designated time |
Integration capability (product) | Limit to one of App Connect, API Connect, or MQ |
Namespace | The namespace where the integration capability is deployed |
Operation | The operation of the span. For example, the URI of an API, the name of the message queue in MQ, the name of the message flow in App Connect, the type of the API assembly or message flow node |
Span duration | Duration in milliseconds |
Is error | 'True' will filter only spans that reported errors |
Is root span | The root/first span of a trace. In each trace there is only one root span that started that trace. |
Trace ID / Span ID | Match trace or span by ID |
Table 2. App Connect filters
App Connect Filter | Use and effect |
---|---|
Integration node name | Specify node name |
Integration server name | Specify server name |
Application name | Specify application name |
Flow name | Specify flow name |
Node type | Specify node type |
Node label | Specify node type |
Table 3. API Connect filters
API Connect Filter | Use and effect |
---|---|
Appliance name | Specify appliance name |
Domain name | Specify domain name |
Provider organization | Specify provider org name |
Catalog name | Specify catalog name |
Plan name | Specify plan name |
API name | Specify API name |
API version | Specify API version |
Transaction ID | Specify Transaction ID |
Table 4. MQ filters
MQ Filter | Use and effect |
---|---|
Queue manager name | Specify queue manager name |
MQ operation | Specify operation name |
MQMD message ID | Specify message ID |
Comp code | Specify comp code |
Reason code | Specify reason code |