Skip to main content
Version: 6.x (latest)

Filter bar

The Global Filter Bar appears at the top of every view in the N|Solid Console and controls what each view shows. Use it to search your data, set a date range, save filters for later, and create alerts that trigger when processes match your criteria.

Global Filter Bar basics​

By default, the Filter Bar matches all processes (the Filter by: field is empty) at the current point in time (no date range is selected).

Empty Filter Bar

The Filter Bar narrows the contents of the view shown below it. In this example, the results are restricted to a single application:

Filter Bar filtered by application name

When multiple filters are present, they're combined with AND, so the results include only processes that match all criteria. This example shows all processes of one application that have more than 5 MB of JavaScript heap used:

Filter Bar with multiple filters

Select a date range to query historical data. With no date range, the results include only currently connected N|Solid processes. With a date range, the results include every process matching the filter that was alive during that time, whether or not it's still connected.

Filter Bar with a date range

important

When you use the date range selector, the results may contain a mixture of dead and live processes.

Using the filter modal​

Selecting filters​

Click the Filter Bar (placeholder Type Filter) to open a list of suggested filters. You can also type the name of any N|Solid data point.

Suggested filters

Select a filter to open its filter modal. For text fields, click a value under All … (for example, All Application Names) to add it to the filter.

Filter modal for application name

You can add several values of the same field to OR them. Values listed under Include processes with any of the following … are included in the results; values that remain in the list below aren't. Click Set Filter to apply the filter, or remove every value and click Delete Filter to remove it.

Filter modal with one application selected

Start typing in the search box to narrow the list to matching values.

Searching values in the filter modal

For numeric fields, choose Over or Under, enter a value (with a unit such as MB or Seconds where applicable), and click Set Filter.

Numeric filter for CPU over 50 percent

The results include any process with at least one matching record, combined with the rest of the Filter Bar and date range settings.

Filter Bar with a CPU filter

Using the date range tool​

When you query historical data, the date range tool shows which dates have data available. Select the dates, adjust the start and end times, and click Done to set the range.

Use Quick Presets to select a recent range with one click: Last 5 minutes, Last 15 minutes, Last 30 minutes, Last 1 hour, Last 3 hours, Last 6 hours, Last 12 hours, or Last 24 hours.

Empty date range picker

Date range picker with a range selected

Saving filters​

Click the Save filter icon icon to open the Save Custom Filter panel. Save the current filter as a custom filter to recall it later or to attach alerts to it.

Save Custom Filter panel Naming a custom filter Saved custom filter in the list

Each entry in the Custom Filters list has four icons on the right:

Custom filter icons

  • Load (arrow icon) loads the custom filter into the Filter Bar.
  • Edit (pencil icon) switches to edit mode, where you can rename the filter or change its parameters. Click Update Filter to save your changes.
  • Actions (box icon) creates actions, such as alerts, that run whenever a process remains in this filter.
  • Delete (trash can icon) deletes the custom filter.

Editing a custom filter

Creating actions​

Click the Actions icon and then Create New Action to add an action to a custom filter.

Actions for a custom filter

The available action types are Slack, Microsoft Teams, Pager Duty, Email, Webhook, Heap Snapshot, CPU Profile, Heap Sampling, Heap Profile, and Trace. Each type has its own settings.

Slack action settings

You can reuse actions you've already created in other custom filters, so you can route several filters to the same endpoints.

Selecting an existing action

Custom filters with actions show additional icons that let you view and change the actions configured for that filter.

Custom filter with actions

Click an action icon to see the full set of configured actions.

List of configured actions

In the Actions modal, set the Action Delay (15 Seconds, 30 Seconds, 45 Seconds, or 1 Minute) and the Action Interval (1 Minute, 5 Minutes, 1 Hour, 6 Hours, or 24 Hours) for the filter's actions. In this example, a process must match the filter continuously for 30 seconds before the alert triggers. After it triggers, it doesn't trigger again for 5 minutes.

Action Delay and Action Interval settings

Filter history​

Your recent filters are available in the Filter History panel, so you can recall or save a filter you found useful.

Filter History panel

The Filter history icons icons on the right of each entry let you Load the filter into the Filter Bar or Delete it from the history.

Click Save filter on a history entry to save it as a custom filter, so you can recall it later or attach alerts to it.

Saving a filter from the history

NodeSource Support