Модуль community.zabbix.zabbix_housekeeping — обновление параметров обслуживания Zabbix

Примечание

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

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

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

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

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

Обзор
Требования
Параметры
Примеры
Возвращаемые значения

Обзор

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

Требования

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

python >= 3.9

Параметры

Параметр	Комментарии
compress_older string	Сжимать записи истории и трендов, срок хранения которых превышает этот период, если compression_status=true.
compression_status boolean	Сжатие TimescaleDB для истории и трендов будет включено, если `true`. Варианты: `false` `true`
hk_audit string	Срок хранения данных аудита (например, 365d).
hk_audit_mode boolean	Внутреннее обслуживание данных аудита будет включено, если `true`. Варианты: `false` `true`
hk_events_autoreg string	Срок хранения данных авто регистрации (например, 365d).
hk_events_discovery string	Срок хранения данных сетевого обнаружения (например, 365d).
hk_events_internal string	Срок хранения внутренних данных (например, 365d).
hk_events_mode boolean	Внутреннее обслуживание событий и оповещений будет включено, если `true`. Варианты: `false` `true`
hk_events_service string	Срок хранения данных служб (например, 365d).
hk_events_trigger string	Срок хранения данных триггеров (например, 365d).
hk_history string	Срок хранения данных истории (например, 365d).
hk_history_global boolean	Переопределение периода хранения истории для каждого элемента данных будет включено, если `true`. Варианты: `false` `true`
hk_history_mode boolean	Внутреннее обслуживание истории будет включено, если `true`. Варианты: `false` `true`
hk_services string	Срок хранения данных служб (например, 365d).
hk_services_mode boolean	Внутреннее обслуживание служб будет включено, если `true`. Варианты: `false` `true`
hk_sessions string	Срок хранения данных сеансов (например, 365d).
hk_sessions_mode boolean	Внутреннее обслуживание сеансов будет включено, если `true`. Варианты: `false` `true`
hk_trends string	Срок хранения данных трендов (например, 365d).
hk_trends_global boolean	Переопределение периода хранения трендов для каждого элемента данных будет включено, если `true`. Варианты: `false` `true`
hk_trends_mode boolean	Внутреннее обслуживание трендов будет включено, если `true`. Варианты: `false` `true`
http_login_password string	Пароль для базовой аутентификации
http_login_user 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: Update housekeeping all parameter
  # 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_housekeeping:
    login_user: Admin
    login_password: secret
    hk_events_mode: yes
    hk_events_trigger: 365d
    hk_events_service: 365d
    hk_events_internal: 365d
    hk_events_discovery: 365d
    hk_events_autoreg: 365d
    hk_services_mode: yes
    hk_services: 365d
    hk_audit_mode: yes
    hk_audit: 365d
    hk_sessions_mode: yes
    hk_sessions: 365d
    hk_history_mode: yes
    hk_history_global: yes
    hk_history: 365d
    hk_trends_mode: yes
    hk_trends_global: yes
    hk_trends: 365d
    compression_status: off
    compress_older: 7d

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

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

Ключ	Описание
msg string	Результат операции Возвращается: success Пример: `"Successfully update housekeeping setting"`

Авторы

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_housekeeping_module.html