bigip_log_destination – Управляет назначениями журналов на BIG-IP.
Новое в версии 2.6.
Описание
- Управляет назначениями журналов на BIG-IP.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- f5-sdk >= 3.0.16
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| описание - | Описание назначения лога. | ||
| имя - / обязательно | Указывает имя назначения лога. | ||
| раздел - | По умолчанию: "Общие" | Раздел устройства для управления ресурсами. | |
| пароль - / обязательно | Пароль учетной записи пользователя для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_PASSWORD. псевдонимы: pass, pwd | ||
| pool_settings - | Этот параметр доступен только при type remote-high-speed-log. | ||
| распределение - |
| Указывает метод распределения, используемый пунктом назначения удаленного высокоскоростного лога для отправки сообщений членам пула. Когда adaptive, подключения к членам пула будут добавляться по мере необходимости для обеспечения достаточной пропускной способности логов. Это может иметь нежелательный эффект накопления логов только на одном члене пула, если он обеспечивает достаточную пропускную способность логов самостоятельно.Когда balanced, отправляет каждый последующий лог новому члену пула, распределяя логи между ними в соответствии с методом балансировки нагрузки пула.Когда replicated, дублирует каждый лог для всех членов пула, для обеспечения резервирования.При создании нового назначения лога (и type remote-high-speed-log), если этот параметр не указан, значение по умолчанию adaptive. | |
| пул - | Указывает существующий пул серверов удаленного высокоскоростного лога, куда будут отправляться логи. При создании нового пункта назначения (и type remote-high-speed-log) этот параметр обязателен. | ||
| протокол - |
| Указывает протокол, используемый системой для отправки логов в пул серверов удаленного высокоскоростного лога, где хранятся логи. При создании нового назначения лога (и type remote-high-speed-log), если этот параметр не указан, значение по умолчанию tcp. | |
| поставщик - добавлено в 2.5 | По умолчанию: null | Объект dict, содержащий детали подключения. | |
| пароль - / обязательно | Пароль учетной записи пользователя для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_PASSWORD. псевдонимы: pass, pwd | ||
| сервер - / обязательно | Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER. | ||
| порт_сервера - | По умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER_PORT. | |
| ssh_keyfile - | Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Вы можете опустить этот параметр, установив переменную среды ANSIBLE_NET_SSH_KEYFILE. | ||
| таймаут - | По умолчанию: 10 | Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут превышен до завершения операции, модуль выдаст ошибку. | |
| транспорт - / обязательно |
| Настраивает транспортное соединение для подключения к удаленному устройству. | |
| пользователь - / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды F5_USER. | ||
| validate_certs boolean |
| Если no, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверенными сертификатами.Вы можете опустить этот параметр, установив переменную среды F5_VALIDATE_CERTS. | |
| сервер - / обязательно | Хост BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER. | ||
| порт_сервера - добавлено в 2.2 | По умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды F5_SERVER_PORT. | |
| состояние - |
| При present, гарантирует существование ресурса.При absent, гарантирует удаление ресурса. | |
| syslog_settings - | Этот параметр доступен только при type remote-syslog. | ||
| forward_to - | Указывает пункт назначения лога порта управления, который будет использоваться для пересылки логов на один сервер логов или на удаленное высокоскоростное назначение лога, которое будет использоваться для пересылки логов на пул удаленных серверов логов. При создании нового пункта назначения лога (и type remote-syslog), этот параметр обязателен. | ||
| syslog_format - |
| Указывает метод форматирования логов, связанных с удаленным пунктом назначения лога Syslog. При создании нового назначения лога (и type remote-syslog), если этот параметр не указан, значение по умолчанию bsd-syslog.Варианты syslog и rfc5424 — это два способа сказать одно и то же.Варианты bsd-syslog и rfc3164 — это два способа сказать одно и то же. | |
| тип - / обязательно |
| Указывает тип пункта назначения лога. После создания этот параметр изменить нельзя. | |
| пользователь - / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды F5_USER. | ||
| validate_certs boolean добавлено в 2.0 |
| Если no, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверенными сертификатами.Вы можете опустить этот параметр, установив переменную среды F5_VALIDATE_CERTS. | |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- На хосте требуется пакет f5-sdk Python. Это так же просто, как
pip install f5-sdk. - Требуется версия программного обеспечения BIG-IP >= 12.
- Модули F5 манипулируют только текущей конфигурацией продукта F5. Чтобы гарантировать, что конфигурация, специфичная для BIG-IP, сохранится на диске, необходимо включить по крайней мере одну задачу, использующую модуль bigip_config для сохранения текущей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения текущей конфигурации.
Примеры
- name: Create a high-speed logging destination
bigip_log_destination:
name: foo
type: remote-high-speed-log
pool_settings:
pool: my-ltm-pool
password: secret
server: lb.mydomain.com
state: present
user: admin
delegate_to: localhost
- name: Create a remote-syslog logging destination
bigip_log_destination:
name: foo
type: remote-syslog
syslog_settings:
syslog_format: rfc5424
forward_to: my-destination
password: secret
server: lb.mydomain.com
state: present
user: admin
delegate_to: localhost
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| param1 boolean | changed | Новое значение param1 ресурса. Пример: True |
| param2 string | changed | Новое значение param2 ресурса. Пример: Foo is bar |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается партнёром Ansible. [сертифицировано]
Авторы
- Tim Rupp (@caphrim007)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/bigip_log_destination_module.html
