Documentation
DocumentationDiscussions
Documentation
These docs are for v2021.3. Click to read the latest docs for v2024.3.

Filter with Signals

Easily save and apply complex filters

Structured logs are designed for easy filtering and correlation. If you monitor apps in multiple environments for example, you'll pretty quickly turn to structured properties like Environment as a way to distinguish between logs from different locations:

Log.Logger = new LoggerConfiguration()
  .Enrich.WithProperty("Environment", "Production")
  // Other configuration, then...
  .CreateLogger();

When you collect and view these logs with Seq, you might end up writing the filter Environment = 'Production' a lot.

2560

Filtering events

Instead of typing this a hundred and twenty times a day, Seq lets you save your filter as a signal. Press the "add to signal" (Add to Signal Button) button in the filter bar, and one will be created for you:

2560

Creating a signal

You can build up more complex filters by adding them to the signal with Add to Signal Button.

The various "exclude" options on event properties and types makes it quick to eliminate noise:

2560

Excluding events

Once you've given the signal a name, saved, and closed it, you'll see it in the signal list ready to activate with a single click:

2560

Filtering with the 'Production' signal

(Here's where signals start to shine - to apply multiple signals like "Production" and "Errors", just click to apply each one, and only events matching all of the applied signals will be displayed.)

📘

Sharing Signals

Signals are "personal" by default; to share a signal with others on your team, click the drop-down menu in the signal editor, to the right of the signal name, and select "shared".

Signals are really fundamental to Seq, so busy teams quickly create a lot. Your default personal workspace won't show shared signals created by others: to see the list of signals everyone has created, and add them to your own workspace, use the signal bar search box:

2560

Adding shared signals to a workspace

Signals as Indexes

Filters and queries that use signals can perform significantly better over a large data set because Seq maintains indexes for signals. See Indexing for more detail about indexes and how to benefit from them.

Showing properties as columns

Individual properties can be shown as columns alongside the event timestamp and message. This can be helpful for calling out properties that are relevant to most events but aren't included in the message template.

On any event containing the property, tap the green tick next to the property name and choose Show as column.

2560

Adding a column to a signal

The property will be added as a column to whatever signal is currently being edited. If there isn't a signal being edited already then a new one will be created.

2560

A signal with a column

Columns can be removed by editing the signal they belong to.

Signal Groups

When you create signals, you might find yourself filtering on the same property multiple times:

  • @Level = 'Errors'
  • @Level = 'Warnings'
  • Environment = 'Production'
  • Environment = 'UAT'
  • Environment = 'Test'
  • Application = 'PointOfSale'
  • Application = 'Distribution'

Seq will automatically collect signals with a single identical property filter into a signal group, like the @Level group in the screenshot:

2560

A signal group containing two signals.

Signal groups serve two purposes:

  • Reclaim some UI space by allowing grouped signals to be collapsed.
  • Union the filters of multiple selected signals in a group instead of intersecting them.

Let's dig into the second purpose more, by looking at how Seq converts selected signals into filters.

How signals are combined

When multiple signals from different groups are selected, like Environment = 'Production' and Application = 'PointOfSale', Seq will intersect them:

Environment = 'Production' and Application = 'PointOfSale'

When multiple signals in the same signal group are selected, like Application = 'PointOfSale' and Application = 'Distribution', Seq will union them:

Application = 'PointOfSale' or Application = 'Distribution'

For simple filters over the same property the union is more useful than the intersection, because the property will only have one value. An intersection isn't going to match any events.

Grouping Signals

Signals can be grouped automatically by inferring the right group from filters or they can be grouped explicitly. Signals can also be excluded from grouping.

Inferred Grouping

If a signal contains a single property equality filter then it'll be grouped based on that property name. The following signals will both be inferred as members of the Environment signal group:

  • Environment = 'Production'
  • Environment = 'UAT'

Explicit Grouping

The logic for inferring group names is simplistic. You might want the following signals to all be grouped by @Level:

  • @Level = 'Error' or @Level like 'ERR'
  • @Level = 'Warning' or @Level like 'WARN'
  • @Level = 'Information' or @Level like 'INF'

Seq can't infer the right group for these signals automatically but they can still be manually grouped and unioned when selected.

Setting an explicit grouping

Select the signal you want to group and tap the pencil icon on the right of the signal.

In the signal editor, under Group, select Specify , enter the group name and click OK:

2560

Explicitly grouping signals

Save the changes to the signal. Once there are two signals in the same group the signals will appear under the specified group:

2560

Explicit grouping of signals

Group headings are only displayed when a group contains two or more signals.

Disable grouping

If you don't want a signal to be automatically grouped then you can disable inference for that signal.

  1. Select the signal you don't want grouped and tap the pencil icon on the right of the signal
  2. In the signal editor, under Group, select Disabled
  3. Save the changes to the signal.

The signal will now appear ungrouped.