Модуль fortinet.fortios.fortios_log_fact — получение данных журналов объектов FortiOS.
Примечание
Этот модуль входит в коллекцию fortinet.fortios (версия 2.5.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: fortinet.fortios.fortios_log_fact.
Добавлено в fortinet.fortios 2.1.0
Краткое описание
- Получение журналов, связанных с диском, памятью, FortiAnalyzer и FortiCloud.
Требования
Следующие требования необходимы на хосте, на котором выполняется этот модуль.
- Установленная коллекция Galaxy fortinet.fortios >= 2.1.0.
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Аутентификация на основе токена. Токен создается в графическом интерфейсе FortiGate. |
enable_log boolean | Включить или отключить ведение журнала для задачи. Варианты:
|
filters list / elements=string | Список выражений для фильтрации возвращаемых результатов. Элементы списка объединяются оператором «И» с помощью амперсанда. Отдельный элемент можно объединить с помощью запятой оператором «ИЛИ». |
formatters list / elements=string | Список полей для отображения в возвращаемых результатах. |
params dictionary | Параметр для каждого селектора; определение см. в списке выше. |
selector string | Селектор типа получаемого журнала Варианты:
|
selectors list / elements=dictionary | Список селекторов для получения типа журнала. |
|
filters list / elements=string |
Список выражений для фильтрации возвращаемых результатов. Элементы списка объединяются оператором «И» с помощью амперсанда. Отдельный элемент можно объединить с помощью запятой оператором «ИЛИ». |
|
formatters list / elements=string |
Список полей для отображения в возвращаемых результатах. |
|
params dictionary |
Параметр для каждого селектора; определение см. в списке выше. |
|
selector string / обязательный |
Селектор типа получаемого журнала Варианты:
|
|
sorters list / elements=string |
Список выражений для сортировки возвращаемых результатов. Элементы списка сортируются по возрастанию; для их объединения используется амперсанд. Отдельный элемент можно отсортировать по убыванию, указав запятую внутри него. |
sorters list / elements=string | Список выражений для сортировки возвращаемых результатов. Элементы списка сортируются по возрастанию; для их объединения используется амперсанд. Отдельный элемент можно отсортировать по убыванию, указав запятую внутри него. |
vdom string | Виртуальный домен из числа ранее определенных. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство. По умолчанию: |
Примечания
Примечание
- У разных селекторов могут быть разные параметры; пользователям необходимо найти параметры для конкретного селектора.
- Для некоторых селекторов объекты являются глобальными, поэтому параметры указывать нельзя.
- Для селектора не все параметры являются обязательными.
- Этот модуль предназначен исключительно для API журналов FortiOS.
Примеры
- name: get disk event user and memory event user at once.
fortinet.fortios.fortios_log_fact:
access_token: "you_own_value"
selectors:
- selector: disk_event_user
filters:
- log_id==41000
- selector: memory_event_user
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
build string | Номер сборки образа FortiGate Возвращается: всегда Пример: |
rows integer | Количество возвращаемых строк Возвращается: всегда Пример: |
serial string | Серийный номер устройства Возвращается: всегда Пример: |
session_id integer | Идентификатор сеанса для запроса Возвращается: всегда Пример: |
start integer | Номер первой возвращаемой строки Возвращается: всегда Пример: |
status string | Результат выполнения операции Возвращается: всегда Пример: |
subcategory string | Тип журнала, который можно получить Возвращается: всегда Пример: |
total_lines integer | Общее количество строк, полученных в результате Возвращается: всегда Пример: |
vdom string | Используемый виртуальный домен Возвращается: всегда Пример: |
version string | Версия FortiGate Возвращается: всегда Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/fortinet/fortios/fortios_log_fact_module.html