FileMgr

✏️ /lib/python3.9/site-packages/ansible_collections/cisco/ios/plugins/modules/ios_logging.py

✕ Tutup

#
# This file is part of Ansible
#
# Ansible is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# Ansible is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with Ansible.  If not, see <http://www.gnu.org/licenses/>.
#
from __future__ import absolute_import, division, print_function

__metaclass__ = type

DOCUMENTATION = """
module: ios_logging
author: Trishna Guha (@trishnaguha)
short_description: (deprecated, removed after 2023-06-01) Manage logging on network devices
description:
  - This module provides declarative management of logging on Cisco Ios devices.
version_added: 1.0.0
deprecated:
  alternative: ios_logging_global
  why: Newer and updated modules released with more functionality.
  removed_at_date: "2023-06-01"
notes:
  - Tested against IOS 15.6
  - The 'Default System Message Logging Configuration' of the ios device
    like facility Local7 or logging on is not subjected to idempotency causes
options:
  dest:
    description:
      - Destination of the logs.
      - On dest has to be quoted as 'on' or else pyyaml will convert
        to True before it gets to Ansible.
    choices:
      - "on"
      - host
      - console
      - monitor
      - buffered
      - trap
    type: str
  name:
    description:
      - The hostname or IP address of the destination.
      - Required when I(dest=host).
    type: str
  size:
    description:
      - Size of buffer. The acceptable value is in range from 4096 to 4294967295 bytes.
    type: int
  facility:
    description:
      - Set logging facility.
    type: str
  level:
    description:
      - Set logging severity levels.
    default: debugging
    choices:
      - emergencies
      - alerts
      - critical
      - errors
      - warnings
      - notifications
      - informational
      - debugging
    type: str
  aggregate:
    description: List of logging definitions.
    type: list
    elements: dict
    suboptions:
      dest:
        description:
          - Destination of the logs.
          - On dest has to be quoted as 'on' or else pyyaml will convert
            to True before it gets to Ansible.
        choices:
          - "on"
          - host
          - console
          - monitor
          - buffered
          - trap
        type: str
      name:
        description:
          - The hostname or IP address of the destination.
          - Required when I(dest=host).
        type: str
      size:
        description:
          - Size of buffer. The acceptable value is in range from 4096 to 4294967295 bytes.
        type: int
      facility:
        description:
          - Set logging facility.
        type: str
      level:
        description:
          - Set logging severity levels.
        type: str
        choices:
          - emergencies
          - alerts
          - critical
          - errors
          - warnings
          - notifications
          - informational
          - debugging
      state:
        description:
          - State of the logging configuration.
        choices:
          - present
          - absent
        type: str
  state:
    description:
      - State of the logging configuration.
    default: present
    choices:
      - present
      - absent
    type: str
extends_documentation_fragment:
  - cisco.ios.ios
"""

EXAMPLES = """
- name: Configure host logging
  cisco.ios.ios_logging:
    dest: host
    name: 172.16.0.1
    state: present

- name: Remove host logging configuration
  cisco.ios.ios_logging:
    dest: host
    name: 172.16.0.1
    state: absent

- name: Configure console logging level and facility
  cisco.ios.ios_logging:
    dest: console
    facility: local7
    level: debugging
    state: present

- name: Enable logging to all
  cisco.ios.ios_logging:
    dest: on

- name: Configure buffer size
  cisco.ios.ios_logging:
    dest: buffered
    size: 5000

- name: Configure logging using aggregate
  cisco.ios.ios_logging:
    aggregate:
      - { dest: console, level: notifications }
      - { dest: buffered, size: 9000 }

- name: Remove logging using aggregate
  cisco.ios.ios_logging:
    aggregate:
      - { dest: console, level: notifications }
      - { dest: buffered, size: 9000 }
    state: absent
"""

RETURN = """
commands:
  description: The list of configuration mode commands to send to the device
  returned: always
  type: list
  sample:
    - logging facility local7
    - logging host 172.16.0.1
"""
import re

from copy import deepcopy

from ansible.module_utils._text import to_text
from ansible.module_utils.basic import AnsibleModule
from ansible.module_utils.common.validation import check_required_if
from ansible_collections.ansible.netcommon.plugins.module_utils.network.common.utils import (
    remove_default_spec,
    validate_ip_address,
)

from ansible_collections.cisco.ios.plugins.module_utils.network.ios.ios import (
    get_capabilities,
    get_config,
    load_config,
)

def validate_size(value, module):
    if value:
        if not int(4096) <= int(value) <= int(4294967295):
            module.fail_json(msg="size must be between 4096 and 4294967295")
        else:
            return value

