mellanox.onyx.onyx_syslog_remote – Configure remote syslog module

Note

This plugin is part of the mellanox.onyx collection (version 1.0.0).

To install it use: ansible-galaxy collection install mellanox.onyx.

To use it in a playbook, specify: mellanox.onyx.onyx_syslog_remote.

New in version 0.2.0: of mellanox.onyx

Synopsis

• This module provides declarative management of syslog on Mellanox ONYX network devices.

Parameters

Parameter		Choices/Defaults	Comments
enabled boolean		Choices: no yes ←	Disable/Enable logging to given remote host
filter string		Choices: include exclude	Specify a filter type
filter_str string			Specify a regex filter string
host string / required			<IP4/IP6 Hostname> Send event logs to this server using the syslog protocol
port integer			Set remote server destination port for log messages
trap string		Choices: none debug info notice alert warning err emerg crit	Minimum severity level for messages to this syslog server
trap_override list / elements=string			Override log levels for this sink on a per-class basis
	override_class string / required	Choices: mgmt-front mgmt-back mgmt-core events debug-module sx-sdk mlx-daemons protocol-stack	Specify a class whose log level to override
	override_enabled boolean	Choices: no yes ←	disable override priorities for specific class.
	override_priority string	Choices: none debug info notice alert warning err emerg crit	-Specify a priority whose log level to override

Examples

- name: Remote logging port 8080
- onyx_syslog_remote:
    host: 10.10.10.10
    port: 8080

- name: Remote logging trap override
- onyx_syslog_remote:
    host: 10.10.10.10
    trap_override:
        - override_class: events
          override_priority: emerg

- name: Remote logging trap emerg
- onyx_syslog_remote:
    host: 10.10.10.10
    trap: emerg

- name: Remote logging filter include 'ERR'
- onyx_syslog_remote:
    host: 10.10.10.10
    filter: include
    filter_str: /ERR/

- name: Disable remote logging with class events
- onyx_syslog_remote:
    enabled: False
    host: 10.10.10.10
    class: events
- name : disable remote logging
- onyx_syslog_remote:
    enabled: False
    host: 10.10.10.10

- name : enable/disable override class
- onyx_syslog_remote:
    host: 10.7.144.71
    trap_override:
        - override_class: events
          override_priority: emerg
          override_enabled: False
        - override_class: mgmt-front
          override_priority: alert

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Returned	Description
commands list / elements=string	always	The list of configuration mode commands to send to the device. Sample: ['logging x port 8080', 'logging 10.10.10.10 trap override class events priority emerg', 'no logging 10.10.10.10 trap override class events', 'logging 10.10.10.10 trap emerg', 'logging 10.10.10.10 filter [include | exclude] ERR']

Authors

• Anas Shami (@anass)