community.routeros.facts – Сбор фактов с удаленных устройств, работающих под управлением MikroTik RouterOS
Примечание
Этот плагин является частью коллекции community.routeros (версия 1.1.0).
Для его установки используйте: ansible-galaxy collection install community.routeros
Для использования в playbook укажите: 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 словарь / элементы=строка | информация о peer | Словарь информации о 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/routeros/facts_module.html