Spec-Zone.ru › Ansible

Модуль community.zabbix.zabbix_settings — обновление глобальных настроек Zabbix.

Примечание

Этот модуль входит в коллекцию community.zabbix (версия 4.2.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.zabbix. Для использования этого модуля необходимы дополнительные требования; подробную информацию см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.zabbix.zabbix_settings.

Добавлено в community.zabbix 2.1.0

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

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

Требования

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

  • python >= 3.9

Параметры

Параметр

Комментарии

alert_usrgrp

string

Имя группы пользователей, в которую входит пользователь, получающий сообщение об ошибке при недоступности базы данных.

auditlog_enabled

boolean

Включить ведение журнала аудита, если true.

Варианты:

  • false
  • true

auditlog_mode

boolean

Включить регистрацию системных действий (изменений при низкоуровневом обнаружении, сетевом обнаружении и автоматической регистрации), если true.

Этот параметр доступен начиная с Zabbix 7.0

Варианты:

  • false
  • true

blink_period

string

Период мигания триггеров с изменившимся статусом.

Принимаются секунды и единицы времени с суффиксом (например, 5m).

connect_timeout

string

Тайм-аут подключения к серверу Zabbix.

custom_color

boolean

Пользовательские настройки цвета событий будут активированы, если true.

Варианты:

  • false
  • true

default_inventory_mode

string

Режим инвентаризации узлов сети по умолчанию.

Варианты:

  • "disabled"
  • "manual"
  • "automatic"

default_lang

string

Язык пользователей по умолчанию.

default_theme

string

Тема оформления для пользователей по умолчанию.

Варианты:

  • "blue-theme"
  • "dark-theme"
  • "hc-light"
  • "hc-dark"

default_timezone

string

Часовой пояс пользователей по умолчанию.

Укажите system, если хотите использовать системный часовой пояс.

discovery_group

string

Группа узлов сети, к которой будут относиться обнаруженные узлы.

frontend_url

string

URL веб-интерфейса.

Этот параметр используется для параметра url API настроек.

geomaps_attribution

string

Текст атрибуции географической карты.

geomaps_max_zoom

string

Максимальный уровень масштабирования географической карты.

geomaps_tile_provider

string

Поставщик фрагментов географической карты.

Укажите another, если хотите использовать поставщика, отличного от используемого по умолчанию.

Варианты:

  • "OpenStreetMap.Mapnik"
  • "OpenTopoMap"
  • "Stamen.TonerLite"
  • "Stamen.Terrain"
  • "USGS.USTopo"
  • "USGS.USImagery"
  • "another"

geomaps_tile_url

string

URL фрагмента географической карты.

history_period

string

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

Принимаются секунды и единицы времени с суффиксом (например, 24h).

http_login_password

string

Пароль для базовой аутентификации

http_login_user

string

Имя пользователя для базовой аутентификации

iframe_sandboxing_enabled

boolean

Zabbix использует изоляцию iframe, если true.

Варианты:

  • false
  • true

iframe_sandboxing_exceptions

string

Текст с исключениями для изоляции iframe.

item_test_timeout

string

Тайм-аут сети для проверки элементов данных.

login_attempts

integer

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

login_block

string

Интервал сброса количества попыток входа, когда пользователь заблокирован.

Принимаются секунды и единицы времени с суффиксом (например, 5m).

max_in_table

integer

Максимальное количество элементов для отображения в ячейке таблицы

max_overview_table_size

integer

Максимальное количество столбцов и строк в обзорных таблицах

max_period

string

Максимальный период для фильтра времени.

Принимаются секунды и единицы времени с суффиксом (например, 1y).

media_type_test_timeout

string

Тайм-аут сети для проверки типа носителя.

ok_ack_color

string

Пользовательский цвет для подтвержденных событий RESOLVED.

Эта настройка активируется, если custom_color=true.

Укажите шестнадцатеричный код цвета (например, 00FF00).

ok_ack_style

boolean

Подтвержденные события RESOLVED мигают, если true.

Варианты:

  • false
  • true

ok_period

string

Период отображения триггеров со статусом OK.

Принимаются секунды и единицы времени с суффиксом (например, 5m).

ok_unack_color

string

Пользовательский цвет для неподтвержденных событий RESOLVED.

Эта настройка активируется, если custom_color=true.

Укажите шестнадцатеричный код цвета (например, 00FF00).

ok_unack_style

boolean

Неподтвержденные события RESOLVED мигают, если true.

Варианты:

  • false
  • true

period_default

string

Значение периода по умолчанию для фильтра времени.

Принимаются секунды и единицы времени с суффиксом (например, 1h).

problem_ack_color

string

Пользовательский цвет для подтвержденных событий PROBLEM.

Эта настройка активируется, если custom_color=true.

Укажите шестнадцатеричный код цвета (например, 00FF00).

problem_ack_style

boolean

Подтвержденные события PROBLEM мигают, если true.

Варианты:

  • false
  • true

problem_unack_color

string

Пользовательский цвет для неподтвержденных событий PROBLEM.

Эта настройка активируется, если custom_color=true.

Укажите шестнадцатеричный код цвета (например, 00FF00).

problem_unack_style

boolean

Неподтвержденные события PROBLEM мигают, если true.

Варианты:

  • false
  • true

report_test_timeout

string

Тайм-аут сети для проверки запланированного отчета.

script_timeout

string

Тайм-аут сети для выполнения скрипта.

search_limit

integer

Ограничение количества результатов поиска и фильтрации.

server_check_interval

boolean

Zabbix показывает предупреждение «Сервер Zabbix не работает», если true.

Варианты:

  • false
  • true

severity_color_0

string

Пользовательский цвет для неклассифицированной важности.

Укажите шестнадцатеричный код цвета (например, 00FF00).

severity_color_1

string

Пользовательский цвет для важности «Информация».

Укажите шестнадцатеричный код цвета (например, 00FF00).

severity_color_2

string

Пользовательский цвет для важности «Предупреждение».

Укажите шестнадцатеричный код цвета (например, 00FF00).

severity_color_3

string

Пользовательский цвет для важности «Средняя».

Укажите шестнадцатеричный код цвета (например, 00FF00).

severity_color_4

string

Пользовательский цвет для высокой важности.

Укажите шестнадцатеричный код цвета (например, 00FF00).

severity_color_5

string

Пользовательский цвет для критической важности.

Укажите шестнадцатеричный код цвета (например, 00FF00).

severity_name_0

string

Пользовательское название для неклассифицированной важности.

severity_name_1

string

Пользовательское название для важности «Информация».

severity_name_2

string

Пользовательское название для важности «Предупреждение».

severity_name_3

string

Пользовательское название для важности «Средняя».

severity_name_4

string

Пользовательское название для высокой важности.

severity_name_5

string

Пользовательское название для критической важности.

show_technical_errors

boolean

Zabbix показывает технические ошибки PHP и SQL пользователям, которые не являются суперадминистраторами или входят в группы пользователей с отключенным режимом отладки, если true.

Варианты:

  • false
  • true

snmptrap_logging

boolean

Регистрация несопоставленных SNMP-ловушек будет включена, если true.

Варианты:

  • false
  • true

socket_timeout

string

Тайм-аут сети по умолчанию.

timeout_browser

string

Тайм-аут браузера.

Этот параметр доступен начиная с Zabbix 7.0

timeout_db_monitor

string

Тайм-аут мониторинга базы данных.

Этот параметр доступен начиная с Zabbix 7.0

timeout_external_check

string

Тайм-аут внешней проверки.

Этот параметр доступен начиная с Zabbix 7.0

timeout_http_agent

string

Тайм-аут HTTP-агента.

Этот параметр доступен начиная с Zabbix 7.0

timeout_script

string

Тайм-аут скрипта.

Этот параметр доступен начиная с Zabbix 7.0

timeout_simple_check

string

Тайм-аут простой проверки.

Этот параметр доступен начиная с Zabbix 7.0

timeout_snmp_agent

string

Тайм-аут SNMP-агента.

Этот параметр доступен начиная с Zabbix 7.0

timeout_ssh_agent

string

Время ожидания ответа SSH-агента.

Этот параметр доступен начиная с Zabbix 7.0

timeout_telnet_agent

string

Время ожидания ответа telnet-агента.

Этот параметр доступен начиная с Zabbix 7.0

timeout_zabbix_agent

string

Время ожидания ответа агента Zabbix.

Этот параметр доступен начиная с Zabbix 7.0

uri_valid_schemes

list / elements=string

Список допустимых схем URI.

validate_uri_schemes

boolean

Проверять схемы URI, если true.

Допустимые значения:

  • false
  • true

vault_provider

string

Имя поставщика хранилища.

Этот параметр доступен начиная с Zabbix 6.2.

Допустимые значения:

  • "HashiCorp_Vault"
  • "CyberArk_Vault"

work_period

string

Настройка рабочего времени.

https://www.zabbix.com/documentation/current/en/manual/appendix/time_period

x_frame_options

string

Текст заголовка HTTP X-Frame-Options.

Примечания

Примечание

  • Этот модуль управляет настройками, связанными с API настроек, за исключением ha_failover_delay.

Примеры

# 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: Update settings
  # 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_settings:
    alert_usrgrp: "0"
    auditlog_enabled: false
    auditlog_mode: false
    blink_period: "10m"
    timeout_zabbix_agent: "30s"
    connect_timeout: "30s"
    custom_color: false
    default_inventory_mode: automatic

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ

Описание

msg

string

Результат операции

Возвращается: при успехе

Пример: "Successfully update global settings"

Авторы

  • ONODERA Masaru(@masa-orca)

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

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

© 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_settings_module.html

Spec-Zone.ru

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