community.general.sensu_client модуль – Управление конфигурацией клиента Sensu

Примечание

Этот модуль является частью коллекции community.general (версия 9.5.0).

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

Для установки используйте: ansible-galaxy collection install community.general.

Для использования в playbook, укажите: community.general.sensu_client.

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

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

Управляет конфигурацией клиента Sensu.
Для получения дополнительной информации обратитесь к документации Sensu: https://sensuapp.org/docs/latest/reference/clients.html

Параметры

Параметр	Комментарии
address string	Адрес для идентификации и доступа к клиенту. Это только информационный параметр, обычно IP-адрес или имя хоста. Если не указано, по умолчанию используется не петлевой IPv4-адрес, определяемый Ruby Socket.ip_address_list (предоставляется Sensu).
chef dictionary	Область определения chef, используемая для настройки интеграции Sensu Enterprise Chef (только для пользователей Sensu Enterprise).
deregister boolean	Создавать ли событие отмены регистрации при остановке процесса клиента Sensu. По умолчанию `false`. Варианты: `false` `true`
deregistration dictionary	Область определения отмены регистрации, используемая для настройки автоматической отмены регистрации клиента Sensu.
ec2 dictionary	Область определения ec2, используемая для настройки интеграции Sensu Enterprise AWS EC2 (только для пользователей Sensu Enterprise).
keepalive dictionary	Область определения keepalive, используемая для настройки поведения keepalives клиента Sensu (например, пороговые значения keepalive и т.д.).
keepalives boolean	Следить ли Sensu за keepalives для этого клиента. Варианты: `false` `true` ← (по умолчанию)
name string	Уникальное имя для клиента. Имя не может содержать специальные символы или пробелы. Если не указано, по умолчанию используется имя хоста системы, определяемое Ruby Socket.gethostname (предоставляется Sensu).
puppet dictionary	Область определения puppet, используемая для настройки интеграции Sensu Enterprise Puppet (только для пользователей Sensu Enterprise).
redact list / elements=string	Атрибуты определения клиента, которые нужно скрывать (значения) при ведении журнала и отправке keepalives клиента.
registration dictionary	Область определения регистрации, используемая для настройки обработчиков событий регистрации Sensu.
safe_mode boolean	Включен ли безопасный режим для клиента. Безопасный режим требует локальных определений проверок для принятия запроса проверки и выполнения проверки. Варианты: `false` ← (по умолчанию) `true`
servicenow dictionary	Область определения servicenow, используемая для настройки интеграции Sensu Enterprise ServiceNow (только для пользователей Sensu Enterprise).
socket dictionary	Область определения socket, используемая для настройки сокета клиента Sensu.
state string	Должен ли клиент присутствовать или нет Варианты: `"present"` ← (по умолчанию) `"absent"`
subscriptions list / elements=string	Массив подписок клиента, список ролей и/или обязанностей, назначенных системе (например, webserver). Эти подписки определяют, какие проверки мониторинга выполняются клиентом, так как запросы на проверку отправляются подпискам. Элементы массива подписок должны быть строками.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может выполняться в режиме `check_mode` и возвращать прогноз изменения состояния без изменения целевого объекта.
diff_mode	Поддержка: отсутствует	Вернёт детали изменений (или, возможно, требуемых изменений в `check_mode`), когда режим отличается.

Примечания

Примечание

Режим проверки поддерживается

Примеры

# Minimum possible configuration
- name: Configure Sensu client
  community.general.sensu_client:
    subscriptions:
      - default

# With customization
- name: Configure Sensu client
  community.general.sensu_client:
    name: "{{ ansible_fqdn }}"
    address: "{{ ansible_default_ipv4['address'] }}"
    subscriptions:
      - default
      - webserver
    redact:
      - password
    socket:
      bind: 127.0.0.1
      port: 3030
    keepalive:
      thresholds:
        warning: 180
        critical: 300
      handlers:
        - email
      custom:
        - broadcast: irc
      occurrences: 3
  register: client
  notify:
    - Restart sensu-client

- name: Secure Sensu client configuration file
  ansible.builtin.file:
    path: "{{ client['file'] }}"
    owner: "sensu"
    group: "sensu"
    mode: "0600"

- name: Delete the Sensu client configuration
  community.general.sensu_client:
    state: "absent"

Значения возврата

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

Ключ	Описание
config словарь	Эффективная конфигурация клиента, когда присутствует состояние Возвращается: успех Пример: `{"name": "client", "subscriptions": ["default"]}`
file строка	Путь к файлу конфигурации клиента Возвращается: успех Пример: `"/etc/sensu/conf.d/client.json"`

Авторы

David Moreau Simard (@dmsimard)

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/sensu_client_module.html