info-center filter-id

Function

The info-center filter-id command filters logs with a specified log.

The undo info-center filter-id command disables the filtering of logs with a specified log.

Format

info-center filter-id { id | bymodule-alias modname alias } &<1-50>

info-center filter-id { id | bymodule-alias modname alias } { bytime interval | bynumber number }

undo info-center filter-id { id | bymodule-alias modname alias } &<1-50>

undo info-center filter-id { id | bymodule-alias modname alias } { bytime interval | bynumber number }

undo info-center filter-id all

Parameters

Parameter	Description	Value
id	Specifies the ID of the logs in hexadecimal notation injected into the filter table.	The value is a string of 8 characters. The value is in hexadecimal notation, and the valid characters include 0-9, a-f, and A-F.
bymodule-alias modname	Specifies the ID of a log based on the module name.	The name is a string of 1 to 24 case-insensitive characters, spaces not supported.
bymodule-alias alias	Specifies the ID of a log based on the mnemonic symbol.	The name is a string of 1 to 64 case-insensitive characters, spaces not supported.
bytime interval	Specifies an interval at which logs are sent.	The value is an integer that ranges from 1 to 86400, in seconds.
bynumber number	Specifies the number of logs that are discarded between two received logs.	The value is an integer that ranges from 1 to 1000.

Views

System view

Default Level

3: Management level

Usage Guidelines

When the filtering function is enabled, the information center does not send the logs with a specified log ID that satisfy the filtering condition to any channel. As a result, log host, log buffer, or log file cannot receive the logs with the specified log ID.

When no filtering mode is specified, all logs with the specified log ID are discarded.
When the interval-based filtering mode is specifies, the interval at which two allowable logs are sent is the configured value.
When the piece-based filtering mode is specifies, the number of logs to be discarded between two allowable logs is the configured value.

To add multiple IDs at a time, a space is used to separate two IDs, and corresponding result of the addition is provided for each ID.

When the number of IDs in the filter table exceeds 50, adding more IDs is not permitted and a prompt is displayed, indicating that the filter table is full. In this case, you need to delete previous IDs to add new ones.

By default, no logs can bet filtered.

If IDs or alias names of logs to be filtered using this command are changed, logs and related logs are lost after the device upgrade.

Example

# Filter all logs according to the module name and mnemonic.

<sysname> system-view
[sysname] info-center filter-id bymodule-alias CMD CMD_PRI_REARRG