Spec-Zone.ru › Ansible

Модуль cisco.nxos.nxos_logging_global – Модуль ресурсов ведения журнала.

Примечание

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

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

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

Для использования в плейбуке укажите: cisco.nxos.nxos_logging_global.

Добавлен в cisco.nxos 2.5.0

  • Обзор
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Обзор

  • Этот модуль управляет конфигурацией ведения журнала на устройствах с Cisco NX-OS.

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

Параметры

Параметр

Комментарии

config

dictionary

Словарь конфигурации ведения журнала.

console

dictionary

Установка параметров ведения журнала консоли.

severity

string

Установка уровня серьезности для консоли.

Варианты:

  • "emergency"
  • "alert"
  • "critical"
  • "error"
  • "warning"
  • "notification"
  • "informational"
  • "debugging"

state

string

Включение или отключение мониторинга ведения журнала.

Варианты:

  • "enabled"
  • "disabled"

event

dictionary

События интерфейса.

link_status

dictionary

Сообщения UPDOWN и CHANGE.

default

boolean

Конфигурация ведения журнала по умолчанию, используемая интерфейсами, которые не настроены явно.

Варианты:

  • false
  • true

enable

boolean

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

Варианты:

  • false
  • true

trunk_status

dictionary

Сообщения о состоянии TRUNK.

default

boolean

Конфигурация ведения журнала по умолчанию, используемая интерфейсами, которые не настроены явно.

Варианты:

  • false
  • true

enable

boolean

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

Варианты:

  • false
  • true

facilities

list / elements=dictionary

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

facility

string

Имя facility.

severity

string

Установка уровня серьезности для консоли.

Варианты:

  • "emergency"
  • "alert"
  • "critical"
  • "error"
  • "warning"
  • "notification"
  • "informational"
  • "debugging"

history

dictionary

Изменяет уровень серьезности или размер для таблицы истории.

severity

string

Установка уровня серьезности для консоли.

Варианты:

  • "emergency"
  • "alert"
  • "critical"
  • "error"
  • "warning"
  • "notification"
  • "informational"
  • "debugging"

size

integer

Установка размера таблицы истории.

hosts

list / elements=dictionary

Включение пересылки на удаленные серверы Syslog.

facility

string

Facility, используемый при пересылке на сервер.

host

string

Имя хоста/IPv4/IPv6 адрес удаленного сервера Syslog.

port

integer

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

secure

dictionary

Включение защищенного соединения с удаленным сервером.

trustpoint

dictionary

Конфигурация точки доверия.

client_identity

string

Сертификат идентификации клиента для взаимной аутентификации.

Точка доверия для аутентификации сертификата клиента.

severity

string

Установить уровень серьезности для консоли.

Choices:

  • "emergency"
  • "alert"
  • "critical"
  • "error"
  • "warning"
  • "notification"
  • "informational"
  • "debugging"

use_vrf

string

Отображать информацию на основе VRF.

Эта опция не поддерживается на коммутаторах MDS.

ip

dictionary

IP-конфигурация.

Эта опция не поддерживается на коммутаторах MDS.

access_list

dictionary

Список доступа.

cache

dictionary

Установить параметры кэширования.

entries

integer

Максимальное количество записей журнала, кэшируемых в программном обеспечении.

interval

integer

Интервал обновления журнала (в сек).

threshold

integer

Пороговое значение обновления журнала (число попаданий)

detailed

boolean

Подробная информация ACL.

Choices:

  • false
  • true

include

dictionary

Включить дополнительные поля в syslogs.

sgt

boolean

Включить информацию о теге исходной группы в syslogs.

Choices:

  • false
  • true

logfile

dictionary

Установить ведение журнала в файл.

name

string

Имя файла журнала.

persistent_threshold

integer

Установить пороговое значение предупреждения об использовании постоянного ведения журнала в процентах.

Эта опция не поддерживается на коммутаторах MDS.

severity

string

Установить уровень серьезности для консоли.

Choices:

  • "emergency"
  • "alert"
  • "critical"
  • "error"
  • "warning"
  • "notification"
  • "informational"
  • "debugging"

size

integer

Введите размер файла журнала в байтах.

state

string

Включить или отключить файл журнала.

Choices:

  • "enabled"
  • "disabled"

module

dictionary

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

severity

string

Установить уровень серьезности для консоли.

Choices:

  • "emergency"
  • "alert"
  • "critical"
  • "error"
  • "warning"
  • "notification"
  • "informational"
  • "debugging"

state

string

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

