community.general.sensu_client – Управляет конфигурацией клиента Sensu
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general.
Чтобы использовать его в книге задач, укажите: community.general.sensu_client.
Обзор
- Управляет конфигурацией клиента Sensu.
- Дополнительную информацию см. в документации Sensu: https://sensuapp.org/docs/latest/reference/clients.html
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| address строка | Адрес, помогающий идентифицировать и достичь клиента. Это только информационная часть, обычно IP-адрес или имя хоста. Если не указано, по умолчанию используется не петлевой IPv4-адрес, определяемый Ruby Socket.ip_address_list (предоставляется Sensu). | |
| chef словарь | Область определения chef, используется для настройки интеграции Sensu Enterprise с Chef (только для пользователей Sensu Enterprise). | |
| deregister логическое значение |
| Если при остановке процесса клиента Sensu должен быть создан событие дерегистрации. По умолчанию false. |
| deregistration словарь | Область определения deregistration, используемая для настройки автоматической дерегистрации клиента Sensu. | |
| ec2 словарь | Область определения ec2, используется для настройки интеграции Sensu Enterprise с AWS EC2 (только для пользователей Sensu Enterprise). | |
| keepalive словарь | Область определения keepalive, используемая для настройки поведения keepalive клиента Sensu (например, пороговые значения keepalive и т.д.). | |
| keepalives логическое значение |
| Если Sensu должен контролировать keepalives для этого клиента. |
| name строка | Уникальное имя для клиента. Имя не должно содержать специальных символов или пробелов. Если не указано, по умолчанию используется имя системы хоста, определяемое Ruby Socket.gethostname (предоставляется Sensu). | |
| puppet словарь | Область определения puppet, используемая для настройки интеграции Sensu Enterprise с Puppet (только для пользователей Sensu Enterprise). | |
| redact список / элементы=строка | Атрибуты определения клиента, которые нужно скрывать (значения) при ведении журнала и отправке keepalives клиента. | |
| registration словарь | Область определения registration, используемая для настройки обработчиков событий регистрации Sensu. | |
| safe_mode логическое значение |
| Если для клиента включен безопасный режим. Безопасный режим требует локальных определений проверок для принятия запроса на проверку и выполнения проверки. |
| servicenow словарь | Область определения servicenow, используемая для настройки интеграции Sensu Enterprise с ServiceNow (только для пользователей Sensu Enterprise). | |
| socket словарь | Область определения socket, используемая для настройки сокета клиента Sensu. | |
| state строка |
| Наличие или отсутствие клиента |
| subscriptions список / элементы=строка | Массив подписок клиента, список ролей и/или обязанностей, назначенных системе (например, веб-сервер). Эти подписки определяют, какие проверки мониторинга выполняются клиентом, поскольку запросы на проверки отправляются подпискам. Элементы массива subscriptions должны быть строками. |
Примечания
Примечание
- Поддерживается режим проверки
Примеры
# 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 словарь | успех | Эффективная конфигурация клиента, когда состояние present Пример: {'name': 'client', 'subscriptions': ['default']} |
| file строка | успех | Путь к файлу конфигурации клиента Пример: /etc/sensu/conf.d/client.json |
Авторы
- David Moreau Simard (@dmsimard)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/sensu_client_module.html