Spec-Zone.ru › Ansible 2.9

zabbix_screen – Создание/обновление/удаление экранов Zabbix

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

Описание

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

Требования

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

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
http_login_password
строка
Пароль для базовой аутентификации
http_login_user
строка / обязательно
Логин для базовой аутентификации
login_password
строка / обязательно
Пароль пользователя Zabbix.
login_user
строка / обязательно
Имя пользователя Zabbix.
screens
список / элементы=словарь / обязательно
Список экранов для создания/обновления/удаления (см. пример).
graph_height
целое число
Высота графика будет установлена в настройках графика.
graph_names
список / элементы=строка
Названия графиков будут добавлены на экран. Регистронезависимо.
Требуется, если state=present.
graph_width
целое число
Ширина графика будет установлена в настройках графика.
graphs_in_row
целое число
Значение по умолчанию:
3
Ограничение столбцов экрана и создание нескольких строк.
host_group
строка
Группа хостов будет использована для поиска хостов.
Требуется, если state=present.
screen_name
строка / обязательно
Будет использовано имя экрана.
Если экран уже добавлен, имя экрана не будет обновлено.
sort
логическое
    Варианты:
  • нет ←
  • да
Сортировать хосты по алфавиту.
Если в именах хостов есть цифры, следует использовать ведущий ноль.
state
строка
    Варианты:
  • absent
  • present ←
present - Создать экран, если он не существует. Если экран уже существует, он будет обновлен по мере необходимости.
absent - Если экран существует, он будет удален.
server_url
строка / обязательно
URL сервера Zabbix, с протоколом (http или https). url — псевдоним для server_url.

псевдонимы: url
timeout
целое число
Значение по умолчанию:
10
Таймаут запроса к API (секунды).
validate_certs
логическое
добавлено в 2.5
    Варианты:
  • нет
  • да ←
Если значение равно False, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах с самозаверенными сертификатами.

Примечания

Примечание

  • Слишком много одновременных обновлений одного и того же экрана могут привести к ошибкам Zabbix, см. примеры для обхода проблемы, если необходимо.
  • Если вы используете login_password=zabbix, слово “zabbix” заменяется на “****” во всем выводе модуля, так как login_password использует no_log. См. эту страницу FAQ для получения дополнительной информации.

Примеры

# Create/update a screen.
- name: Create a new screen or update an existing screen's items 5 in a row
  local_action:
    module: zabbix_screen
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    screens:
      - screen_name: ExampleScreen1
        host_group: Example group1
        state: present
        graph_names:
          - Example graph1
          - Example graph2
        graph_width: 200
        graph_height: 100
        graphs_in_row: 5

# Create/update multi-screen
- name: Create two of new screens or update the existing screens' items
  local_action:
    module: zabbix_screen
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    screens:
      - screen_name: ExampleScreen1
        host_group: Example group1
        state: present
        graph_names:
          - Example graph1
          - Example graph2
        graph_width: 200
        graph_height: 100
      - screen_name: ExampleScreen2
        host_group: Example group2
        state: present
        graph_names:
          - Example graph1
          - Example graph2
        graph_width: 200
        graph_height: 100

# Limit the Zabbix screen creations to one host since Zabbix can return an error when doing concurrent updates
- name: Create a new screen or update an existing screen's items
  local_action:
    module: zabbix_screen
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    state: present
    screens:
      - screen_name: ExampleScreen
        host_group: Example group
        state: present
        graph_names:
          - Example graph1
          - Example graph2
        graph_width: 200
        graph_height: 100
  when: inventory_hostname==groups['group_name'][0]

Статус

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

Авторы

  • Cove (@cove)
  • Tony Minfei Ding (!UNKNOWN)
  • Harrison Gu (@harrisongu)

Подсказка

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

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

Spec-Zone.ru

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