Spec-Zone.ru › Ansible 2.8

zabbix_host – Создание/обновление/удаление хостов Zabbix

Новое в версии 2.0.

  • Обзор
  • Требования
  • Параметры
  • Примеры
  • Статус

Обзор

  • Этот модуль позволяет создавать, изменять и удалять записи хостов Zabbix, а также связанные данные групп и шаблонов.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

  • python >= 2.6
  • zabbix-api >= 0.5.3

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
ca_cert
-
добавлен в 2.5
Требуемый сертификат выдавшей организации.
Работает только с Zabbix 3.0 и выше

псевдонимы: tls_issuer
description
-
добавлен в 2.5
Описание хоста в Zabbix.
force
boolean
добавлен в 2.0
    Варианты:
  • нет
  • да ←
Перезаписывает конфигурацию хоста, даже если она уже существует.
host_groups
-
Список групп хостов, к которым принадлежит хост.
host_name
- / обязательно
Имя хоста в Zabbix.
host_name является уникальным идентификатором и не может быть обновлен с помощью данного модуля.
http_login_password
строка
добавлен в 2.1
Пароль Basic Auth
http_login_user
строка / обязательно
добавлен в 2.1
Логин Basic Auth
interfaces
-
Значение по умолчанию:
[]
Список интерфейсов, которые должны быть созданы для хоста (см. пример ниже).
Доступные ключи: dns, ip, main, port, type, useip и bulk.
Для получения дополнительной информации о поддерживаемых свойствах, обратитесь к документации по интерфейсам.
https://www.zabbix.com/documentation/2.0/manual/appendix/api/hostinterface/definitions#host_interface
Если определение интерфейса неполное, этот модуль попытается заполнить разумные значения.
type также может быть agent, snmp, ipmi, или jmx вместо его числового значения.
inventory_mode
-
добавлен в 2.1
    Варианты:
  • automatic
  • manual
  • disabled
Настройка режима инвентаризации.
inventory_zabbix
-
добавлен в 2.5
Добавление фактов для инвентаризации Zabbix (например, тега) (см. пример ниже).
Для получения дополнительной информации о поддерживаемых свойствах, обратитесь к документации по интерфейсам.
https://www.zabbix.com/documentation/3.2/manual/api/reference/host/object#host_inventory
ipmi_authtype
-
добавлен в 2.5
Алгоритм аутентификации IPMI.
Для получения дополнительной информации о поддерживаемых свойствах, обратитесь к документации по объекту хоста.
https://www.zabbix.com/documentation/3.4/manual/api/reference/host/object
Возможные значения, 0 (нет), 1 (MD2), 2 (MD5), 4 (прямой), 5 (OEM), 6 (RMCP+), где -1 — значение по умолчанию API.
Обратите внимание, что Zabbix API будет рассматривать отсутствующие настройки как значения по умолчанию при обновлении любых параметров ipmi_; это означает, что если вы попытаетесь установить любой из четырех параметров индивидуально, остальные будут сброшены до значений по умолчанию.
ipmi_password
-
добавлен в 2.5
Пароль IPMI.
также см. последнее примечание в документации по ipmi_authtype
ipmi_privilege
-
добавлен в 2.5
Уровень привилегий IPMI.
Для получения дополнительной информации о поддерживаемых свойствах, обратитесь к документации по объекту хоста.
https://www.zabbix.com/documentation/3.4/manual/api/reference/host/object
Возможные значения 1 (обратный вызов), 2 (пользователь), 3 (оператор), 4 (администратор), 5 (OEM), причём 2 — значение по умолчанию API.
также см. последнее примечание в документации по ipmi_authtype
ipmi_username
-
добавлен в 2.5
Имя пользователя IPMI.
также см. последнее примечание в документации по ipmi_authtype
link_templates
-
Список шаблонов, связанных с хостом.
login_password
строка / обязательно
Пароль пользователя Zabbix.
login_user
строка / обязательно
Имя пользователя Zabbix.
proxy
-
Имя прокси-сервера Zabbix, который нужно использовать.
server_url
строка / обязательно
URL сервера Zabbix с протоколом (http или https). url — псевдоним для server_url.

