Spec-Zone.ru › Ansible

Модуль 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 — переопределить значения времени ожидания.

Варианты:

  • 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

Порт, используемый интерфейсом прокси-сервера.

По умолчанию: "10051"

useip

integer

Подключаться к интерфейсу прокси-сервера по IP-адресу, а не по DNS-имени.

0 (не использовать IP), 1 (использовать IP).

Варианты:

  • 0 ← (по умолчанию)
  • 1

local_address

string

Параметр появился в Zabbix 7.0.

Адрес для активных агентов. IP-адрес или DNS-имя для подключения.

Обязательно, если proxy_groupid не равен 0.

local_port

string

Параметр появился в Zabbix 7.0.

Номер локального порта прокси-сервера для подключения.

Поддерживается, если proxy_groupid не равен 0.

По умолчанию: "10051"

operating_mode

string

Параметр появился в Zabbix 7.0.

Тип прокси-сервера.

Варианты:

  • "active" ← (по умолчанию)
  • "passive"

port

string

Параметр появился в Zabbix 7.0.

Номер порта для подключения.

Поддерживается, если режим работы прокси-сервера Zabbix — пассивный.

По умолчанию: "10051"

proxy_address

string

Устарело для версии Zabbix >= 7.0.

Разделённый запятыми список IP-адресов/CIDR или DNS-имён, от которых разрешено принимать запросы активных прокси-серверов.

Требуется status=active.

proxy_group

string

Параметр появился в Zabbix 7.0.

Имя группы прокси-серверов.

proxy_name

string / обязательный

Имя прокси-сервера в Zabbix.

state

string

Состояние прокси-сервера.

При значении present модуль создаст прокси-сервер, если он не существует, или обновит его, если связанные с ним данные отличаются.

При значении absent модуль удалит прокси-сервер, если он существует.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

status

string

Устарело для версии Zabbix >= 7.0.

Тип прокси-сервера. (4 — активный, 5 — пассивный)

Варианты:

  • "active" ← (по умолчанию)
  • "passive"

timeout_browser

string

Параметр появился в Zabbix 7.0.

Максимальное время обработки проверок типа browser в секундах.

Принимает секунды или единицу времени с суффиксом (например, 30s, 1m).

Допустимый диапазон значений: 1–600s.

Обязателен, если custom_timeouts имеет значение 1.

timeout_db_monitor

string

Параметр появился в Zabbix 7.0.

Максимальное время обработки проверок БД в секундах.

Принимает секунды или единицу времени с суффиксом (например, 30s, 1m).

Допустимый диапазон значений: 1–600s.

Обязателен, если custom_timeouts имеет значение 1.

timeout_external_check

string

Параметр появился в Zabbix 7.0.

Максимальное время обработки внешних проверок в секундах.

Принимает секунды или единицу времени с суффиксом (например, 30s, 1m).

Допустимый диапазон значений: 1–600s.

Обязателен, если custom_timeouts имеет значение 1.

timeout_http_agent

string

Параметр появился в Zabbix 7.0.

Максимальное время обработки проверок HTTP agent в секундах.

Принимает секунды или единицу времени с суффиксом (например, 30s, 1m).

Допустимый диапазон значений: 1–600s.

Обязателен, если custom_timeouts имеет значение 1.

timeout_script

string

Параметр появился в Zabbix 7.0.

Максимальное время обработки проверок типа script в секундах.

Принимает секунды или единицу времени с суффиксом (например, 30s, 1m).

Допустимый диапазон значений: 1–600s.

Обязателен, если custom_timeouts имеет значение 1.

timeout_simple_check

string

Параметр появился в Zabbix 7.0.

Максимальное время обработки простых проверок в секундах.

Принимает секунды или единицу времени с суффиксом (например, 30s, 1m).

Допустимый диапазон значений: 1–600s.

Обязателен, если custom_timeouts имеет значение 1.

timeout_snmp_agent

string

Параметр появился в Zabbix 7.0.

Максимальное время обработки проверок агента SNMP в секундах.

Принимает секунды или единицу времени с суффиксом (например, 30s, 1m).

Допустимый диапазон значений: 1–600s.

Обязателен, если custom_timeouts имеет значение 1.

timeout_ssh_agent

string

Параметр появился в Zabbix 7.0.

Максимальное время обработки проверок SSH в секундах.

Принимает секунды или единицу времени с суффиксом (например, 30s, 1m).

Допустимый диапазон значений: 1–600s.

Обязателен, если custom_timeouts имеет значение 1.

timeout_telnet_agent

string

Параметр появился в Zabbix 7.0.

Максимальное время обработки проверок Telnet в секундах.

Принимает секунды или единицу времени с суффиксом (например, 30s, 1m).

Допустимый диапазон значений: 1–600s.

Обязателен, если custom_timeouts имеет значение 1.

timeout_zabbix_agent

string

Параметр появился в Zabbix 7.0.

Максимальное время обработки проверок агента Zabbix в секундах.

Принимает секунды или единицу времени с суффиксом (например, 30s, 1m).

Допустимый диапазон значений: 1–600s.

Обязателен, если custom_timeouts имеет значение 1.

tls_accept

string

Подключения от прокси-сервера.

Варианты:

  • "no_encryption" ← (по умолчанию)
  • "PSK"
  • "certificate"

tls_connect

string

Подключения к прокси-серверу.

Варианты:

  • "no_encryption" ← (по умолчанию)
  • "PSK"
  • "certificate"

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

Авторы

  • Alen Komic (@akomic)

Ссылки на коллекцию

  • Отслеживание проблем
  • Домашняя страница
  • Репозиторий (исходный код)

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API