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 |
Нет | Указывает идентификатор коллектора sFlow. Этот идентификатор используется при указании коллектора в последующей конфигурации sFlow. |
| collector_ip | Значение по умолчанию: Нет | Указывает IPv4/IPv6 адрес коллектора sFlow. |
| collector_ip_vpn | Значение по умолчанию: Нет | Указывает имя экземпляра VPN. Значение - строка от 1 до 31 символа, чувствительная к регистру, пробелы не поддерживаются. Когда вокруг строки используются двойные кавычки, пробелы в строке допускаются. Значение _public_ зарезервировано и не может использоваться в качестве имени экземпляра VPN. |
| collector_meth |
Нет | Настраивает устройство на отправку пакетов 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 |
| Определяет, должен ли конфиг присутствовать на устройстве или нет. |
Примеры
---
- 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