Choices:

  • "enabled"
  • "disabled"

monitor

dictionary

Установить уровень серьезности ведения журнала терминальной линии (монитора).

severity

string

Установить уровень критичности для консоли.

Варианты:

  • "emergency"
  • "alert"
  • "critical"
  • "error"
  • "warning"
  • "notification"
  • "informational"
  • "debugging"

state

string

Включить или отключить мониторинг логов.

Варианты:

  • "enabled"
  • "disabled"

origin_id

dictionary

Включить информацию об источнике для удаленного сервера Syslog.

hostname

boolean

Использовать имя хоста в качестве origin-id сообщений логов.

Этот параметр взаимоисключающий с параметрами ip и string.

Варианты:

  • false
  • true

ip

string

Использовать IP-адрес в качестве origin-id сообщений логов.

Этот параметр взаимоисключающий с параметрами hostname и string.

string

string

Использовать строку текста в качестве origin-id сообщений логов.

Этот параметр взаимоисключающий с параметрами hostname и ip.

rate_limit

string

Включить или отключить ограничение скорости для сообщений логов.

Варианты:

  • "enabled"
  • "disabled"

rfc_strict

boolean

Установить RFC, которому должны соответствовать сообщения.

Syslog будут соответствовать RFC 5424.

Этот параметр не поддерживается на коммутаторах MDS.

Варианты:

  • false
  • true

source_interface

string

Включить Source-Interface для удаленного сервера Syslog.

Этот параметр не поддерживается на коммутаторах MDS.

timestamp

string

Установить точность временной метки логов.

Варианты:

  • "microseconds"
  • "milliseconds"
  • "seconds"

running_config

string

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

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

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

state

string

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

Состояния replaced и overridden имеют одинаковое поведение для этого модуля.

См. примеры для получения более подробной информации.

Варианты:

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

Примечания

Примечание

  • Проверено на NX-OS 9.3.6 на коммутаторах Cisco Nexus.
  • Ограниченная поддержка Cisco MDS
  • Этот модуль работает с подключением network_cli и httpapi.
  • Проверено на Cisco MDS NX-OS 9.2(2) с подключением network_cli.

Примеры

# Using merged

# Before state:
# -------------
# nxos-9k-rdo# show running-config | include logging
# nxos-9k-rdo#

- name: Merge the provided configuration with the existing running configuration
  cisco.nxos.nxos_logging_global:
    config:
      console:
        severity: error
      monitor:
        severity: warning
      ip:
        access_list:
          cache:
            entries: 16384
            interval: 200
            threshold: 5000
      facilities:
        - facility: auth
          severity: critical
        - facility: ospfv3
          severity: alert
        - facility: ftp
          severity: informational
      hosts:
        - host: 203.0.113.100
          severity: alert
          use_vrf: management
        - host: 203.0.113.101
          severity: error
          facility: local6
          use_vrf: default
      origin_id:
        hostname: true

# Task output
# -------------
#  before: {}
#
#  commands:
#    - "logging console 3"
#    - "logging monitor 4"
#    - "logging ip access-list cache entries 16384"
#    - "logging ip access-list cache interval 200"
#    - "logging ip access-list cache threshold 5000"
#    - "logging severity auth 2"
#    - "logging severity ospfv3 1"
#    - "logging severity ftp 6"
#    - "logging server 203.0.113.100 1 use-vrf management"
#    - "logging server 203.0.113.101 3 facility local6 use-vrf default"
#    - "logging origin-id hostname"
#
# after:
#   console:
#      severity: error
#    facilities:
#      - facility: auth
#        severity: critical
#      - facility: ftp
#        severity: informational
#      - facility: ospfv3
#        severity: alert
#    ip:
#      access_list:
#        cache:
#          entries: 16384
#          interval: 200
#          threshold: 5000
#    monitor:
#      severity: warning
#    origin_id:
#      hostname: true
#    hosts:
#      - severity: alert
#        host: 203.0.113.100
#        use_vrf: management
#      - facility: local6
#        severity: error
#        host: 203.0.113.101
#        use_vrf: default

# After state:
# ------------
# nxos-9k-rdo# show running-config | include logging
# logging console 3
# logging monitor 4
# logging ip access-list cache entries 16384
# logging ip access-list cache interval 200
# logging ip access-list cache threshold 5000
# logging severity auth 2
# logging severity ospfv3 1
# logging severity ftp 6
# logging origin-id hostname
# logging server 203.0.113.100 1 use-vrf management
# logging server 203.0.113.101 3 use-vrf default facility local6

