Spec-Zone.ru › Ansible 2.7

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

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

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

Описание

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

Требования

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

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
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.
Обратите внимание, что API Zabbix будет использовать значения по умолчанию для отсутствующих настроек при обновлении любых 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_issuer
-
добавлено в 2.5
Требуемый издатель сертификата.
Работает только с 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 не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверяемых сертификатов.
END_OF_DOCUMENT_MARKER
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. [community]

Авторы

  • (@cove)
  • Tony Minfei Ding
  • 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.7/modules/zabbix_host_module.html

Spec-Zone.ru

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