def map_obj_to_commands(updates, module, os_version):
    dest_group = "console", "monitor", "buffered", "on", "trap"
    commands = list()
    want, have = updates
    for w in want:
        dest = w["dest"]
        name = w["name"]
        size = w["size"]
        facility = w["facility"]
        level = w["level"]
        state = w["state"]
        del w["state"]
        if facility:
            w["dest"] = "facility"
        if state == "absent" and w in have:
            if dest:
                if dest == "host":
                    if os_version.startswith("12."):
                        commands.append("no logging {0}".format(name))
                    else:
                        commands.append("no logging host {0}".format(name))
                elif dest in dest_group:
                    commands.append("no logging {0}".format(dest))
                else:
                    module.fail_json(
                        msg="dest must be among console, monitor, buffered, host, on, trap",
                    )
            if facility:
                commands.append("no logging facility {0}".format(facility))
        if state == "present" and w not in have:
            if facility:
                present = False
                for entry in have:
                    if entry["dest"] == "facility" and entry["facility"] == facility:
                        present = True
                if not present:
                    commands.append("logging facility {0}".format(facility))
            if dest == "host":
                if os_version.startswith("12."):
                    commands.append("logging {0}".format(name))
                else:
                    commands.append("logging host {0}".format(name))
            elif dest == "on":
                commands.append("logging on")
            elif dest == "buffered" and size:
                present = False
                for entry in have:
                    if (
                        entry["dest"] == "buffered"
                        and entry["size"] == size
                        and entry["level"] == level
                    ):
                        present = True
                if not present:
                    if level and level != "debugging":
                        commands.append("logging buffered {0} {1}".format(size, level))
                    else:
                        commands.append("logging buffered {0}".format(size))
            elif dest:
                dest_cmd = "logging {0}".format(dest)
                if level:
                    dest_cmd += " {0}".format(level)
                commands.append(dest_cmd)
    return commands

def parse_facility(line, dest):
    facility = None
    if dest == "facility":
        match = re.search("logging facility (\\S+)", line, re.M)
        if match:
            facility = match.group(1)
    return facility

def parse_size(line, dest):
    size = None
    if dest == "buffered":
        match = re.search("logging buffered(?: (\\d+))?(?: [a-z]+)?", line, re.M)
        if match:
            if match.group(1) is not None:
                size = match.group(1)
            else:
                size = "4096"
    return size

def parse_name(line, dest):
    if dest == "host":
        match = re.search("logging host (\\S+)", line, re.M)
        if match:
            name = match.group(1)
    else:
        name = None
    return name

def parse_level(line, dest):
    level_group = (
        "emergencies",
        "alerts",
        "critical",
        "errors",
        "warnings",
        "notifications",
        "informational",
        "debugging",
    )
    if dest == "host":
        level = "debugging"
    else:
        if dest == "buffered":
            match = re.search("logging buffered(?: \\d+)?(?: ([a-z]+))?", line, re.M)
        else:
            match = re.search("logging {0} (\\S+)".format(dest), line, re.M)
        if match and match.group(1) in level_group:
            level = match.group(1)
        else:
            level = "debugging"
    return level

def map_config_to_obj(module):
    obj = []
    dest_group = ("console", "host", "monitor", "buffered", "on", "facility", "trap")
    data = get_config(module, flags=["| include logging"])
    for line in data.split("\n"):
        match = re.search("^logging (\\S+)", line, re.M)
        if match:
            if match.group(1) in dest_group:
                dest = match.group(1)
                obj.append(
                    {
                        "dest": dest,
                        "name": parse_name(line, dest),
                        "size": parse_size(line, dest),
                        "facility": parse_facility(line, dest),
                        "level": parse_level(line, dest),
                    },
                )
            elif validate_ip_address(match.group(1)):
                dest = "host"
                obj.append(
                    {
                        "dest": dest,
                        "name": match.group(1),
                        "size": parse_size(line, dest),
                        "facility": parse_facility(line, dest),
                        "level": parse_level(line, dest),
                    },
                )
            else:
                ip_match = re.search("\\d+\\.\\d+\\.\\d+\\.\\d+", match.group(1), re.M)
                if ip_match:
                    dest = "host"
                    obj.append(
                        {
                            "dest": dest,
                            "name": match.group(1),
                            "size": parse_size(line, dest),
                            "facility": parse_facility(line, dest),
                            "level": parse_level(line, dest),
                        },
                    )
    return obj

