community.routeros.facts – Сбор фактов с удаленных устройств, работающих под управлением MikroTik RouterOS
Примечание
Этот плагин входит в коллекцию community.routeros (версия 1.1.0).
Для его установки используйте: ansible-galaxy collection install community.routeros.
Чтобы использовать его в книге задач, укажите: community.routeros.facts.
Описание
- Сбор базового набора фактов устройства с удаленного устройства под управлением RouterOS. Этот модуль добавляет к всем ключам базовых сетевых фактов префикс
ansible_net_<fact>. Модуль фактов всегда собирает базовый набор фактов с устройства и может включать или отключать сбор дополнительных фактов.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| gather_subset строка | По умолчанию: "!config" | При указании этого аргумента сбор фактов будет ограничен заданным подмножеством. Возможные значения для этого аргумента включают all, hardware, config, и interfaces. Можно указать список значений для включения более широкого подмножества. Значения также могут быть использованы с начальным ! для указания того, что определенное подмножество не должно собираться. |
Примеры
- name: Collect all facts from the device
community.routeros.facts:
gather_subset: all
- name: Collect only the config and default facts
community.routeros.facts:
gather_subset:
- config
- name: Do not collect hardware facts
community.routeros.facts:
gather_subset:
- "!hardware"
Возвращаемые факты
Факты, возвращаемые этим модулем, добавляются/обновляются в фактах хоста hostvars и могут быть использованы по имени, как и любые другие факты хоста. Для их использования не требуется регистрация.
| Факт | Возвращается | Описание |
|---|---|---|
| ansible_net_all_ipv4_addresses список / элементы=строка | при конфигурации интерфейсов | Все настроенные IPv4-адреса на устройстве |
| ansible_net_all_ipv6_addresses список / элементы=строка | при конфигурации интерфейсов | Все настроенные IPv6-адреса на устройстве |
| ansible_net_arch строка / элементы=строка | всегда | Архитектура процессора устройства |
| ansible_net_bgp_instance словарь / элементы=строка | информация об экземпляре BGP | Словарь информации об экземпляре BGP |
| ansible_net_bgp_peer словарь / элементы=строка | информация о пире | Словарь информации о пире BGP |
| ansible_net_bgp_vpnv4_route словарь / элементы=строка | информация о маршруте vpnv4 | Словарь информации о маршруте BGP vpnv4 |
| ansible_net_config строка / элементы=строка | при конфигурации | Текущая активная конфигурация с устройства |
| ansible_net_cpu_load строка / элементы=строка | всегда | Текущая нагрузка процессора |
| ansible_net_gather_subset список / элементы=строка | всегда | Список подмножеств фактов, собранных с устройства |
| ansible_net_hostname строка / элементы=строка | всегда | Настроенное имя хоста устройства |
| ansible_net_interfaces словарь / элементы=строка | при конфигурации интерфейсов | Хэш всех интерфейсов, работающих на системе |
| ansible_net_memfree_mb целое число / элементы=строка | при конфигурации оборудования | Доступная свободная память на удаленном устройстве в МБ |
| ansible_net_memtotal_mb целое число / элементы=строка | при конфигурации оборудования | Общий объем памяти на удаленном устройстве в МБ |
| ansible_net_model строка / элементы=строка | всегда | Имя модели, возвращенное устройством |
| ansible_net_neighbors словарь / элементы=строка | при конфигурации интерфейсов | Список соседей с удаленного устройства |
| ansible_net_ospf_instance словарь / элементы=строка | информация об экземпляре OSPF | Словарь информации об экземпляре OSPF |
| ansible_net_ospf_neighbor словарь / элементы=строка | информация о соседе OSPF | Словарь информации о соседе OSPF |
| ansible_net_route словарь / элементы=строка | информация о маршрутах во всех таблицах маршрутизации | Словарь маршрутов во всех таблицах маршрутизации |
| ansible_net_serialnum строка / элементы=строка | всегда | Серийный номер удаленного устройства |
| ansible_net_spacefree_mb словарь / элементы=строка | при конфигурации оборудования | Доступное дисковое пространство на удаленном устройстве в МБ |
| ansible_net_spacetotal_mb словарь / элементы=строка | при конфигурации оборудования | Общий объем дискового пространства на удаленном устройстве в МБ |
| ansible_net_uptime строка / элементы=строка | всегда | Время работы устройства |
| ansible_net_version строка / элементы=строка | всегда | Версия операционной системы, работающей на удаленном устройстве |
Авторы
- Егор Зайцев (@heuels)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/routeros/facts_module.html