Модуль fortinet.fortimanager.fmgr_system_log_settings – Настройки журналирования.
Примечание
Этот модуль входит в коллекцию fortinet.fortimanager (версия 2.14.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install fortinet.fortimanager.
Чтобы использовать её в плейбуке, укажите: fortinet.fortimanager.fmgr_system_log_settings.
Добавлено в fortinet.fortimanager 2.0.0
Краткое описание
- Этот модуль позволяет настраивать устройство FortiManager.
- Примеры содержат все параметры и значения, которые необходимо адаптировать к источникам данных перед использованием.
Параметры
Параметр | Комментарии |
|---|---|
access_token string | Токен для доступа к FortiManager без использования имени пользователя и пароля. |
bypass_validation boolean | Устанавливайте значение True только в том случае, если схема модуля отличается от структуры API FortiManager. Модуль продолжит выполнение без проверки параметров. Варианты:
|
enable_log boolean | Включить или отключить ведение журнала для задачи. Варианты:
|
forticloud_access_token string | Аутентификация клиента Ansible с помощью токена доступа к API FortiCloud. |
proposed_method string | Метод, переопределяющий метод базового запроса Json RPC. Варианты:
|
rc_failed list / elements=integer | Список кодов rc, для которых будут переопределены условия сбоя. |
rc_succeeded list / elements=integer | Список кодов rc, для которых будут переопределены условия успешного выполнения. |
system_log_settings dictionary | Набор параметров верхнего уровня. |
|
browse_max_logfiles псевдонимы: browse-max-logfiles integer |
Максимальное количество файлов журнала при каждой попытке просмотра журналов для каждого ADOM. |
|
client_cert_auth псевдонимы: client-cert-auth dictionary |
Аутентификация по сертификату клиента. |
|
mode string |
Режим. Варианты:
|
|
tls_port псевдонимы: tls-port string |
Порт TLS. Варианты:
|
|
trusted_client псевдонимы: trusted-client list / elements=dictionary |
Доверенный клиент. |
|
certificate any |
(список) Сертификат. |
|
description string |
Описание. |
|
domain string |
Домен. |
|
id integer |
Идентификатор. |
|
type string |
Тип. Варианты:
|
|
device_auto_detect псевдонимы: device-auto-detect string |
Включить или отключить поиск идентификатора устройства в полученных без шифрования сообщениях syslog. disable — отключить поиск идентификатора устройства в полученных без шифрования сообщениях syslog. enable — включить поиск идентификатора устройства в полученных без шифрования сообщениях syslog. Варианты:
|
|
dns_resolve_dstip псевдонимы: dns-resolve-dstip string |
Включить или отключить разрешение IP-адреса назначения с помощью DNS. disable — отключить разрешение IP-адреса назначения с помощью DNS. enable — включить разрешение IP-адреса назначения с помощью DNS. Варианты:
|
|
download_max_logs псевдонимы: download-max-logs integer |
Максимальное количество записей журнала при каждой попытке их загрузки. |
|
FAC_custom_field1 псевдонимы: FAC-custom-field1 string |
Имя настраиваемого поля журнала для индексации. |
|
FAZ_custom_field1 псевдонимы: FAZ-custom-field1 string |
Имя настраиваемого поля журнала для индексации. |
|
FCH_custom_field1 псевдонимы: FCH-custom-field1 string |
Имя настраиваемого поля журнала для индексации. |
|
FCT_custom_field1 псевдонимы: FCT-custom-field1 string |
Имя настраиваемого поля журнала для индексации. |
|
FDD_custom_field1 псевдонимы: FDD-custom-field1 string |
Имя настраиваемого поля журнала для индексации. |
|
FFW_custom_field1 псевдонимы: FFW-custom-field1 string |
Настраиваемое поле FFW 1. |
|
FGT_custom_field1 псевдонимы: FGT-custom-field1 string |
Имя настраиваемого поля журнала для индексации. |
|
FMG_custom_field1 псевдонимы: FMG-custom-field1 string |
Имя настраиваемого поля журнала для индексации. |
|
FML_custom_field1 псевдонимы: FML-custom-field1 string |
Имя настраиваемого поля журнала для индексации. |
|
FPX_custom_field1 псевдонимы: FPX-custom-field1 string |
Имя настраиваемого поля журнала для индексации. |
|
FSA_custom_field1 псевдонимы: FSA-custom-field1 string |
Имя настраиваемого поля журнала для индексации. |
|
FWB_custom_field1 псевдонимы: FWB-custom-field1 string |
Имя настраиваемого поля журнала для индексации. |
|
ha_auto_migrate псевдонимы: ha-auto-migrate string |
Включить или отключить автоматическое объединение журналов участников HA-кластера. disable — отключить автоматическое объединение журналов участников HA-кластера. enable — включить автоматическое объединение журналов участников HA-кластера. Варианты:
|
|
import_max_logfiles псевдонимы: import-max-logfiles integer |
Максимальное количество файлов журнала при каждой попытке импорта журналов. |
|
keep_dev_logs псевдонимы: keep-dev-logs string |
Включить или отключить сохранение журналов устройства после его удаления. disable — отключить сохранение журналов устройства после его удаления. enable — включить сохранение журналов устройства после его удаления. Варианты:
|
|
legacy_auth_mode псевдонимы: legacy-auth-mode string |
Включить или отключить устаревший режим аутентификации устройства с помощью имени пользователя и пароля. disable — отключить поддержку устаревшего режима аутентификации. enable — включить поддержку устаревшего режима аутентификации. Варианты:
|
|
log_file_archive_name псевдонимы: log-file-archive-name string |
Формат имени файла журнала для архивирования, например при резервном копировании, отправке или загрузке. basic — базовый формат имени файла архива журнала, например extended — расширенный формат имени файла архива журнала, например Варианты:
|
|
log_interval_dev_no_logging псевдонимы: log-interval-dev-no-logging integer |
Интервал в минутах, в течение которого устройство не получает журналы, прежде чем будет считаться недоступным. |
|
log_process_fast_mode псевдонимы: log-process-fast-mode string |
Включить или отключить быстрый режим обработки журналов. disable — отключить быстрый режим обработки журналов. enable — включить быстрый режим обработки журналов. Варианты:
|
|
log_upload_interval_dev_no_logging псевдонимы: log-upload-interval-dev-no-logging integer |
Интервал в минутах, в течение которого устройство не отправляет журналы, прежде чем будет считаться недоступным. |
|
rolling_analyzer псевдонимы: rolling-analyzer dictionary |
Циклическая обработка анализатора. |
|
days list / elements=string |
Расписание циклической обработки файлов журнала sun — воскресенье. mon — понедельник. tue — вторник. wed — среда. thu — четверг. fri — пятница. sat — суббота. Варианты:
|
|
del_files псевдонимы: del-files string |
Включить или отключить удаление файлов журнала после отправки. disable — отключить удаление файлов журнала. enable — включить удаление файлов журнала. Варианты:
|
|
directory string |
Каталог на сервере для отправки; для сервера Unix используйте абсолютный путь |
|
file_size псевдонимы: file-size integer |
Циклически переключать файлы журнала при достижении этого размера |
|
gzip_format псевдонимы: gzip-format string |
Включить или отключить сжатие отправляемых файлов журнала. disable — отключить сжатие. enable — включить сжатие. Варианты:
|
|
hour integer |
Расписание циклической обработки файлов журнала |
|
ip string |
IP-адрес сервера для отправки. |
|
ip2 string |
IP-адрес 2 сервера для отправки. |
|
ip3 string |
IP-адрес 3 сервера для отправки. |
|
log_format aliases: log-format string |
Формат загружаемых файлов журнала. native — Собственный формат text — Текстовый формат csv — CSV Варианты:
|
|
min integer |
Расписание ротации файлов журнала |
|
password any |
(список) Пароль для входа на сервер загрузки. |
|
password2 any |
(список) Пароль password2 для входа на сервер загрузки. |
|
password3 any |
(список) Пароль password3 для входа на сервер загрузки. |
|
port integer |
Номер порта IP-адреса 1 сервера загрузки. |
|
port2 integer |
Номер порта IP-адреса 2 сервера загрузки. |
|
port3 integer |
Номер порта IP-адреса 3 сервера загрузки. |
|
rolling_upgrade_status aliases: rolling-upgrade-status integer |
Состояние поэтапного обновления |
|
server string |
FQDN/IP-адрес сервера загрузки. |
|
server2 string |
FQDN/IP-адрес сервера загрузки 2. |
|
server3 string |
FQDN/IP-адрес сервера загрузки 3. |
|
server_type aliases: server-type string |
Тип сервера загрузки. ftp — Загрузка через FTP. sftp — Загрузка через SFTP. scp — Загрузка через SCP. Варианты:
|
|
upload string |
Включить или отключить загрузку файлов журнала. disable — Отключить загрузку файлов журнала. enable — Включить загрузку файлов журнала. Варианты:
|
|
upload_hour aliases: upload-hour integer |
Расписание загрузки файлов журнала |
|
upload_mode aliases: upload-mode string |
Режим загрузки при использовании нескольких серверов. backup — При сбое подключения выполняется попытка подключения к следующему серверу. mirror — Выполняется попытка подключения ко всем настроенным серверам, и они используются. Варианты:
|
|
upload_trigger aliases: upload-trigger string |
Событие, запускающее загрузку файлов журнала. on-roll — Загружать файлы журнала после их ротации. on-schedule — Загружать файлы журнала ежедневно. Варианты:
|
|
username string |
Имя пользователя для входа на сервер загрузки. |
|
username2 string |
Имя пользователя username2 для входа на сервер загрузки. |
|
username3 string |
Имя пользователя username3 для входа на сервер загрузки. |
|
when string |
Периодически выполнять ротацию файлов журнала. none — Не выполнять периодическую ротацию файлов журнала. daily — Выполнять ротацию файлов журнала ежедневно. weekly — Выполнять ротацию файлов журнала в определенные дни недели. Варианты:
|
|
rolling_local aliases: rolling-local dictionary |
Локальная ротация. |
|
days list / elements=string |
Расписание ротации файлов журнала sun — Воскресенье. mon — Понедельник. tue — Вторник. wed — Среда. thu — Четверг. fri — Пятница. sat — Суббота. Варианты:
|
|
del_files aliases: del-files string |
Включить или отключить удаление файлов журнала после загрузки. disable — Отключить удаление файлов журнала. enable — Включить удаление файлов журнала. Варианты:
|
|
directory string |
Каталог на сервере загрузки; для Unix-сервера укажите абсолютный путь |
|
file_size aliases: file-size integer |
Выполнять ротацию файлов журнала при достижении этого размера |
|
gzip_format aliases: gzip-format string |
Включить или отключить сжатие загружаемых файлов журнала. disable — Отключить сжатие. enable — Включить сжатие. Варианты:
|
|
hour integer |
Расписание ротации файлов журнала |
|
ip string |
IP-адрес сервера загрузки. |
|
ip2 string |
IP-адрес сервера загрузки 2. |
|
ip3 string |
IP-адрес сервера загрузки 3. |
|
log_format aliases: log-format string |
Формат загружаемых файлов журнала. native — Собственный формат text — Текстовый формат csv — CSV Варианты:
|
|
min integer |
Расписание ротации файлов журнала |
|
password any |
(список) Пароль для входа на сервер загрузки. |
|
password2 any |
(список) Пароль password2 для входа на сервер загрузки. |
|
password3 any |
(список) Пароль password3 для входа на сервер загрузки. |
|
port integer |
Номер порта IP-адреса 1 сервера загрузки. |
|
port2 integer |
Номер порта IP-адреса 2 сервера загрузки. |
|
port3 integer |
Номер порта IP-адреса 3 сервера загрузки. |
|
rolling_upgrade_status aliases: rolling-upgrade-status integer |
Состояние поэтапного обновления |
|
server string |
FQDN/IP-адрес сервера загрузки. |
|
server2 string |
FQDN/IP-адрес сервера загрузки 2. |
|
server3 string |
FQDN/IP-адрес сервера загрузки 3. |
|
server_type aliases: server-type string |
Тип сервера загрузки. ftp — Загрузка через FTP. sftp — Загрузка через SFTP. scp — Загрузка через SCP. Варианты:
|
|
upload string |
Включить или отключить загрузку файлов журнала. disable — Отключить загрузку файлов журнала. enable — Включить загрузку файлов журнала. Варианты:
|
|
upload_hour aliases: upload-hour integer |
Расписание загрузки файлов журнала |
|
upload_mode aliases: upload-mode string |
Режим загрузки при использовании нескольких серверов. backup — При сбое подключения выполняется попытка подключения к следующему серверу. mirror — Выполняется попытка подключения ко всем настроенным серверам, и они используются. Варианты:
|
|
upload_trigger aliases: upload-trigger string |
Событие, запускающее загрузку файлов журнала. on-roll — Загружать файлы журнала после их ротации. on-schedule — Загружать файлы журнала ежедневно. Варианты:
|
|
username string |
Имя пользователя для входа на сервер загрузки. |
|
username2 string |
Имя пользователя username2 для входа на сервер загрузки. |
|
username3 string |
Имя пользователя username3 для входа на сервер загрузки. |
|
when string |
Периодически выполнять ротацию файлов журнала. none — Не выполнять периодическую ротацию файлов журнала. daily — Выполнять ротацию файлов журнала ежедневно. weekly — Выполнять ротацию файлов журнала в определенные дни недели. Варианты:
|
|
rolling_regular aliases: rolling-regular dictionary |
Обычная ротация. |
|
days list / elements=string |
Расписание ротации файлов журнала sun — Воскресенье. mon — Понедельник. tue — Вторник. wed — Среда. thu — Четверг. fri — Пятница. sat — Суббота. Варианты:
|
|
del_files aliases: del-files string |
Включить или отключить удаление файлов журналов после загрузки. disable — отключить удаление файлов журналов. enable — включить удаление файлов журналов. Варианты:
|
|
directory string |
Каталог на сервере для загрузки; для сервера Unix используйте абсолютный путь |
|
file_size aliases: file-size integer |
Начинать новый файл журнала при достижении этого размера |
|
gzip_format aliases: gzip-format string |
Включить или отключить сжатие загружаемых файлов журналов. disable — отключить сжатие. enable — включить сжатие. Варианты:
|
|
hour integer |
Расписание создания новых файлов журналов |
|
ip string |
IP-адрес сервера для загрузки. |
|
ip2 string |
IP-адрес 2 сервера для загрузки. |
|
ip3 string |
IP-адрес 3 сервера для загрузки. |
|
log_format aliases: log-format string |
Формат загружаемых файлов журналов. native — исходный формат text — текстовый формат csv — CSV Варианты:
|
|
min integer |
Расписание создания новых файлов журналов |
|
password any |
(список) Пароль для входа на сервер загрузки. |
|
password2 any |
(список) Пароль password2 для входа на сервер загрузки. |
|
password3 any |
(список) Пароль password3 для входа на сервер загрузки. |
|
port integer |
Номер порта IP1 сервера для загрузки. |
|
port2 integer |
Номер порта IP2 сервера для загрузки. |
|
port3 integer |
Номер порта IP3 сервера для загрузки. |
|
rolling_upgrade_status aliases: rolling-upgrade-status integer |
Состояние поэтапного обновления |
|
server string |
FQDN/IP-адрес сервера для загрузки. |
|
server2 string |
FQDN/IP-адрес сервера 2 для загрузки. |
|
server3 string |
FQDN/IP-адрес сервера 3 для загрузки. |
|
server_type aliases: server-type string |
Тип сервера для загрузки. ftp — загрузка по FTP. sftp — загрузка по SFTP. scp — загрузка по SCP. Варианты:
|
|
upload string |
Включить или отключить загрузку файлов журналов. disable — отключить загрузку файлов журналов. enable — включить загрузку файлов журналов. Варианты:
|
|
upload_hour aliases: upload-hour integer |
Расписание загрузки файлов журналов |
|
upload_mode aliases: upload-mode string |
Режим загрузки при наличии нескольких серверов. backup — серверы используются по очереди: если подключиться к одному не удалось, выполняется попытка подключения к следующему. mirror — выполняется попытка подключения ко всем настроенным серверам и используются все серверы. Варианты:
|
|
upload_trigger aliases: upload-trigger string |
Событие, запускающее загрузку файлов журналов. on-roll — загружать файлы журналов после создания новых файлов. on-schedule — загружать файлы журналов ежедневно. Варианты:
|
|
username string |
Имя пользователя для входа на сервер загрузки. |
|
username2 string |
Имя пользователя username2 для входа на сервер загрузки. |
|
username3 string |
Имя пользователя username3 для входа на сервер загрузки. |
|
when string |
Периодически создавать новые файлы журналов. none — не создавать новые файлы журналов периодически. daily — создавать новые файлы журналов ежедневно. weekly — создавать новые файлы журналов в определённые дни недели. Варианты:
|
|
sync_search_timeout aliases: sync-search-timeout integer |
Максимальное количество секунд для выполнения сеанса поиска по журналам в синхронном режиме. |
|
syslog_over_tls_port aliases: syslog-over-tls-port string |
Порт Syslog поверх TLS. Варианты:
|
|
unencrypted_logging aliases: unencrypted-logging string |
Включить или отключить получение Syslog через UDP disable — отключить получение Syslog через UDP enable — включить получение Syslog через UDP Варианты:
|
|
unencrypted_logging_tcp aliases: unencrypted-logging-tcp string |
Незашифрованное ведение журналов через TCP. Варианты:
|
|
unencrypted_logging_udp aliases: unencrypted-logging-udp string |
Незашифрованное ведение журналов через UDP. Варианты:
|
workspace_locking_adom string | ADOM, который нужно заблокировать для FortiManager, работающего в режиме рабочей области. Значением может быть global или другие ADOM, включая root. |
workspace_locking_timeout integer | Максимальное время в секундах ожидания, пока другой пользователь снимет блокировку рабочей области. По умолчанию: |
Примечания
Примечание
- Начиная с версии 2.4.0 все входные аргументы используют соглашение об именовании с подчёркиваниями (snake_case). Замените аргументы, например “var-name”, на “var_name”. Старые имена аргументов по-прежнему доступны, но при их использовании будут выводиться предупреждения об устаревании. Это предупреждение можно отключить, задав deprecation_warnings=False в ansible.cfg.
- В этом модуле FortiManager поддерживается работа в режиме блокировки рабочей области; для этого предназначены параметры верхнего уровня workspace_locking_adom и workspace_locking_timeout.
- Обычно выполнение модуля завершается ошибкой при ненулевом значении rc. Условия завершения с ошибкой или успехом также можно переопределить с помощью параметров rc_failed и rc_succeeded.
Примеры
- name: Example playbook (generated based on argument schema)
hosts: fortimanagers
connection: httpapi
gather_facts: false
tasks:
- name: Log settings.
fortinet.fortimanager.fmgr_system_log_settings:
# workspace_locking_adom: <global or your adom name>
system_log_settings:
# FAC_custom_field1: <string>
# FAZ_custom_field1: <string>
# FCH_custom_field1: <string>
# FCT_custom_field1: <string>
# FDD_custom_field1: <string>
# FGT_custom_field1: <string>
# FMG_custom_field1: <string>
# FML_custom_field1: <string>
# FPX_custom_field1: <string>
# FSA_custom_field1: <string>
# FWB_custom_field1: <string>
# browse_max_logfiles: <integer>
# dns_resolve_dstip: <value in [disable, enable]>
# download_max_logs: <integer>
# ha_auto_migrate: <value in [disable, enable]>
# import_max_logfiles: <integer>
# log_file_archive_name: <value in [basic, extended]>
# rolling_analyzer:
# days: ["sun", "mon", "tue", "wed", "thu", "fri", "sat"]
# del_files: <value in [disable, enable]>
# directory: <string>
# file_size: <integer>
# gzip_format: <value in [disable, enable]>
# hour: <integer>
# ip: <string>
# ip2: <string>
# ip3: <string>
# log_format: <value in [native, text, csv]>
# min: <integer>
# password: <list or string>
# password2: <list or string>
# password3: <list or string>
# server_type: <value in [ftp, sftp, scp]>
# upload: <value in [disable, enable]>
# upload_hour: <integer>
# upload_mode: <value in [backup, mirror]>
# upload_trigger: <value in [on-roll, on-schedule]>
# username: <string>
# username2: <string>
# username3: <string>
# when: <value in [none, daily, weekly]>
# port: <integer>
# port2: <integer>
# port3: <integer>
# rolling_upgrade_status: <integer>
# server: <string>
# server2: <string>
# server3: <string>
# rolling_local:
# days: ["sun", "mon", "tue", "wed", "thu", "fri", "sat"]
# del_files: <value in [disable, enable]>
# directory: <string>
# file_size: <integer>
# gzip_format: <value in [disable, enable]>
# hour: <integer>
# ip: <string>
# ip2: <string>
# ip3: <string>
# log_format: <value in [native, text, csv]>
# min: <integer>
# password: <list or string>
# password2: <list or string>
# password3: <list or string>
# server_type: <value in [ftp, sftp, scp]>
# upload: <value in [disable, enable]>
# upload_hour: <integer>
# upload_mode: <value in [backup, mirror]>
# upload_trigger: <value in [on-roll, on-schedule]>
# username: <string>
# username2: <string>
# username3: <string>
# when: <value in [none, daily, weekly]>
# port: <integer>
# port2: <integer>
# port3: <integer>
# rolling_upgrade_status: <integer>
# server: <string>
# server2: <string>
# server3: <string>
# rolling_regular:
# days: ["sun", "mon", "tue", "wed", "thu", "fri", "sat"]
# del_files: <value in [disable, enable]>
# directory: <string>
# file_size: <integer>
# gzip_format: <value in [disable, enable]>
# hour: <integer>
# ip: <string>
# ip2: <string>
# ip3: <string>
# log_format: <value in [native, text, csv]>
# min: <integer>
# password: <list or string>
# password2: <list or string>
# password3: <list or string>
# server_type: <value in [ftp, sftp, scp]>
# upload: <value in [disable, enable]>
# upload_hour: <integer>
# upload_mode: <value in [backup, mirror]>
# upload_trigger: <value in [on-roll, on-schedule]>
# username: <string>
# username2: <string>
# username3: <string>
# when: <value in [none, daily, weekly]>
# port: <integer>
# port2: <integer>
# port3: <integer>
# rolling_upgrade_status: <integer>
# server: <string>
# server2: <string>
# server3: <string>
# sync_search_timeout: <integer>
# keep_dev_logs: <value in [disable, enable]>
# device_auto_detect: <value in [disable, enable]>
# unencrypted_logging: <value in [disable, enable]>
# log_interval_dev_no_logging: <integer>
# log_upload_interval_dev_no_logging: <integer>
# legacy_auth_mode: <value in [disable, enable]>
# log_process_fast_mode: <value in [disable, enable]>
# FFW_custom_field1: <string>
# unencrypted_logging_tcp: <value in [disable, enable]>
# unencrypted_logging_udp: <value in [disable, enable]>
# syslog_over_tls_port: <value in [514, 6514]>
# client_cert_auth:
# mode: <value in [basic, strict]>
# tls_port: <value in [both, 514, 6514]>
# trusted_client:
# - certificate: <list or string>
# description: <string>
# domain: <string>
# id: <integer>
# type: <value in [certificate, domain]>
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
meta dictionary | Результат запроса. Возвращается: всегда |
|
request_url string |
Полный URL запроса. Возвращается: всегда Пример: |
|
response_code integer |
Состояние запроса API. Возвращается: всегда Пример: |
|
response_data list / elements=string |
Ответ API. Возвращается: всегда |
|
response_message string |
Описание ответа API. Возвращается: всегда Пример: |
|
system_information dictionary |
Информация о целевой системе. Возвращается: всегда |
rc integer | Состояние запроса. Возвращается: всегда Пример: |
version_check_warning list / elements=string | Предупреждение, если используемые в плейбуке параметры не поддерживаются текущей версией FortiManager. Возвращается: при сложных условиях |
Ссылки на коллекцию
© 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/fortimanager/fmgr_system_log_settings_module.html