Saved Filters

Saved filters include both customer-created “company” filters and Kentik-provided “preset” filters. Creation and management of saved filters is covered in the following topics:

• About Saved Filters
• Saved Filters Page
• Saved Filter Admin Dialogs
• Add or Edit Saved Filter

Notes:
- Saved filters can be applied in multiple locations in the portal, typically via the Filtering Options Dialog; for a list of locations see Filtering Options Locations.
- For general information about the structure and application of filters, see About Filters.

General information about saved filters is provided in the following topics:

• Saved Filters Overview
• Company Saved Filters
• Preset Saved Filters

Saved filters enable you to apply a stored set of filter values to a query so that you can narrow results, either inclusively or exclusively, based on a value or range of values for one of the dozens of dimensions that represent the fields of the KDE main table (see About Dimensions). In the underlying SQL for a given query, the specified filters are included in the WHERE clause.

Two types of saved filters are supported in Kentik Detect and managed from the Admin » Saved Filters page:

• Company Saved Filters
• Preset Saved Filters

A company filter is a filter created by a Kentik Detect user and available to other users in the same organization. Company filters are:

• Created in and saved from one of the following:
  - the Filtering Pane Settings on the Filters pane of the sidebar in Data Explorer or in Dashboards;
  - the Saved Filters page (Admin » Saved Filters), either by duplicating an existing filter (preset or company) or by creating a filter from scratch (see Add or Edit Saved Filter).
• Applied to queries via the Add Saved Filter button in the Filter Groups Interface, which may be accessed in various locations including the Filters pane of the sidebar in Data Explorer and in dashboards in the Portal Library (see Filtering Options Locations).
• Managed via the Saved Filters Page.

Note: Filters can also be created and applied in the Filters pane of the Add Dataset dialog when creating a BGP Dataset for Peering Analytics, but filters cannot currently be saved from that modal.

A preset filter is a ready-made filter provided as part of Kentik Detect. Preset filters are:

• Applied to queries via a drop-down menu from the Add Saved Filter button in the Filtering Options Dialog. For a list of locations in which the dialog is used (e.g. the Filtering pane of the Data Explorer sidebar) see Filtering Options Locations.
• Managed via the Saved Filters Page.

To access the Saved Filters page, choose Admin from the Kentik navbar, then Saved Filters from the sidebar at left. The page is covered in the following topics:

• Saved Filters Page UI
• Saved Filter List

The Saved Filters page includes the following UI elements:

• Filter field: Filters the Saved Filter List to show only rows containing the entered text in the filter’s name or description.
• Share Level selector: Allows you to narrow the filters listed in the Saved Filter List by share level:
  - All: List all saved filters.
  - Company: List only company saved filters (see Company Saved Filters).
  - Preset: List only preset saved filters (see Preset Saved Filters).
• Add Filter button: Opens an Add Saved Filter dialog where you can add a saved filter (see Saved Filter Admin Dialogs).
• Saved Filter List: A table listing your organization’s preset and company filters (see Saved Filter List).

The Saved Filter List is a table that shows information about the listed saved filters as well as available actions. By default the list is ordered alphabetically by name (ascending). To change the sort order of the list, click on a heading to choose a sort column, and on the resulting blue up or down arrow to choose the sort direction (ascending or descending).

Note: To see additional information about a given saved filter, click anywhere in the row for that saved filter, which opens an Edit Saved Filter dialog in which you can review and edit settings (see Saved Filter Admin Dialogs).

The Saved Filter List includes the following columns (left to right):

• Share Level: Either preset or company.
• Name: The name of the saved filter, as well as a description of it, including (hopefully) what it does and how it’s used.
• Copy: Duplicates the saved filter, appending “Copy” to the name, and adds it to the list.
• Remove (company filters only): Opens a confirming dialog that enables you to remove the saved filter from your organization.
  Note: You can also remove a saved filter via the Remove button at lower left in the Edit Saved Filter dialog.

Click on a column heading to sort the list (ascending or descending).

Adding or editing a saved filter via the Kentik portal involves specifying information in the fields of the saved filter admin dialogs, which are covered in the following topics.

• About Saved Filter Dialogs
• Saved Filter Dialogs UI
• Preset Filter Details Dialog

Notes:
- Saved filter admin dialogs are visible only to users whose level is Administrator.
- Saved filters can also be added and edited with the Saved Filter API.

