community.network.ce_info_center_global – Manages outputting logs on HUAWEI CloudEngine switches.

Note

This plugin is part of the community.network collection (version 2.1.1).

To install it use: ansible-galaxy collection install community.network.

To use it in a playbook, specify: community.network.ce_info_center_global.

Synopsis

  • This module offers the ability to be output to the log buffer, log file, console, terminal, or log host on HUAWEI CloudEngine switches.

Parameters

Parameter Choices/Defaults Comments
channel_cfg_name
string
Default:
"console"
Channel name.The value is a string of 1 to 30 case-sensitive characters. The default value is console.
channel_id
string
Number for channel. The value is an integer ranging from 0 to 9. The default value is 0.
channel_name
string
Channel name. The value is a string of 1 to 30 case-sensitive characters.
channel_out_direct
string
    Choices:
  • console
  • monitor
  • trapbuffer
  • logbuffer
  • snmp
  • logfile
Direction of information output.
facility
string
    Choices:
  • local0
  • local1
  • local2
  • local3
  • local4
  • local5
  • local6
  • local7
Log record tool.
filter_feature_name
string
Feature name of the filtered log. The value is a string of 1 to 31 case-insensitive characters.
filter_log_name
string
Name of the filtered log. The value is a string of 1 to 63 case-sensitive characters.
info_center_enable
string
    Choices:
  • true
  • false
Whether the info-center function is enabled. The value is of the Boolean type.
ip_type
string
    Choices:
  • ipv4
  • ipv6
Log server address type, IPv4 or IPv6.
is_default_vpn
boolean
    Choices:
  • no ←
  • yes
Use the default VPN or not.
level
string
    Choices:
  • emergencies
  • alert
  • critical
  • error
  • warning
  • notification
  • informational
  • debugging
Level of logs saved on a log server.
logfile_max_num
string
Maximum number of log files of the same type. The default value is 200.
The value range for log files is[3, 500], for security files is [1, 3],and for operation files is [1, 7].
logfile_max_size
string
    Choices:
  • 4
  • 8
  • 16
  • 32
Default:
32
Maximum size (in MB) of a log file. The default value is 32.
The value range for log files is [4, 8, 16, 32], for security files is [1, 4],
and for operation files is [1, 4].
packet_priority
string
Set the priority of the syslog packet.The value is an integer ranging from 0 to 7. The default value is 0.
server_domain
string
Server name. The value is a string of 1 to 255 case-sensitive characters.
server_ip
string
Log server address, IPv4 or IPv6 type. The value is a string of 0 to 255 characters. The value can be an valid IPv4 or IPv6 address.
server_port
string
Number of a port sending logs.The value is an integer ranging from 1 to 65535. For UDP, the default value is 514. For TCP, the default value is 601. For TSL, the default value is 6514.
source_ip
string
Log source ip address, IPv4 or IPv6 type. The value is a string of 0 to 255. The value can be an valid IPv4 or IPv6 address.
ssl_policy_name
string
SSL policy name. The value is a string of 1 to 23 case-sensitive characters.
state
string
    Choices:
  • present ←
  • absent
Specify desired state of the resource.
suppress_enable
string
    Choices:
  • false
  • true
Whether a device is enabled to suppress duplicate statistics. The value is of the Boolean type.
timestamp
string
    Choices:
  • UTC
  • localtime
Log server timestamp. The value is of the enumerated type and case-sensitive.
transport_mode
string
    Choices:
  • tcp
  • udp
Transport mode. The value is of the enumerated type and case-sensitive.
vrf_name
string
VPN name on a log server. The value is a string of 1 to 31 case-sensitive characters. The default value is _public_.

Notes

Note

  • This module requires the netconf system service be enabled on the remote device being managed.

  • Recommended connection is netconf.

  • This module also works with local connections for legacy playbooks.

Examples

