Модуль community.zabbix.zabbix_proxy — создание, удаление, получение и обновление прокси-серверов Zabbix
Примечание
Этот модуль входит в коллекцию community.zabbix (версия 4.2.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install community.zabbix. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: community.zabbix.zabbix_proxy.
Краткое описание
- Этот модуль позволяет создавать, изменять, получать и удалять записи прокси-серверов Zabbix.
Требования
Перечисленные ниже компоненты должны быть установлены на узле, выполняющем этот модуль.
- python >= 3.9
Параметры
Параметр | Описание |
|---|---|
address string | Параметр появился в Zabbix 7.0. IP-адрес или DNS-имя для подключения. Обязателен, если режим работы прокси-сервера Zabbix — пассивный. |
allowed_addresses string | Параметр появился в Zabbix 7.0. Разделённые запятыми IP-адреса или DNS-имена активного прокси-сервера Zabbix. |
ca_cert псевдонимы: tls_issuer string | Издатель сертификата. |
custom_timeouts integer | Параметр появился в Zabbix 7.0. Переопределять ли глобальные значения времени ожидания элементов данных на уровне прокси-сервера. 0 — использовать глобальные настройки; 1 — переопределить значения времени ожидания. Варианты:
|
description string | Описание прокси-сервера. |
http_login_password string | Пароль для базовой аутентификации |
http_login_user string | Имя пользователя для базовой аутентификации |
interface dictionary | Устарело для версии Zabbix >= 7.0. Словарь с параметрами интерфейса для прокси-сервера в пассивном режиме. Дополнительные сведения см. в документации по интерфейсу прокси-сервера: https://www.zabbix.com/documentation/current/en/manual/api/reference/proxy/object#proxy-interface. По умолчанию: |
|
dns string |
DNS-имя интерфейса прокси-сервера. Обязательно, если useip=0. По умолчанию: |
|
ip string |
IP-адрес, используемый интерфейсом прокси-сервера. Обязательно, если useip=1. По умолчанию: |
|
port string |
Порт, используемый интерфейсом прокси-сервера. По умолчанию: |
|
useip integer |
Подключаться к интерфейсу прокси-сервера по IP-адресу, а не по DNS-имени. 0 (не использовать IP), 1 (использовать IP). Варианты:
|
local_address string | Параметр появился в Zabbix 7.0. Адрес для активных агентов. IP-адрес или DNS-имя для подключения. Обязательно, если proxy_groupid не равен 0. |
local_port string | Параметр появился в Zabbix 7.0. Номер локального порта прокси-сервера для подключения. Поддерживается, если proxy_groupid не равен 0. По умолчанию: |
operating_mode string | Параметр появился в Zabbix 7.0. Тип прокси-сервера. Варианты:
|
port string | Параметр появился в Zabbix 7.0. Номер порта для подключения. Поддерживается, если режим работы прокси-сервера Zabbix — пассивный. По умолчанию: |
proxy_address string | Устарело для версии Zabbix >= 7.0. Разделённый запятыми список IP-адресов/CIDR или DNS-имён, от которых разрешено принимать запросы активных прокси-серверов. Требуется status=active. |
proxy_group string | Параметр появился в Zabbix 7.0. Имя группы прокси-серверов. |
proxy_name string / обязательный | Имя прокси-сервера в Zabbix. |
state string | Состояние прокси-сервера. При значении При значении Варианты:
|
status string | Устарело для версии Zabbix >= 7.0. Тип прокси-сервера. (4 — активный, 5 — пассивный) Варианты:
|
timeout_browser string | Параметр появился в Zabbix 7.0. Максимальное время обработки проверок типа browser в секундах. Принимает секунды или единицу времени с суффиксом (например, 30s, 1m). Допустимый диапазон значений: 1–600s. Обязателен, если |
timeout_db_monitor string | Параметр появился в Zabbix 7.0. Максимальное время обработки проверок БД в секундах. Принимает секунды или единицу времени с суффиксом (например, 30s, 1m). Допустимый диапазон значений: 1–600s. Обязателен, если |
timeout_external_check string | Параметр появился в Zabbix 7.0. Максимальное время обработки внешних проверок в секундах. Принимает секунды или единицу времени с суффиксом (например, 30s, 1m). Допустимый диапазон значений: 1–600s. Обязателен, если |
timeout_http_agent string | Параметр появился в Zabbix 7.0. Максимальное время обработки проверок HTTP agent в секундах. Принимает секунды или единицу времени с суффиксом (например, 30s, 1m). Допустимый диапазон значений: 1–600s. Обязателен, если |
timeout_script string | Параметр появился в Zabbix 7.0. Максимальное время обработки проверок типа script в секундах. Принимает секунды или единицу времени с суффиксом (например, 30s, 1m). Допустимый диапазон значений: 1–600s. Обязателен, если |
timeout_simple_check string | Параметр появился в Zabbix 7.0. Максимальное время обработки простых проверок в секундах. Принимает секунды или единицу времени с суффиксом (например, 30s, 1m). Допустимый диапазон значений: 1–600s. Обязателен, если |
timeout_snmp_agent string | Параметр появился в Zabbix 7.0. Максимальное время обработки проверок агента SNMP в секундах. Принимает секунды или единицу времени с суффиксом (например, 30s, 1m). Допустимый диапазон значений: 1–600s. Обязателен, если |
timeout_ssh_agent string | Параметр появился в Zabbix 7.0. Максимальное время обработки проверок SSH в секундах. Принимает секунды или единицу времени с суффиксом (например, 30s, 1m). Допустимый диапазон значений: 1–600s. Обязателен, если |
timeout_telnet_agent string | Параметр появился в Zabbix 7.0. Максимальное время обработки проверок Telnet в секундах. Принимает секунды или единицу времени с суффиксом (например, 30s, 1m). Допустимый диапазон значений: 1–600s. Обязателен, если |
timeout_zabbix_agent string | Параметр появился в Zabbix 7.0. Максимальное время обработки проверок агента Zabbix в секундах. Принимает секунды или единицу времени с суффиксом (например, 30s, 1m). Допустимый диапазон значений: 1–600s. Обязателен, если |
tls_accept string | Подключения от прокси-сервера. Варианты:
|
tls_connect string | Подключения к прокси-серверу. Варианты:
|
tls_psk string | Предварительно установленный ключ длиной не менее 32 шестнадцатеричных цифр. Обязателен, если для tls_connect или tls_accept включён PSK. |
tls_psk_identity string | Идентификатор PSK. Обязателен, если для tls_connect или tls_accept включён PSK. |
tls_subject string | Субъект сертификата. |
Примеры
# If you want to use Username and Password to be authenticated by Zabbix Server
- name: Set credentials to access Zabbix Server API
ansible.builtin.set_fact:
ansible_user: Admin
ansible_httpapi_pass: zabbix
# If you want to use API token to be authenticated by Zabbix Server
# https://www.zabbix.com/documentation/current/en/manual/web_interface/frontend_sections/administration/general#api-tokens
- name: Set API token
ansible.builtin.set_fact:
ansible_zabbix_auth_key: 8ec0d52432c15c91fcafe9888500cf9a607f44091ab554dbee860f6b44fac895
- name: Create or update a proxy with proxy type active (Zabbix version < 7.0)
# set task level variables as we change ansible_connection plugin here
vars:
ansible_network_os: community.zabbix.zabbix
ansible_connection: httpapi
ansible_httpapi_port: 443
ansible_httpapi_use_ssl: true
ansible_httpapi_validate_certs: false
ansible_zabbix_url_path: "zabbixeu" # If Zabbix WebUI runs on non-default (zabbix) path ,e.g. http://<FQDN>/zabbixeu
ansible_host: zabbix-example-fqdn.org
community.zabbix.zabbix_proxy:
proxy_name: ExampleProxy
description: ExampleProxy
status: active
state: present
proxy_address: ExampleProxy.local
- name: Create a new passive proxy using only its IP (Zabbix version < 7.0)
# set task level variables as we change ansible_connection plugin here
vars:
ansible_network_os: community.zabbix.zabbix
ansible_connection: httpapi
ansible_httpapi_port: 443
ansible_httpapi_use_ssl: true
ansible_httpapi_validate_certs: false
ansible_zabbix_url_path: "zabbixeu" # If Zabbix WebUI runs on non-default (zabbix) path ,e.g. http://<FQDN>/zabbixeu
ansible_host: zabbix-example-fqdn.org
community.zabbix.zabbix_proxy:
proxy_name: ExampleProxy
description: ExampleProxy
status: passive
state: present
interface:
useip: 1
ip: 10.1.1.2
port: 10051
- name: Create a new passive proxy using only its DNS (Zabbix version < 7.0)
# set task level variables as we change ansible_connection plugin here
vars:
ansible_network_os: community.zabbix.zabbix
ansible_connection: httpapi
ansible_httpapi_port: 443
ansible_httpapi_use_ssl: true
ansible_httpapi_validate_certs: false
ansible_zabbix_url_path: "zabbixeu" # If Zabbix WebUI runs on non-default (zabbix) path ,e.g. http://<FQDN>/zabbixeu
ansible_host: zabbix-example-fqdn.org
community.zabbix.zabbix_proxy:
proxy_name: ExampleProxy
description: ExampleProxy
status: passive
state: present
interface:
dns: proxy.example.com
port: 10051
- name: Create or update a proxy with proxy type active (Zabbix version >= 7.0)
# set task level variables as we change ansible_connection plugin here
vars:
ansible_network_os: community.zabbix.zabbix
ansible_connection: httpapi
ansible_httpapi_port: 443
ansible_httpapi_use_ssl: true
ansible_httpapi_validate_certs: false
ansible_zabbix_url_path: "zabbixeu" # If Zabbix WebUI runs on non-default (zabbix) path ,e.g. http://<FQDN>/zabbixeu
ansible_host: zabbix-example-fqdn.org
community.zabbix.zabbix_proxy:
proxy_name: ExampleProxy
description: ExampleProxy
operating_mode: active
state: present
allowed_addresses: ExampleProxy.local
- name: Create a new passive proxy using only its IP (Zabbix version >= 7.0)
# set task level variables as we change ansible_connection plugin here
vars:
ansible_network_os: community.zabbix.zabbix
ansible_connection: httpapi
ansible_httpapi_port: 443
ansible_httpapi_use_ssl: true
ansible_httpapi_validate_certs: false
ansible_zabbix_url_path: "zabbixeu" # If Zabbix WebUI runs on non-default (zabbix) path ,e.g. http://<FQDN>/zabbixeu
ansible_host: zabbix-example-fqdn.org
community.zabbix.zabbix_proxy:
proxy_name: ExampleProxy
description: ExampleProxy
operating_mode: passive
state: present
address: 10.1.1.2
port: 10051
- name: Create a new passive proxy using only its DNS (Zabbix version >= 7.0)
# set task level variables as we change ansible_connection plugin here
vars:
ansible_network_os: community.zabbix.zabbix
ansible_connection: httpapi
ansible_httpapi_port: 443
ansible_httpapi_use_ssl: true
ansible_httpapi_validate_certs: false
ansible_zabbix_url_path: "zabbixeu" # If Zabbix WebUI runs on non-default (zabbix) path ,e.g. http://<FQDN>/zabbixeu
ansible_host: zabbix-example-fqdn.org
community.zabbix.zabbix_proxy:
proxy_name: ExampleProxy
description: ExampleProxy
operating_mode: passive
state: present
address: proxy.example.com
port: 10051
Ссылки на коллекцию
© 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/community/zabbix/zabbix_proxy_module.html