Spec-Zone.ru › Ansible

Модуль cisco.ios.ios_logging_global — модуль ресурсов для настройки ведения журналов.

Примечание

Этот модуль входит в коллекцию cisco.ios (версия 11.4.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install cisco.ios.

Чтобы использовать модуль в плейбуке, укажите: cisco.ios.ios_logging_global.

Добавлен в cisco.ios 2.2.0

  • Краткое описание
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Этот модуль управляет атрибутами ведения журналов сетевых устройств Cisco IOS

Примечание

Этому модулю соответствует плагин действий.

Псевдонимы: logging_global

Параметры

Параметр

Комментарии

config

dictionary

Словарь параметров ведения журнала

buffered

dictionary

Задать параметры буферизованного ведения журнала

discriminator

string

Установить связь MD-Buffer

filtered

boolean

Включить фильтрацию сообщений журнала

Варианты:

  • false
  • true

severity

string

Уровень серьезности сообщений журнала

Для значения «debugging» идемпотентность этого атрибута не поддерживается, поскольку это значение не отображается в running-config.

Варианты:

  • "alerts"
  • "critical"
  • "debugging"
  • "emergencies"
  • "errors"
  • "informational"
  • "notifications"
  • "warnings"

size

integer

Размер буфера журнала

xml

boolean

Включить ведение журнала в формате XML в буфер журналов XML

Варианты:

  • false
  • true

buginf

boolean

Включить ведение журнала buginf для отладки

Варианты:

  • false
  • true

cns_events

string

Задать уровень ведения журнала событий CNS

Варианты:

  • "alerts"
  • "critical"
  • "debugging"
  • "emergencies"
  • "errors"
  • "informational"
  • "notifications"
  • "warnings"

console

dictionary

Задать параметры ведения журнала на консоль

discriminator

string

Установить связь MD-Buffer

filtered

boolean

Включить фильтрацию сообщений журнала

Варианты:

  • false
  • true

severity

string

Уровень серьезности сообщений журнала

Варианты:

  • "alerts"
  • "critical"
  • "debugging"
  • "emergencies"
  • "errors"
  • "informational"
  • "notifications"
  • "warnings"
  • "guaranteed"

xml

boolean

Включить ведение журнала в формате XML в буфер журналов XML

Варианты:

  • false
  • true

count

boolean

Подсчитывать каждое сообщение журнала и добавлять временную метку последнего появления

Варианты:

  • false
  • true

delimiter

dictionary

Добавлять разделитель к сообщениям syslog

tcp

boolean

Добавлять разделитель к сообщениям syslog, передаваемым по TCP

Варианты:

  • false
  • true

discriminator

list / elements=string

Создать или изменить дискриминатор сообщений

dmvpn

dictionary

Конфигурация DMVPN

rate_limit

integer

Частота в сообщениях в минуту; значение по умолчанию — 600 сообщений в минуту (1–10000)

esm

dictionary

Задать ограничения фильтров ESM

config

boolean

Разрешить или запретить фильтрам ESM вносить изменения в конфигурацию

Варианты:

  • false
  • true

exception

integer

Ограничить размер вывода при сбросе данных об исключениях (4096–2147483647)

facility

string

Параметр facility для сообщений syslog

Варианты:

  • "auth"
  • "cron"
  • "daemon"
  • "kern"
  • "local0"
  • "local1"
  • "local2"
  • "local3"
  • "local4"
  • "local5"
  • "local6"
  • "local7"
  • "lpr"
  • "mail"
  • "news"
  • "sys10"
  • "sys11"
  • "sys12"
  • "sys13"
  • "sys14"
  • "sys9"
  • "syslog"
  • "user"
  • "uucp"

filter

list / elements=dictionary

Указать фильтр ведения журнала

args

string

Аргументы, передаваемые модулю фильтра.

order

integer

Порядок выполнения фильтров

url

string

Унифицированный указатель ресурса фильтра

history

dictionary

Настроить таблицу истории syslog

severity

string

Уровень серьезности сообщений журнала

Для значения «debugging» идемпотентность этого атрибута не поддерживается, поскольку это значение не отображается в running-config.

Варианты:

  • "alerts"
  • "critical"
  • "debugging"
  • "emergencies"
  • "errors"
  • "informational"
  • "notifications"
  • "warnings"

size

integer

Размер буфера журнала

hosts

list / elements=dictionary

Задать IP-адрес и параметры сервера syslog

discriminator

string

Установить связь MD-Buffer

filtered

boolean

Включить фильтрацию сообщений журнала

Варианты:

  • false
  • true

host

псевдонимы: hostname

string

IP-адрес сервера syslog

ipv6

string

Настроить сервер syslog IPv6

sequence_num_session

boolean

Добавлять в сообщение syslog тег с порядковым номером сеанса

Варианты:

  • false
  • true

session_id

dictionary

Задать добавление тегов с идентификатором сеанса в сообщения syslog

tag

string

Включить имя хоста в тег идентификатора сеанса

Варианты:

  • "hostname"
  • "ipv4"
  • "ipv6"

text

string

Включить пользовательскую строку в тег идентификатора сеанса

stream

integer

Этот сервер должен получать сообщения только из потока с указанным номером

transport

dictionary

Указать транспортный протокол (по умолчанию — UDP)

tcp

dictionary

Протокол управления передачей

audit

boolean

Настроить этот хост для ведения журнала аудита брандмауэра IOS

Варианты:

  • false
  • true

discriminator

string

Установить связь MD-Buffer

filtered

boolean

Включить фильтрацию сообщений журнала

Варианты:

  • false
  • true

port

integer

Указать номер порта TCP (по умолчанию — 601) (1–65535)

sequence_num_session

boolean

Добавлять в сообщение syslog тег с порядковым номером сеанса

Варианты:

  • false
  • true

session_id

dictionary

Задать добавление тегов с идентификатором сеанса в сообщения syslog

tag

string

Включить имя хоста в тег идентификатора сеанса

Варианты:

  • "hostname"
  • "ipv4"
  • "ipv6"

text

string

Включить пользовательскую строку в тег идентификатора сеанса

stream

integer

Этот сервер должен получать сообщения только из потока с указанным номером

xml

boolean

Включить ведение журнала в формате XML в буфер журналов XML

Варианты:

  • false
  • true

udp

dictionary

Протокол пользовательских датаграмм

discriminator

string

Установить связь MD-Buffer

filtered

boolean

Включить фильтрацию сообщений журнала

Варианты:

  • false
  • true

port

integer

Указать номер порта UDP (по умолчанию — 514) (1–65535)

sequence_num_session

boolean

Добавлять в сообщение syslog тег с порядковым номером сеанса

Варианты:

  • false
  • true

session_id

dictionary

Задать добавление тегов с идентификатором сеанса в сообщения syslog

tag

string

Включить имя хоста в тег идентификатора сеанса

Варианты:

  • "hostname"
  • "ipv4"
  • "ipv6"

text

string

Добавить пользовательскую строку в тег идентификатора сеанса

stream

integer

Этот сервер должен получать сообщения только из указанного потока

xml

boolean

Включить ведение журнала в формате XML в буфер журналирования XML

Варианты:

  • false
  • true

vrf

string

Задать параметр VRF

xml

boolean

Включить ведение журнала в формате XML в буфер журналирования XML

Варианты:

  • false
  • true

logging_on

string

Включить ведение журнала для всех активированных назначений

Варианты:

  • "enable"
  • "disable"

message_counter

list / elements=string

Настроить включение в сообщения журнала определённого значения счётчика

Варианты:

  • "log"
  • "debug"
  • "syslog"

monitor

dictionary

Задать параметры журналирования для терминальной линии (монитора)

discriminator

string

Установить связь MD-Buffer

filtered

boolean

Включить фильтрацию журналирования

Варианты:

  • false
  • true

severity

string

Уровень важности сообщений журнала

Идемпотентность для этого атрибута не обеспечивается при значении ‘debugging’, поскольку это значение не отображается в running-config.

Варианты:

  • "alerts"
  • "critical"
  • "debugging"
  • "emergencies"
  • "errors"
  • "informational"
  • "notifications"
  • "warnings"

xml

boolean

Включить ведение журнала в формате XML в буфер журналирования XML

Варианты:

  • false
  • true

origin_id

dictionary

Добавить идентификатор источника в сообщения syslog

tag

string

Добавить имя хоста в тег идентификатора сеанса

Варианты:

  • "hostname"
  • "ip"
  • "ipv6"

text

string

Добавить пользовательскую строку в тег идентификатора сеанса

persistent

dictionary

Задать параметры постоянного журналирования

batch

integer

Задать размер пакета для записи в постоянное хранилище (4096–2142715904)

filesize

integer

Задать размер отдельных файлов журнала (4096–2142715904)

immediate

boolean

Немедленно записывать запись журнала в хранилище (без буферизации).

Варианты:

  • false
  • true

notify

boolean

Уведомлять при активации команды show logging [persistent].

Варианты:

  • false
  • true

protected

boolean

Запрещает изменение файлов постоянного журналирования.

Варианты:

  • false
  • true

size

integer

Задать объём дискового пространства для записи сообщений журнала (4096–2142715904)

threshold

integer

Задать порог постоянного журналирования

url

string

URL-адрес для хранения сообщений журнала

policy_firewall

dictionary

Конфигурация брандмауэра

rate_limit

integer

Значение в секундах (0–3600), по умолчанию — 30 с.

queue_limit

dictionary

Задать размер очереди сообщений журналирования

esm

integer

Задать новый размер очереди (100–2147483647)

size

integer

Задать новый размер очереди (100–2147483647)

trap

integer

Задать новый размер очереди (100–2147483647)

rate_limit

dictionary

Задать ограничение на количество сообщений в секунду

all

boolean

Сообщений в секунду (1–10000)

Варианты:

  • false
  • true

console

boolean

Сообщений в секунду (1–10000)

Варианты:

  • false
  • true

except_severity

string

Сообщения указанного уровня важности или выше

Варианты:

  • "alerts"
  • "critical"
  • "debugging"
  • "emergencies"
  • "errors"
  • "informational"
  • "notifications"
  • "warnings"

size

integer / обязательный

Сообщений в секунду (1–10000)

reload

dictionary

Задать уровень журналирования перезагрузки

message_limit

integer

Количество сообщений (1–4294967295)

severity

string

Уровень важности сообщений журнала

Идемпотентность для этого атрибута не обеспечивается при значении ‘debugging’, поскольку это значение не отображается в running-config.

Варианты:

  • "alerts"
  • "critical"
  • "debugging"
  • "emergencies"
  • "errors"
  • "informational"
  • "notifications"
  • "warnings"

server_arp

boolean

Включить отправку ARP-запросов для серверов syslog при их первоначальной настройке

Варианты:

  • false
  • true

snmp_trap

list / elements=string

Задать уровень syslog для отправки SNMP-ловушек

Варианты:

  • "alerts"
  • "critical"
  • "debugging"
  • "emergencies"
  • "errors"
  • "informational"
  • "notifications"
  • "warnings"

source_interface

list / elements=dictionary

Указать интерфейс для адреса источника в операциях журналирования

interface

string

Имя интерфейса с номером

vrf

string

Имя экземпляра VPN-маршрутизации/пересылки (VRF)

trap

string

Задать уровень журналирования для сервера syslog

Варианты:

  • "alerts"
  • "critical"
  • "debugging"
  • "emergencies"
  • "errors"
  • "informational"
  • "notifications"
  • "warnings"

userinfo

boolean

Включить журналирование сведений о пользователе при переходе в привилегированный режим

Варианты:

  • false
  • true

running_config

string

Этот параметр используется только с состоянием parsed.

Значением этого параметра должен быть вывод, полученный с устройства IOS при выполнении команды show running-config | include logging.

Состояние parsed считывает конфигурацию из параметра running_config и преобразует её в структурированные данные Ansible в соответствии со спецификацией аргументов модуля ресурсов; затем значение возвращается в ключе parsed результата.

state

string

Состояние, в котором должна остаться конфигурация

При состоянии replaced для перечисленных конфигураций журналирования, присутствующих в running-config и задаваемых несколькими командами, отменяются настройки, отсутствующие в задании.

При состоянии overridden отменяются все настройки из running-config, отсутствующие в задании.

Дополнительные сведения см. в примерах.

Варианты:

  • "merged" ← (по умолчанию)
  • "replaced"
  • "overridden"
  • "deleted"
  • "gathered"
  • "parsed"
  • "rendered"

Примечания

Примечание

  • Проверено в CML на Cisco IOSXE версии 17.3.
  • Этот модуль работает с подключением network_cli. См. https://docs.ansible.com/ansible/latest/network/user_guide/platform_ios.html
  • Настройки по умолчанию сетевых устройств Cisco IOS могут препятствовать идемпотентному выполнению сценариев

Примеры

# Using state: merged

# Before state:
# -------------

# router-ios#show running-config | section logging
# no logging exception
# no logging buffered
# no logging reload
# no logging rate-limit
# no logging console
# no logging monitor
# no logging cns-events
# no logging trap

- name: Apply the provided configuration
  cisco.ios.ios_logging_global:
    config:
      buffered:
        severity: notifications
        size: 5099
        xml: true
      console:
        severity: critical
        xml: true
      facility: local5
      hosts:
        - hostname: 172.16.1.12
        - hostname: 172.16.1.11
          xml: true
        - hostname: 172.16.1.10
          filtered: true
          stream: 10
        - hostname: 172.16.1.13
          transport:
            tcp:
              port: 514
      monitor:
        severity: warnings
      message_counter: log
      snmp_trap:
        - errors
      trap: errors
      userinfo: true
      policy_firewall:
        rate_limit: 10
      logging_on: enable
      exception: 4099
      dmvpn:
        rate_limit: 10
      cns_events: warnings
    state: merged

# Commands Fired:
# ---------------

# "commands": [
#       "logging buffered xml 5099 notifications",
#       "logging cns-events warnings",
#       "logging console xml critical",
#       "logging dmvpn rate-limit 10",
#       "logging exception 4099",
#       "logging facility local5",
#       "logging monitor warnings",
#       "logging on",
#       "logging policy-firewall rate-limit 10",
#       "logging trap errors",
#       "logging userinfo",
#       "logging host 172.16.1.12",
#       "logging host 172.16.1.10 filtered stream 10",
#       "logging host 172.16.1.13 transport tcp port 514",
#       "logging message-counter log",
#       "logging snmp-trap errors",
#       "logging host 172.16.1.11 xml"
#     ],

# After state:
# ------------

# router-ios#show running-config | section logging
# logging exception 4099
# logging message-counter log
# logging userinfo
# logging buffered xml 5099 notifications
# no logging reload
# no logging rate-limit
# logging console xml critical
# logging monitor warnings
# logging cns-events warnings
# logging policy-firewall rate-limit 10
# logging dmvpn rate-limit 10
# logging trap errors
# logging facility local5
# logging snmp-trap errors
# logging snmp-trap warnings
# logging host 172.16.1.13 transport tcp port 514
# logging host 172.16.1.11 xml
# logging host 172.16.1.12
# logging host 172.16.1.10 filtered stream 10

# Using state: deleted

# Before state:
# -------------

# router-ios#show running-config | section logging
# logging exception 4099
# logging message-counter log
# logging userinfo
# logging buffered xml 5099 notifications
# no logging reload
# no logging rate-limit
# logging console xml critical
# logging monitor warnings
# logging cns-events warnings
# logging policy-firewall rate-limit 10
# logging dmvpn rate-limit 10
# logging trap errors
# logging facility local5
# logging snmp-trap errors
# logging host 172.16.1.13 transport tcp port 514
# logging host 172.16.1.11 xml
# logging host 172.16.1.12
# logging host 172.16.1.10 filtered stream 10

- name: Remove all existing configuration
  cisco.ios.ios_logging_global:
    state: deleted

# Commands Fired:
# ---------------

# "commands": [
#       "no logging message-counter log",
#       "no logging snmp-trap errors",
#       "no logging host 172.16.1.13",
#       "no logging host 172.16.1.11",
#       "no logging host 172.16.1.12",
#       "no logging host 172.16.1.10",
#       "no logging exception 4099",
#       "no logging userinfo",
#       "no logging buffered xml 5099 notifications",
#       "no logging console xml critical",
#       "no logging monitor warnings",
#       "no logging cns-events warnings",
#       "no logging policy-firewall rate-limit 10",
#       "no logging dmvpn rate-limit 10",
#       "no logging trap errors",
#       "no logging facility local5"
#     ],

# After state:
# ------------

# router-ios#show running-config | section logging
# no logging exception
# no logging buffered
# no logging reload
# no logging rate-limit
# no logging console
# no logging monitor
# no logging cns-events
# no logging trap

# Using state: overridden

# Before state:
# -------------

# router-ios#show running-config | section logging
# logging exception 4099
# logging message-counter log
# logging userinfo
# logging buffered 6000 critical
# no logging reload
# no logging rate-limit
# logging console xml critical
# logging monitor warnings
# logging cns-events warnings
# logging policy-firewall rate-limit 10
# logging dmvpn rate-limit 10
# logging trap errors
# logging facility local6
# logging host 172.16.1.13 transport tcp port 514
# logging host 172.16.1.12
# logging host 172.16.1.10 filtered stream 10
# logging host 172.16.1.25 filtered

- name: Override commands with provided configuration
  cisco.ios.ios_logging_global:
    config:
      hosts:
        - hostname: 172.16.1.27
          filtered: true
    state: overridden

# Commands Fired:
# ---------------
# "commands": [
#         "no logging message-counter log",
#         "no logging host 172.16.1.12",
#         "no logging host 172.16.1.10",
#         "no logging host 172.16.1.13",
#         "no logging exception 4099",
#         "no logging userinfo",
#         "no logging console xml critical",
#         "no logging monitor warnings",
#         "no logging cns-events warnings",
#         "no logging policy-firewall rate-limit 10",
#         "no logging dmvpn rate-limit 10",
#         "no logging trap errors",
#         "no logging buffered 6000 critical",
#         "no logging facility local6",
#         "logging host 172.16.1.27 filtered",
#     ],

# After state:
# ------------

# router-ios#show running-config | section logging
# no logging exception
# no logging buffered
# no logging reload
# no logging rate-limit
# no logging console
# no logging monitor
# no logging cns-events
# no logging trap
# logging host 172.16.1.27 filtered

# Using state: replaced

# Before state:
# -------------

# router-ios#show running-config | section logging
# logging exception 4099
# logging message-counter log
# logging userinfo
# logging buffered xml 5099 notifications
# no logging reload
# no logging rate-limit
# logging console xml critical
# logging monitor warnings
# logging cns-events warnings
# logging policy-firewall rate-limit 10
# logging dmvpn rate-limit 10
# logging trap errors
# logging facility local5
# logging snmp-trap errors
# logging host 172.16.1.13 transport tcp port 514
# logging host 172.16.1.11 xml
# logging host 172.16.1.12
# logging host 172.16.1.10 filtered stream 10

- name: Replace commands with provided configuration
  cisco.ios.ios_logging_global:
    config:
      buffered:
        severity: alerts
        size: 6025
      facility: local6
      hosts:
        - hostname: 172.16.1.19
        - hostname: 172.16.1.10
          filtered: true
          stream: 15
    state: replaced

# Commands Fired:
# ---------------

# "commands": [
#         "no logging host 172.16.1.13",
#         "no logging host 172.16.1.11",
#         "no logging host 172.16.1.12",
#         "no logging host 172.16.1.10",
#         "logging host 172.16.1.19",
#         "logging host 172.16.1.10 filtered stream 15",
#         "logging buffered 6025 alerts",
#         "logging facility local6"
#     ],

# After state:
# ------------

# router-ios#show running-config | section logging
# logging exception 4099
# logging message-counter log
# logging userinfo
# logging buffered 6025 alerts
# no logging reload
# no logging rate-limit
# logging console xml critical
# logging monitor warnings
# logging cns-events warnings
# logging policy-firewall rate-limit 10
# logging dmvpn rate-limit 10
# logging trap errors
# logging facility local6
# logging snmp-trap errors
# logging host 172.16.1.19

# Using state: gathered

# Before state:
# -------------

# router-ios#show running-config | section logging
# logging exception 4099
# logging message-counter log
# logging userinfo
# logging buffered xml 5099 notifications
# no logging reload
# no logging rate-limit
# logging console xml critical
# logging monitor warnings
# logging cns-events warnings
# logging policy-firewall rate-limit 10
# logging dmvpn rate-limit 10
# logging trap errors
# logging facility local5
# logging snmp-trap errors
# logging host 172.16.1.13 transport tcp port 514
# logging host 172.16.1.11 xml
# logging host 172.16.1.12
# logging host 172.16.1.10 filtered stream 10
# logging host 172.16.1.25 filtered

- name: Gather listed logging config
  cisco.ios.ios_logging_global:
    state: gathered

# Module Execution Result:
# ------------------------

# "gathered": {
#     "buffered": {
#         "severity": "notifications",
#         "size": 5099,
#         "xml": true
#     },
#     "cns_events": "warnings",
#     "console": {
#         "severity": "critical",
#         "xml": true
#     },
#     "dmvpn": {
#         "rate_limit": 10
#     },
#     "exception": 4099,
#     "facility": "local5",
#     "hosts": [
#         {
#             "hostname": "172.16.1.11",
#             "xml": true
#         },
#         {
#             "hostname": "172.16.1.12"
#         },
#         {
#             "filtered": true,
#             "hostname": "172.16.1.10",
#             "stream": 10
#         },
#         {
#             "hostname": "172.16.1.13",
#             "transport": {
#                 "tcp": {
#                     "port": 514
#                 }
#             }
#         },
#         {
#             "filtered": true,
#             "hostname": "172.16.1.25"
#         }
#     ],
#     "message_counter": [
#         "log"
#     ],
#     "monitor": {
#         "severity": "warnings"
#     },
#     "policy_firewall": {
#         "rate_limit": 10
#     },
#     "snmp_trap": [
#         "errors"
#     ],
#     "trap": "errors",
#     "userinfo": true
# },

# After state:
# -------------

# router-ios#show running-config | section logging
# logging exception 4099
# logging message-counter log
# logging userinfo
# logging buffered xml 5099 notifications
# no logging reload
# no logging rate-limit
# logging console xml critical
# logging monitor warnings
# logging cns-events warnings
# logging policy-firewall rate-limit 10
# logging dmvpn rate-limit 10
# logging trap errors
# logging facility local5
# logging snmp-trap errors
# logging host 172.16.1.13 transport tcp port 514
# logging host 172.16.1.11 xml
# logging host 172.16.1.12
# logging host 172.16.1.10 filtered stream 10
# logging host 172.16.1.25 filtered

# Using state: rendered

- name: Render the commands for provided configuration
  cisco.ios.ios_logging_global:
    config:
      buffered:
        severity: notifications
        size: 5099
        xml: true
      console:
        severity: critical
        xml: true
      facility: local5
      hosts:
        - hostname: 172.16.1.12
        - hostname: 172.16.1.11
          xml: true
        - hostname: 172.16.1.10
          filtered: true
          stream: 10
        - hostname: 172.16.1.13
          transport:
            tcp:
              port: 514
      monitor:
        severity: warnings
      message_counter: log
      snmp_trap: errors
      trap: errors
      userinfo: true
      policy_firewall:
        rate_limit: 10
      logging_on: enable
      exception: 10
      dmvpn:
        rate_limit: 10
      cns_events: warnings
    state: rendered

# Module Execution Result:
# ------------------------

# "rendered": [
#     "logging host 172.16.1.12",
#     "logging host 172.16.1.11 xml",
#     "logging host 172.16.1.10 filtered stream 10",
#     "logging host 172.16.1.13 transport tcp port 514",
#     "logging message-counter log",
#     "logging snmp-trap errors",
#     "logging buffered xml 5099 notifications",
#     "logging console xml critical",
#     "logging facility local5",
#     "logging monitor warnings",
#     "logging trap errors",
#     "logging userinfo",
#     "logging policy-firewall rate-limit 10",
#     "logging on",
#     "logging exception 10",
#     "logging dmvpn rate-limit 10",
#     "logging cns-events warnings"
#     ]

# Using state: parsed

# File: parsed.cfg
# ----------------

# logging on
# logging count
# logging userinfo
# logging trap errors
# logging reload alerts
# logging host 172.16.1.1
# logging exception 4099
# logging history alerts
# logging facility local5
# logging snmp-trap errors
# logging monitor warnings
# logging origin-id hostname
# logging host 172.16.1.11 xml
# logging cns-events warnings
# logging dmvpn rate-limit 10
# logging message-counter log
# logging console xml critical
# logging message-counter debug
# logging persistent batch 4444
# logging host 172.16.1.25 filtered
# logging source-interface GBit1/0
# logging source-interface CTunnel2
# logging policy-firewall rate-limit 10
# logging buffered xml 5099 notifications
# logging rate-limit all 2 except warnings
# logging host 172.16.1.10 filtered stream 10
# logging host 172.16.1.13 transport tcp port 514
# logging discriminator msglog01 severity includes 5
# logging filter tftp://172.16.2.18/ESM/elate.tcl args TESTInst2
# logging filter tftp://172.16.2.14/ESM/escalate.tcl args TESTInst

- name: Parse the provided configuration with the existing running configuration
  cisco.ios.ios_logging_global:
    running_config: "{{ lookup('file', 'parsed.cfg') }}"
    state: parsed

# Module Execution Result:
# ------------------------

# "parsed": {
#     "buffered": {
#         "severity": "notifications",
#         "size": 5099,
#         "xml": true
#     },
#     "cns_events": "warnings",
#     "console": {
#         "severity": "critical",
#         "xml": true
#     },
#     "count": true,
#     "discriminator": [
#         "msglog01 severity includes 5"
#     ],
#     "dmvpn": {
#         "rate_limit": 10
#     },
#     "exception": 4099,
#     "facility": "local5",
#     "filter": [
#         {
#             "args": "TESTInst2",
#             "url": "tftp://172.16.2.18/ESM/elate.tcl"
#         },
#         {
#             "args": "TESTInst",
#             "url": "tftp://172.16.2.14/ESM/escalate.tcl"
#         }
#     ],
#     "history": {
#         "severity": "alerts"
#     },
#     "hosts": [
#         {
#             "hostname": "172.16.1.1"
#         },
#         {
#             "hostname": "172.16.1.11",
#             "xml": true
#         },
#         {
#             "filtered": true,
#             "hostname": "172.16.1.25"
#         },
#         {
#             "filtered": true,
#             "hostname": "172.16.1.10",
#             "stream": 10
#         },
#         {
#             "hostname": "172.16.1.13",
#             "transport": {
#                 "tcp": {
#                     "port": 514
#                 }
#             }
#         }
#     ],
#     "logging_on": "enable",
#     "message_counter": [
#         "log",
#         "debug"
#     ],
#     "monitor": {
#         "severity": "warnings"
#     },
#     "origin_id": {
#         "tag": "hostname"
#     },
#     "persistent": {
#         "batch": 4444
#     },
#     "policy_firewall": {
#         "rate_limit": 10
#     },
#     "rate_limit": {
#         "all": true,
#         "except_severity": "warnings",
#         "size": 2
#     },
#     "reload": {
#         "severity": "alerts"
#     },
#     "snmp_trap": [
#         "errors"
#     ],
#     "source_interface": [
#         {
#             "interface": "GBit1/0"
#         },
#         {
#             "interface": "CTunnel2"
#         }
#     ],
#     "trap": "errors",
#     "userinfo": true
# }

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ

Описание

after

dictionary

Итоговая конфигурационная модель после выполнения.

Возвращается: при наличии изменений

Пример: "The configuration returned will always be in the same format\n of the parameters above.\n"

before

dictionary

Конфигурация до выполнения модели.

Возвращается: всегда

Пример: "The configuration returned will always be in the same format\n of the parameters above.\n"

commands

list / elements=string

Набор команд, отправленных на удалённое устройство.

Возвращается: всегда

Пример: ["logging on", "logging userinfo", "logging trap errors", "logging host 172.16.1.12", "logging console xml critical", "logging message-counter log", "logging policy-firewall rate-limit 10"]

Авторы

  • Sagar Paul (@KB-perByte)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/cisco/ios/ios_logging_global_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API