# Using replaced

# Before state:
# ------------
# nxos-9k-rdo# show running-config | include logging
# logging console 3
# logging monitor 4
# logging ip access-list cache entries 16384
# logging ip access-list cache interval 200
# logging ip access-list cache threshold 5000
# logging severity auth 2
# logging severity ospfv3 1
# logging severity ftp 6
# logging origin-id hostname
# logging server 203.0.113.100 1 use-vrf management
# logging server 203.0.113.101 3 use-vrf default facility local6

- name: Replace logging configurations with provided config
  cisco.nxos.nxos_logging_global:
    config:
      monitor:
        severity: warning
      ip:
        access_list:
          cache:
            entries: 4096
      facilities:
        - facility: auth
          severity: critical
        - facility: ospfv3
          severity: alert
        - facility: ftp
          severity: informational
      hosts:
        - host: 203.0.113.101
          severity: error
          facility: local6
          use_vrf: default
        - host: 198.51.100.101
          severity: alert
          port: 6538
          use_vrf: management
      origin_id:
        ip: 192.0.2.100
    state: replaced

# Task output
# -------------
# before:
#   console:
#      severity: error
#    facilities:
#      - facility: auth
#        severity: critical
#      - facility: ftp
#        severity: informational
#      - facility: ospfv3
#        severity: alert
#    ip:
#      access_list:
#        cache:
#          entries: 16384
#          interval: 200
#          threshold: 5000
#    monitor:
#      severity: warning
#    origin_id:
#      hostname: true
#    hosts:
#      - severity: alert
#        host: 203.0.113.100
#        use_vrf: management
#      - facility: local6
#        severity: error
#        host: 203.0.113.101
#        use_vrf: default
#
# commands:
#   - "logging console"
#   - "logging ip access-list cache entries 4096"
#   - "no logging ip access-list cache interval 200"
#   - "no logging ip access-list cache threshold 5000"
#   - "no logging origin-id hostname"
#   - "logging origin-id ip 192.0.2.100"
#   - "logging server 198.51.100.101 1 port 6538 use-vrf management"
#   - "no logging server 203.0.113.100 1 use-vrf management"
#
#  after:
#    facilities:
#      - facility: auth
#        severity: critical
#      - facility: ftp
#        severity: informational
#      - facility: ospfv3
#        severity: alert
#    ip:
#      access_list:
#        cache:
#          entries: 4096
#    monitor:
#      severity: warning
#    origin_id:
#      ip: 192.0.2.100
#    hosts:
#      - severity: alert
#        port: 6538
#        host: 198.51.100.101
#        use_vrf: management
#      - facility: local6
#        severity: error
#        host: 203.0.113.101
#        use_vrf: default
#
# After state:
# ------------
# nxos-9k-rdo# show running-config | include logging
# logging monitor 4
# logging ip access-list cache entries 4096
# logging severity auth 2
# logging severity ospfv3 1
# logging severity ftp 6
# logging origin-id ip 192.0.2.100
# logging server 203.0.113.101 3 use-vrf default facility local6
# logging server 198.51.100.101 1 port 6538 use-vrf management

# Using deleted to delete all logging configurations

# Before state:
# ------------
# nxos-9k-rdo# show running-config | include logging
# logging console 3
# logging monitor 4
# logging ip access-list cache entries 16384
# logging ip access-list cache interval 200
# logging ip access-list cache threshold 5000
# logging severity auth 2
# logging severity ospfv3 1
# logging severity ftp 6
# logging origin-id hostname
# logging server 203.0.113.100 1 use-vrf management
# logging server 203.0.113.101 3 use-vrf default facility local6

- name: Delete all logging configuration
  cisco.nxos.nxos_logging_global:
    state: deleted

# Task output
# -------------
# before:
#   console:
#      severity: error
#    facilities:
#      - facility: auth
#        severity: critical
#      - facility: ftp
#        severity: informational
#      - facility: ospfv3
#        severity: alert
#    ip:
#      access_list:
#        cache:
#          entries: 16384
#          interval: 200
#          threshold: 5000
#    monitor:
#      severity: warning
#    origin_id:
#      hostname: true
#    hosts:
#      - severity: alert
#        host: 203.0.113.100
#        use_vrf: management
#      - facility: local6
#        severity: error
#        host: 203.0.113.101
#        use_vrf: default
#
# commands:
#   - "logging console"
#   - "logging monitor"
#   - "no logging ip access-list cache entries 16384"
#   - "no logging ip access-list cache interval 200"
#   - "no logging ip access-list cache threshold 5000"
#   - "no logging origin-id hostname"
#   - "no logging severity auth 2"
#   - "no logging severity ospfv3 1"
#   - "no logging severity ftp 6"
#   - "no logging server 203.0.113.100 1 use-vrf management"
#   - "no logging server 203.0.113.101 3 facility local6 use-vrf default"
#
# after: {}