- name: Info center global module test
  hosts: cloudengine
  connection: local
  gather_facts: no
  vars:
    cli:
      host: "{{ inventory_hostname }}"
      port: "{{ ansible_ssh_port }}"
      username: "{{ username }}"
      password: "{{ password }}"
      transport: cli

  tasks:

  - name: Config info-center enable
    community.network.ce_info_center_global:
      info_center_enable: true
      state: present
      provider: "{{ cli }}"

  - name: Config statistic-suppress enable
    community.network.ce_info_center_global:
      suppress_enable: true
      state: present
      provider: "{{ cli }}"

  - name: Config info-center syslog packet-priority 1
    community.network.ce_info_center_global:
      packet_priority: 2
      state: present
      provider: "{{ cli }}"

  - name: Config info-center channel 1 name aaa
    community.network.ce_info_center_global:
      channel_id: 1
      channel_cfg_name: aaa
      state: present
      provider: "{{ cli }}"

  - name: Config info-center logfile size 10
    community.network.ce_info_center_global:
      logfile_max_num: 10
      state: present
      provider: "{{ cli }}"

  - name: Config info-center console channel 1
    community.network.ce_info_center_global:
      channel_out_direct: console
      channel_id: 1
      state: present
      provider: "{{ cli }}"

  - name: Config info-center filter-id bymodule-alias snmp snmp_ipunlock
    community.network.ce_info_center_global:
      filter_feature_name: SNMP
      filter_log_name: SNMP_IPLOCK
      state: present
      provider: "{{ cli }}"


  - name: Config info-center max-logfile-number 16
    community.network.ce_info_center_global:
      logfile_max_size: 16
      state: present
      provider: "{{ cli }}"

  - name: Config syslog loghost domain.
    community.network.ce_info_center_global:
      server_domain: aaa
      vrf_name: aaa
      channel_id: 1
      transport_mode: tcp
      facility: local4
      server_port: 100
      level: alert
      timestamp: UTC
      state: present
      provider: "{{ cli }}"

Return Values

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

Key Returned Description
changed
boolean
always
check to see if a change was made on the device

Sample:
True
end_state
dictionary
always
k/v pairs of aaa params after module execution

Sample:
{'server_domain_info': [{'chnlId': '1', 'chnlName': 'monitor', 'facility': 'local4', 'isBriefFmt': 'false', 'isDefaultVpn': 'true', 'level': 'alert', 'serverDomain': 'aaa', 'serverPort': '100', 'sourceIP': '0.0.0.0', 'sslPolicyName': None, 'timestamp': 'localtime', 'transportMode': 'tcp', 'vrfName': '_public_'}, {'chnlId': '1', 'chnlName': 'monitor', 'facility': 'local4', 'isBriefFmt': 'false', 'isDefaultVpn': 'false', 'level': 'alert', 'serverDomain': 'aaa', 'serverPort': '100', 'sourceIP': '0.0.0.0', 'sslPolicyName': 'gmc', 'timestamp': 'UTC', 'transportMode': 'tcp', 'vrfName': 'aaa'}]}
existing
dictionary
always
k/v pairs of existing rollback

Sample:
{'server_domain_info': [{'chnlId': '1', 'chnlName': 'monitor', 'facility': 'local4', 'isBriefFmt': 'false', 'isDefaultVpn': 'false', 'level': 'alert', 'serverDomain': 'aaa', 'serverPort': '100', 'sourceIP': '0.0.0.0', 'sslPolicyName': 'gmc', 'timestamp': 'UTC', 'transportMode': 'tcp', 'vrfName': 'aaa'}]}
proposed
dictionary
always
k/v pairs of parameters passed into module

Sample:
{'channel_id': '1', 'facility': 'local4', 'is_default_vpn': True, 'level': 'alert', 'server_domain': 'aaa', 'server_port': '100', 'state': 'present', 'timestamp': 'localtime', 'transport_mode': 'tcp'}
updates
list / elements=string
always
command sent to the device

Sample:
['info-center loghost domain aaa level alert port 100 facility local4 channel 1 localtime transport tcp']


Authors

  • Li Yanfeng (@QijunPan)