create log filter

create log filter name {copy filter_name}

Description

Creates a log filter with the specified name.

Syntax Description

name Specifies the name of the filter to create.
copy Specifies that the new filter is to be copied from an existing one.
filter_name Specifies the existing filter to copy.

Default

N/A.

Usage Guidelines

This command creates a filter with the name specified. A filter is a customizable list of events to include or exclude, and optional parameter values. The list of events can be configured by component or subcomponent with optional severity, or individual condition, each with optional parameter values. See the commands configure log filter events and configure log filter events match for details on how to add items to the filter.

The filter can be associated with one or more targets using the configure log target filter command to control the messages sent to those targets. The system has one built-in filter named DefaultFilter, which itself may be customized. Therefore, the create log filter command can be used if a filter other than DefaultFilter is desired. As its name implies, DefaultFilter initially contains the default level of logging in which every ExtremeXOS component and subcomponent has a pre-assigned severity level.

If another filter needs to be created that will be similar to an existing filter, use the copy option to populate the new filter with the configuration of the existing filter. If the copy option is not specified, the new filter will have no events configured and therefore no incidents will pass through it.

The total number of supported filters, including DefaultFilter, is 20.

Example

The following command creates the filter named fdb2, copying its configuration from the filter DefaultFilter:

create log filter fdb2 copy DefaultFilter

History

This command was first available in ExtremeXOS 10.1.

Platform Availability

This command is available on all Universal switches supported in this document.