Filtering Traces for the Memento Storage

In the Memento application, you use write filters to filter the traces to be added to the ring buffer (Memento storage).

Defining a write filter allows you to specify that all traces of a given kind and with at least a given verbosity level shall be written to the ring buffer.

The messages that don't meet the write filter criteria are not written to the ring buffer. You will therefore never be able to view such messages in the Memento application.

Without opening the Memento application, you can quickly configure of the ring buffer by applying predefined configuration profiles. See section "Setting up the Driver" in the Getting Started guide (D602).

NOTE

When you change the write filters, the new filtering criteria are applied to all future messages added to the ring buffer.

From the Memento main window, select in the Control bar, then Write Filters in the Memento Configuration window.

See section "Write Filters" in the Getting Started guide (D602) for a detailed description of the write filters.

The Write Filters dialog box opens. Right-clicking gives access to all controls in the context menu:

NOTE

You can modify the write filters when the Memento application is receiving a live feed.

You cannot modify the write filters when a dump file is open, even if the dump file is being fed with new traces from the ring buffer.

Looking at the screenshot above, you can see that:

● The CoaxPress filter is defined with the verbosity level Debug, for example: all messages linked to the CoaxPress kind and having at least the Debug verbosity (that is Debug, Info, Notice, Warning, Error, Critical) will be added to the ring buffer. For this kind, the Verbose messages will not be added to the ring buffer.
● The Default filter applies to all kinds not explicitly defined in the Write Filters dialog box. In this case, all messages will be added for these kinds whatever their verbosity level, as the defined verbosity level is Verbose (highest verbosity).

Kind available in the list

1. Right-click the requested kind to access the context menu.
2. Select Set level and the requested verbosity level.

Kind not available in the list

This means the default verbosity level is applied to this kind:

1. Right-click to access the context menu.
2. Select Add kind and the requested kind from the context menu.
3. Right-click the kind, then select Set level and the requested verbosity level from the context menu.
1. Right-click the requested kind to access the context menu.
2. Select Remove kind from the context menu.

By default, the Analyzer traces are added to the ring buffer.

To prevent them from being added, do the following:

1. Click the kind corresponding to the Analyzer traces you want to exclude from the ring buffer.
2. Right-click and deselect Analyzer from the contextual menu.

The Analyzer setting for this row is now set to False and the Analyzer traces will not be added to the ring buffer.

The configuration profiles allow you to apply a predefined configuration to write filters.

For more information on configuration profiles, see Using Predefined Configuration Profiles.

To change the configuration profile, do the following:

1. Right-click to access the context menu.
2. Select Load profile and the requested profile.

The traces will be added to the ring buffer based on the loaded configuration profile.