# Using rendered

- name: Render platform specific configuration lines with state rendered (without connecting to the device)
  cisco.nxos.nxos_logging_global:
    config:
      console:
        severity: error
      monitor:
        severity: warning
      ip:
        access_list:
          cache:
            entries: 16384
            interval: 200
            threshold: 5000
      facilities:
        - facility: auth
          severity: critical
        - facility: ospfv3
          severity: alert
        - facility: ftp
          severity: informational
      hosts:
        - host: 203.0.113.100
          severity: alert
          use_vrf: management
        - host: 203.0.113.101
          severity: error
          facility: local6
          use_vrf: default
      origin_id:
        hostname: true

# Task Output (redacted)
# -----------------------
#  rendered:
#    - "logging console 3"
#    - "logging monitor 4"
#    - "logging ip access-list cache entries 16384"
#    - "logging ip access-list cache interval 200"
#    - "logging ip access-list cache threshold 5000"
#    - "logging severity auth 2"
#    - "logging severity ospfv3 1"
#    - "logging severity ftp 6"
#    - "logging server 203.0.113.100 1 use-vrf management"
#    - "logging server 203.0.113.101 3 facility local6 use-vrf default"
#    - "logging origin-id hostname"

# Using parsed

# parsed.cfg
# ------------
# logging console 3
# logging monitor 4
# logging ip access-list cache entries 16384
# logging ip access-list cache interval 200
# logging ip access-list cache threshold 5000
# logging severity auth 2
# logging severity ospfv3 1
# logging severity ftp 6
# logging origin-id hostname
# logging server 203.0.113.100 1 use-vrf management
# logging server 203.0.113.101 3 use-vrf default facility local6

- name: Parse externally provided logging configuration
  cisco.nxos.nxos_logging_global:
    running_config: "{{ lookup('file', './fixtures/parsed.cfg') }}"
    state: parsed

# Task output (redacted)
# -----------------------
# parsed:
#   console:
#      severity: error
#    facilities:
#      - facility: auth
#        severity: critical
#      - facility: ftp
#        severity: informational
#      - facility: ospfv3
#        severity: alert
#    ip:
#      access_list:
#        cache:
#          entries: 16384
#          interval: 200
#          threshold: 5000
#    monitor:
#      severity: warning
#    origin_id:
#      hostname: true
#    hosts:
#      - severity: alert
#        host: 203.0.113.100
#        use_vrf: management
#      - facility: local6
#        severity: error
#        host: 203.0.113.101
#        use_vrf: default

Значения возврата

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

Ключ

Описание

after

словарь

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

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

Пример: "This output will always be in the same format as the module argspec.\n"

before

словарь

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

Возвращается: когда состояние является слитым, заменённым, перезаписанным, удаленным или очищенным

Пример: "This output will always be in the same format as the module argspec.\n"

commands

список / элементы=строка

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

Возвращается: когда состояние является слитым, заменённым, перезаписанным, удаленным или очищенным

Пример: ["logging console 3", "logging monitor 4", "logging ip access-list cache entries 16384", "logging ip access-list cache interval 200", "logging ip access-list cache threshold 5000"]

gathered

список / элементы=строка

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

Возвращается: когда состояние является собранным

Пример: ["This output will always be in the same format as the module argspec.\n"]

parsed

список / элементы=строка

Нативная конфигурация устройства, предоставленная в параметре running_config, разобранная в структурированные данные в соответствии с argspec модуля.

Возвращается: когда состояние является разбираемым

Пример: ["This output will always be in the same format as the module argspec.\n"]

rendered

список / элементы=строка

Предоставленная конфигурация в задании, рендеренд в формате, нативном для устройства (оффлайн).

Возвращается: когда состояние является отрендеренным

Пример: ["logging ip access-list cache entries 4096", "no logging ip access-list cache interval 200", "no logging ip access-list cache threshold 5000", "no logging origin-id hostname", "logging origin-id ip 192.0.2.100", "logging server 198.51.100.101 1 port 6538 use-vrf management"]

Авторы

  • Nilashish Chakraborty (@NilashishC)

Ссылки на сборку

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

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

Spec-Zone.ru

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