# ce_info_center_global – Manages outputting logs on HUAWEI CloudEngine switches

New in version 2.4.

- Synopsis

- Parameters

- Notes

- Examples

- Return Values

- Status

## 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
-

Choices:
- console
- monitor
- trapbuffer
- logbuffer
- snmp
- logfile

Direction of information output.

facility
-

Choices:
- local0
- local1
- local2
- local3
- local4
- local5
- local6
- local7

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
-

Choices:
- true
- false

Whether the info-center function is enabled. The value is of the Boolean type.

ip_type
-

Choices:
- ipv4
- ipv6

Log server address type, IPv4 or IPv6.

is_default_vpn
boolean

Choices:
- no ←
- yes

Use the default VPN or not.

level
-

Choices:
- emergencies
- alert
- critical
- error
- warning
- notification
- informational
- debugging

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
-

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 - |  | 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
-

Choices:
- present ←
- absent

Specify desired state of the resource.

suppress_enable
-

Choices:
- false
- true

Whether a device is enabled to suppress duplicate statistics. The value is of the Boolean type.

timestamp
-

Choices:
- UTC
- localtime

Log server timestamp. The value is of the enumerated type and case-sensitive.

transport_mode
-

Choices:
- tcp
- udp

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 `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
        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.