The Kentik portal uses saved filter admin dialogs to collect and display saved filter information. The required information is entered into or displayed in the fields of the following dialogs:

• Add Saved Filter when creating a new saved filter.
• Edit Saved Filter when editing an existing company filter.
• Preset Filter Details for viewing (but not editing) details of a preset filter (see Preset Filter Details Dialog).

The Add Saved Filter and Edit Saved Filter dialogs share the same layout and the following common UI elements:

• Close button: Click the X in the upper right corner to close the dialog. All elements will be restored to their values at the time the dialog was opened.
• Filter Name: A user-specified name for the saved filter.
• Description: A user-specified description string including (ideally) what the filter does and how it is used.
• Filter Groups pane: The interface for managing the filter groups that make up the saved filter, as well as for configuring an individual filter group.
  Notes:
  - The UI of the Filter Groups pane is mostly the same in the saved filter admin dialogs as it is in the Filtering Options dialog (see Filter Groups Interface). For a description of differences, see Filter UI Variations.
  - When you first open the Add Saved Filter dialog, the Filter Groups pane is populated with one filter group whose default dimension is Destination ASN.
• Remove button (Edit Saved Filter dialog only): Remove the saved filter from your organization’s collection of Kentik-registered saved filters. This button is only present if the saved filter being edited was manually added.
• Cancel button: Cancel the add saved filter or edit saved filter operation and exit the dialog. All elements will be restored to their values at the time the dialog was opened.
• Add Filter button (Add Saved Filter dialog only): Save settings for the new saved filter and exit the dialog.
• Save button (Edit Saved Filter dialog only): Save changes to saved filter settings and exit the dialog.

The Filter Groups pane is used in multiple locations in the Kentik Detect portal. In most cases, the pane appears in the Filtering Options dialog (see Filter Groups Interface). The interface of the pane as it appears in the Add Saved Filter and Edit Saved Filter dialogs is mostly the same as elsewhere, but in the saved filter dialogs the following controls are not included:

• Save Filters button: Not needed (the Add or Save button at bottom right of dialog is used instead).
• Add Saved Filter button: You can’t currently add a saved filter to a saved filter.

The Preset Filter Details dialog opens when you click on a row in the Saved Filter List that represents a preset filter (see Preset Saved Filters). The information in this dialog is read-only (not editable). The dialog contains the following UI elements:

• Close button: Click the X in the upper right corner to close the dialog.
• Filter Name: The user-specified name of the filter.
• Show/Hide Description button: A button that toggles the description between shown and hidden.
• Description: A user-specified description string including (ideally) what the filter does and how it is used.
• Filter Groups: One or more filter group tiles, each of which contains:
  - Any/All selector: Indicates whether the filters in the filter group are matched on an Any or All basis.
  - Filters: A list of the individual filters in the filter group, including the dimension, operator, and value.
• Match selector: Indicates whether the filter groups in the saved filter are matched on an Any or All basis.

Note: For more details on the information in the Preset Filter Details dialog, see Filter Groups Interface.

Saved filters are added and edited via the Saved Filters page of the Kentik Detect portal (choose Admin from the Kentik navbar, then Saved Filters from the sidebar at left). Adding and editing saved filters is covered in the following sections:

• Adding a Saved Filter
• Editing a Saved Filter

Note: The Saved Filters page is visible only to users whose level is Administrator.

To add a new saved filter:

1. Open the Saved Filters page (choose Admin from the Kentik navbar, then Saved Filters from the sidebar at left).
2. Click the Add Filter button to open the Add Saved Filter dialog.
3. Specify the values of the general fields in the dialog (see Saved Filter Dialogs UI).
4. Under Filter Groups, configure one or more filters (see Filter Groups Interface).
5. Save the new saved filter by clicking the Add Saved Filter button (lower right).

Only saved filters whose share level is “Company” can be edited. To edit the settings for an existing company filter:

1. Open the Saved Filters page (choose Admin from the Kentik navbar, then Saved Filters from the sidebar at left).
2. In the Saved Filter List, click in the row of the company filter that you’d like to edit. The Edit Saved Filter dialog will open.
3. Edit the saved filter settings:
   - Change any general fields that you’d like to modify (see Saved Filter Dialogs UI).
   - Add, remove, or modify any filter groups or individual filters that you’d like to change (see Filter Groups Interface).
4. To save changes, click the Save button (lower right).

To remove the saved filter from your organization’s collection of saved filters, click Remove at the lower left of the dialog.