псевдонимы: url
state
-
    Варианты:
  • present ←
  • absent
Состояние хоста.
В present, он создаст хост, если он не существует, или обновит хост, если связанные данные отличаются.
В absent, удалит хост, если он существует.
status
-
    Варианты:
  • enabled ←
  • disabled
Статус мониторинга хоста.
timeout
целое число
Значение по умолчанию:
10
Таймаут запроса API (секунды).
tls_accept
-
добавлен в 2.5
Значение по умолчанию:
1
Указывает типы соединений, разрешённых для входящих соединений.
Параметр tls_accept принимает значения от 1 до 7
Возможные значения: 1 (без шифрования), 2 (PSK), 4 (сертификат).
Значения можно комбинировать.
Работает только с Zabbix 3.0 и выше
tls_connect
-
добавлен в 2.5
Значение по умолчанию:
1
Указывает тип шифрования для исходящих соединений.
Возможные значения: 1 (без шифрования), 2 (PSK), 4 (сертификат).
Работает только с Zabbix 3.0 и выше
tls_psk
-
добавлен в 2.5
Значение PSK — это сложно угадываемая строка шестнадцатеричных цифр.
Предварительно общаяя ключ, по крайней мере, 32 шестнадцатеричных цифры. Требуется, если tls_connect или tls_accept используют PSK.
Работает только с Zabbix 3.0 и выше
tls_psk_identity
-
добавлен в 2.5
Уникальное имя, по которому компоненты Zabbix ссылаются на этот конкретный PSK.
Не размещайте конфиденциальную информацию в строке идентификатора PSK, так как она передаётся по сети без шифрования.
Работает только с Zabbix 3.0 и выше
tls_subject
-
добавлен в 2.5
Требуемый субъект сертификата.
Работает только с Zabbix 3.0 и выше
validate_certs
boolean
добавлен в 2.5
    Варианты:
  • нет
  • да ←
Если установлено значение False, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых лично сайтах, использующих самозаверенные сертификаты.
visible_name
-
added in 2.3
Видимое имя хоста в Zabbix.

Примеры

- name: Create a new host or update an existing host's info
  local_action:
    module: zabbix_host
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    host_name: ExampleHost
    visible_name: ExampleName
    description: My ExampleHost Description
    host_groups:
      - Example group1
      - Example group2
    link_templates:
      - Example template1
      - Example template2
    status: enabled
    state: present
    inventory_mode: manual
    inventory_zabbix:
      tag: "{{ your_tag }}"
      alias: "{{ your_alias }}"
      notes: "Special Informations: {{ your_informations | default('None') }}"
      location: "{{ your_location }}"
      site_rack: "{{ your_site_rack }}"
      os: "{{ your_os }}"
      hardware: "{{ your_hardware }}"
    ipmi_authtype: 2
    ipmi_privilege: 4
    ipmi_username: username
    ipmi_password: password
    interfaces:
      - type: 1
        main: 1
        useip: 1
        ip: 10.xx.xx.xx
        dns: ""
        port: 10050
      - type: 4
        main: 1
        useip: 1
        ip: 10.xx.xx.xx
        dns: ""
        port: 12345
    proxy: a.zabbix.proxy
- name: Update an existing host's TLS settings
  local_action:
    module: zabbix_host
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    host_name: ExampleHost
    visible_name: ExampleName
    host_groups:
      - Example group1
    tls_psk_identity: test
    tls_connect: 2
    tls_psk: 123456789abcdef123456789abcdef12

Статус

  • Данный модуль не гарантирует обратной совместимости интерфейса. [превью]
  • Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

  • Cove (@cove)
  • Tony Minfei Ding (!UNKNOWN)
  • Harrison Gu (@harrisongu)
  • Werner Dijkerman (@dj-wasabi)
  • Eike Frost (@eikef)

Подсказка

Если вы заметили какие-либо проблемы в данной документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/zabbix_host_module.html

Spec-Zone.ru

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