ce_info_center_global – Manages outputting logs on HUAWEI CloudEngine switches
New in version 2.4.
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   -    |   Default: "console"   |    Channel name.The value is a string of 1 to 30 case-sensitive characters. The default value is console.   |  
|  channel_id   -    |    Number for channel. The value is an integer ranging from 0 to 9. The default value is 0.   |  |
|  channel_name   -    |    Channel name. The value is a string of 1 to 30 case-sensitive characters.   |  |
|  channel_out_direct   -    |   
  |    Direction of information output.   |  
|  facility   -    |   
  |    Log record tool.   |  
|  filter_feature_name   -    |    Feature name of the filtered log. The value is a string of 1 to 31 case-insensitive characters.   |  |
|  filter_log_name   -    |    Name of the filtered log. The value is a string of 1 to 63 case-sensitive characters.   |  |
|  info_center_enable   -    |   
  |    Whether the info-center function is enabled. The value is of the Boolean type.   |  
|  ip_type   -    |   
  |    Log server address type, IPv4 or IPv6.   |  
|  is_default_vpn   boolean    |   
  |    Use the default VPN or not.   |  
|  level   -    |   
  |    Level of logs saved on a log server.   |  
|  logfile_max_num   -    |    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   -    |   
 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   -    |    Set the priority of the syslog packet.The value is an integer ranging from 0 to 7. The default value is 0.   |  |
|  server_domain   -    |    Server name. The value is a string of 1 to 255 case-sensitive characters.   |  |
|  server_ip   -    |    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   -    |    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   -    |    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   -    |    SSL policy name. The value is a string of 1 to 23 case-sensitive characters.   |  |
|  state   -    |   
  |    Specify desired state of the resource.   |  
|  suppress_enable   -    |   
  |    Whether a device is enabled to suppress duplicate statistics. The value is of the Boolean type.   |  
|  timestamp   -    |   
  |    Log server timestamp. The value is of the enumerated type and case-sensitive.   |  
|  transport_mode   -    |   
  |    Transport mode. The value is of the enumerated type and case-sensitive.   |  
|  vrf_name   -    |    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 
localconnections 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
    ce_info_center_global:
      info_center_enable: true
      state: present
      provider: "{{ cli }}"
  - name: Config statistic-suppress enable
    ce_info_center_global:
      suppress_enable: true
      state: present
      provider: "{{ cli }}"
  - name: Config info-center syslog packet-priority 1
    ce_info_center_global:
      packet_priority: 2
      state: present
      provider: "{{ cli }}"
  - name: Config info-center channel 1 name aaa
    ce_info_center_global:
      channel_id: 1
      channel_cfg_name: aaa
      state: present
      provider: "{{ cli }}"
  - name: Config info-center logfile size 10
    ce_info_center_global:
      logfile_max_num: 10
      state: present
      provider: "{{ cli }}"
  - name: Config info-center console channel 1
    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
    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
    ce_info_center_global:
      logfile_max_size: 16
      state: present
      provider: "{{ cli }}"
  - name: Config syslog loghost domain.
    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   |  always |   command sent to the device  Sample:  ['info-center loghost domain aaa level alert port 100 facility local4 channel 1 localtime transport tcp']   |  
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
 - This module is maintained by the Ansible Community. [community]
 
Authors
- Li Yanfeng (@QijunPan)
 
Hint
If you notice any issues in this documentation you can edit this document to improve it.
    © 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
    https://docs.ansible.com/ansible/2.8/modules/ce_info_center_global_module.html