def map_params_to_obj(module, required_if=None):
    obj = []
    aggregate = module.params.get("aggregate")
    if aggregate:
        for item in aggregate:
            for key in item:
                if item.get(key) is None:
                    item[key] = module.params[key]
            try:
                check_required_if(required_if, item)
            except TypeError as exc:
                module.fail_json(to_text(exc))
            d = item.copy()
            if d["dest"] != "host":
                d["name"] = None
            if d["dest"] == "buffered":
                if "size" in d:
                    d["size"] = str(validate_size(d["size"], module))
                elif "size" not in d:
                    d["size"] = str(4096)
                else:
                    pass
            if d["dest"] != "buffered":
                d["size"] = None
            obj.append(d)
    else:
        if module.params["dest"] != "host":
            module.params["name"] = None
        if module.params["dest"] == "buffered":
            if not module.params["size"]:
                module.params["size"] = str(4096)
        else:
            module.params["size"] = None
        if module.params["size"] is None:
            obj.append(
                {
                    "dest": module.params["dest"],
                    "name": module.params["name"],
                    "size": module.params["size"],
                    "facility": module.params["facility"],
                    "level": module.params["level"],
                    "state": module.params["state"],
                },
            )
        else:
            obj.append(
                {
                    "dest": module.params["dest"],
                    "name": module.params["name"],
                    "size": str(validate_size(module.params["size"], module)),
                    "facility": module.params["facility"],
                    "level": module.params["level"],
                    "state": module.params["state"],
                },
            )
    return obj

def main():
    """main entry point for module execution"""
    element_spec = dict(
        dest=dict(type="str", choices=["on", "host", "console", "monitor", "buffered", "trap"]),
        name=dict(type="str"),
        size=dict(type="int"),
        facility=dict(type="str"),
        level=dict(
            type="str",
            default="debugging",
            choices=[
                "emergencies",
                "alerts",
                "critical",
                "errors",
                "warnings",
                "notifications",
                "informational",
                "debugging",
            ],
        ),
        state=dict(default="present", choices=["present", "absent"]),
    )
    aggregate_spec = deepcopy(element_spec)
    # remove default in aggregate spec, to handle common arguments
    remove_default_spec(aggregate_spec)
    argument_spec = dict(aggregate=dict(type="list", elements="dict", options=aggregate_spec))
    argument_spec.update(element_spec)
    required_if = [("dest", "host", ["name"])]
    module = AnsibleModule(
        argument_spec=argument_spec,
        required_if=required_if,
        supports_check_mode=True,
    )
    device_info = get_capabilities(module)
    os_version = device_info["device_info"]["network_os_version"]
    warnings = list()
    result = {"changed": False}
    if warnings:
        result["warnings"] = warnings
    want = map_params_to_obj(module, required_if=required_if)
    have = map_config_to_obj(module)
    commands = map_obj_to_commands((want, have), module, os_version)
    result["commands"] = commands
    if commands:
        if not module.check_mode:
            load_config(module, commands)
        result["changed"] = True
    module.exit_json(**result)

if __name__ == "__main__":
    main()

Batal

⬅ plugins 39 item

Nama	Tipe	Ukuran	Diubah	Perm	Aksi
📁 __pycache__	dir	—	16/09/24 06:47	0755	📂
🐍 __init__.py	py	0 B	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_acl_interfaces.py	py	17.6 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_acls.py	py	54.7 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_banner.py	py	6.1 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_bgp.py	py	16.5 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_bgp_address_family.py	py	102.6 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_bgp_global.py	py	100.1 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_command.py	py	14.2 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_config.py	py	23.2 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_facts.py	py	8.1 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_hostname.py	py	8 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_interfaces.py	py	25.1 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_l2_interfaces.py	py	19.4 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_l3_interfaces.py	py	24 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_lacp.py	py	6.9 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_lacp_interfaces.py	py	13.5 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_lag_interfaces.py	py	16.6 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_linkagg.py	py	10.8 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_lldp.py	py	3.3 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_lldp_global.py	py	10.2 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_lldp_interfaces.py	py	15.7 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_logging.py	py	14.9 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_logging_global.py	py	29.6 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_ntp.py	py	10.3 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_ntp_global.py	py	30.1 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_ospf_interfaces.py	py	34.3 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_ospfv2.py	py	59.7 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_ospfv3.py	py	72.7 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_ping.py	py	4.4 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_prefix_lists.py	py	32 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_route_maps.py	py	83.3 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_service.py	py	17.8 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_snmp_server.py	py	67.2 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_static_routes.py	py	30.9 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_system.py	py	12 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_user.py	py	20.1 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_vlans.py	py	30.3 KB	08/11/23 12:12	0644	✏️ ⬇
🐍 ios_vrf.py	py	25.6 KB	08/11/23 12:12	0644	✏️ ⬇

✏️ Rename

🔑 Ubah Permission