Spec-Zone.ru › Ansible 2.5

ce_sflow — Управляет конфигурацией sFlow на коммутаторах HUAWEI CloudEngine.

Новая версия 2.4.

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

Обзор

  • Настроить сэмплирование потоков (sFlow) для мониторинга трафика на интерфейсе в реальном времени, обнаружения аномального трафика и определения источника атакующего трафика, обеспечивая стабильную работу сети.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
agent_ip Значение по умолчанию:
Нет
Указывает IPv4/IPv6 адрес агента sFlow.
collector_datagram_size Значение по умолчанию:
Нет
Указывает максимальную длину пакетов sFlow, отправляемых агентом sFlow коллектору sFlow. Значение - целое число в байтах. Диапазон от 1024 до 8100. Значение по умолчанию 1400.
collector_description Значение по умолчанию:
Нет
Указывает описание коллектора sFlow. Значение - строка от 1 до 255 символов, чувствительная к регистру, без пробелов.
collector_id
    Варианты:
  • 1
  • 2
Значение по умолчанию:
Нет
Указывает идентификатор коллектора sFlow. Этот идентификатор используется при указании коллектора в последующей конфигурации sFlow.
collector_ip Значение по умолчанию:
Нет
Указывает IPv4/IPv6 адрес коллектора sFlow.
collector_ip_vpn Значение по умолчанию:
Нет
Указывает имя экземпляра VPN. Значение - строка от 1 до 31 символа, чувствительная к регистру, пробелы не поддерживаются. Когда вокруг строки используются двойные кавычки, пробелы в строке допускаются. Значение _public_ зарезервировано и не может использоваться в качестве имени экземпляра VPN.
collector_meth
    Варианты:
  • meth
  • enhanced
Значение по умолчанию:
Нет
Настраивает устройство на отправку пакетов sFlow через сервисные интерфейсы, повышая возможности переадресации пакетов sFlow. Параметр enhanced необязателен. Независимо от того, настраивается ли режим enhanced, коммутатор определяет, отправлять пакеты sFlow через сервисные карты или управляющий порт, основываясь на маршрутной информации в коллекторе. Когда значение meth, устройство перенаправляет пакеты sFlow на уровне управления. Когда значение enhanced, устройство перенаправляет пакеты sFlow на уровне переадресации, чтобы повысить емкость переадресации пакетов sFlow.
collector_udp_port Значение по умолчанию:
Нет
Указывает номер UDP-порта назначения для пакетов sFlow. Значение - целое число от 1 до 65535. Значение по умолчанию 6343.
counter_collector Значение по умолчанию:
Нет
Указывает список идентификаторов коллектора счетчиков.
counter_interval Значение по умолчанию:
Нет
Указывает интервал выборки счетчиков. Значение - целое число от 10 до 4294967295 в секундах. Значение по умолчанию 20.
export_route
    Варианты:
  • включено
  • выключено
Значение по умолчанию:
Нет
Настраивает пакеты sFlow, отправляемые коммутатором, чтобы они не несли маршрутную информацию.
forward_enp_slot Значение по умолчанию:
Нет
Включить функцию микросхемы Embedded Network Processor (ENP). Коммутатор использует микросхему ENP для выполнения выборки sFlow, а максимальный интервал выборки sFlow составляет 65535. Если установить интервал выборки больше 65535, коммутатор автоматически восстанавливает его до 65535. Значение - целое число или 'все'.
rate_limit Значение по умолчанию:
Нет
Указывает скорость отправки пакетов sFlow с карты на плоскость управления. Значение - целое число от 100 до 1500 в ппс.
rate_limit_slot Значение по умолчанию:
Нет
Указывает слот, где ограничена скорость выходных пакетов sFlow. Если этот параметр не указан, скорость пакетов sFlow, отправляемых со всех карт на плоскость управления, ограничена. Значение - целое число или строка символов.
sample_collector Значение по умолчанию:
Нет
Указывает список идентификаторов коллектора.
sample_direction
    Варианты:
  • входящий
  • исходящий
  • оба
Значение по умолчанию:
Нет
Включает выборку потоков входящем или исходящем направлении.
sample_length Значение по умолчанию:
Нет
Указывает максимальную длину сэмплированных пакетов. Значение - целое число от 18 до 512 в байтах. Значение по умолчанию 128.
sample_rate Значение по умолчанию:
Нет
Указывает скорость выборки потоков в формате 1/скорость. Значение - целое число от 1 до 4294967295. Значение по умолчанию 8192.
sflow_interface Значение по умолчанию:
Нет
Полное имя интерфейса для выборки потоков или счетчиков. Должен быть физический интерфейс, Eth-Trunk или подинтерфейс второго уровня.
source_ip Значение по умолчанию:
Нет
Указывает исходный IPv4/IPv6 адрес пакетов sFlow.
state
    Варианты:
  • present ←
  • absent
Определяет, должен ли конфиг присутствовать на устройстве или нет.

Примеры

---

- name: sflow module test
  hosts: ce128
  connection: local
  gather_facts: no
  vars:
    cli:
      host: "{{ inventory_hostname }}"
      port: "{{ ansible_ssh_port }}"
      username: "{{ username }}"
      password: "{{ password }}"
      transport: cli

  tasks:
  - name: Configuring sFlow Agent
    ce_sflow:
      agent_ip: 6.6.6.6
      provider: '{{ cli }}'

  - name: Configuring sFlow Collector
    ce_sflow:
      collector_id: 1
      collector_ip: 7.7.7.7
      collector_ip_vpn: vpn1
      collector_description: Collector1
      provider: '{{ cli }}'

  - name: Configure flow sampling.
    ce_sflow:
      sflow_interface: 10GE2/0/2
      sample_collector: 1
      sample_direction: inbound
      provider: '{{ cli }}'

  - name: Configure counter sampling.
    ce_sflow:
      sflow_interface: 10GE2/0/2
      counter_collector: 1
      counter_interval: 1000
      provider: '{{ cli }}'

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

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

Ключ Возвращаемое Описание
changed
boolean
всегда
проверьте, были ли внесены изменения на устройстве

Пример:
True
end_state
dict
режим подробной информации
k/v пары конфигурации после выполнения модуля

Пример:
{'agent': {'ipv6Addr': None, 'ipv4Addr': '1.2.3.4', 'family': 'ipv4'}}
existing
dict
режим подробной информации
k/v пары существующей конфигурации

Пример:
{'agent': {}}
proposed
dict
режим подробной информации
k/v пары параметров, переданных в модуль

Пример:
{'agent_ip': '6.6.6.6', 'state': 'present'}
updates
list
всегда
команды, отправленные на устройство

Пример:
['sflow agent ip 6.6.6.6']


Статус

Этот модуль помечен как экспериментальный, что означает, что он не гарантирует обратную совместимость.

Автор

  • QijunPan (@CloudEngine-Ansible)

Подсказка

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/ce_sflow_module.html

Spec-Zone.ru

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