configure syslog add

configure syslog add [ipaddress | ipPort] {vr vr_name} [local0...local7]

Description

Configures the remote syslog server host address, and filters messages to be sent to the remote syslog target.

Syntax Description

ipaddress Specifies the remote syslog server IP address.
ipPort Specifies the UDP port number for the syslog target.
vr_name

Specifies the virtual router that can reach the server IP address.

Note: User-created VRs are supported only on the platforms listed for this feature in the Feature License Requirements document.
local0 ... local7 Specifies the local syslog facility.

Default

If a virtual router is not specified, VR-Mgmt is used. If UDP port is not specified, 514 is used.

Usage Guidelines

Options for configuring the remote syslog server include:
  • ipaddress—The IP address of the remote syslog server host
  • ipPort—The UDP port
  • vr_name—The virtual router that can reach the syslog host
  • local0-local7—The syslog facility level for local use

The switch log overwrites existing log messages in a wrap-around memory buffer, which may cause you to lose valuable information once the buffer becomes full. The remote syslog server does not overwrite log information, and can store messages in non-volatile files (disks, for example).

The enable syslog command must be issued in order for messages to be sent to the remote syslog server(s). Syslog is disabled by default. A total of four syslog servers can be configured at one time.

When a syslog server is added, it is associated with the filter DefaultFilter. Use the configure log target filter command to associate a different filter.

The syslog facility level is defined as local0 – local7. The facility level is used to group syslog data.

Example

The following command configures the remote syslog server target:
configure syslog 123.45.67.78 local1

History

This command was first available in ExtremeXOS 10.1.

The ipPort parameter was first available in ExtremeXOS 11.0.

The UPD port parameter and support for the EMS to send log messages to Syslog servers having IPv6 address was added in ExtremeXOS 16.2.

Platform Availability

This command is available on all platforms.