Spec-Zone.ru › Ansible 2.10

community.general.sensu_handler – Управляет конфигурацией обработчика Sensu

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

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

Для использования в книге задач укажите: community.general.sensu_handler

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

Обзор

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
command
строка
Команда обработчика, которая должна быть выполнена.
Данные события передаются в процесс через STDIN.
ПРИМЕЧАНИЕ: атрибут command требуется только для обработчиков Pipe (т.е. обработчиков, настроенных с "type": "pipe").
filter
строка
Фильтр событий Sensu (имя), используемый при фильтрации событий для обработчика.
filters
список / элементы=строка
Массив фильтров событий Sensu (имен), используемых при фильтрации событий для обработчика.
Каждый элемент массива должен быть строкой.
handle_flapping
логическое значение
    Варианты:
  • нет ←
  • да
Если события в состоянии flapping должны обрабатываться.
handle_silenced
логическое значение
    Варианты:
  • нет ←
  • да
Если события, соответствующие одному или нескольким записям молчания, должны обрабатываться.
handlers
список / элементы=строка
Массив обработчиков событий Sensu (имен), используемых для событий, использующих заданный обработчик.
Каждый элемент массива должен быть строкой.
ПРИМЕЧАНИЕ: атрибут handlers требуется только для наборов обработчиков (т.е. обработчиков, настроенных с "type": "set").
mutator
строка
Мутатор событий Sensu (имя), используемый для изменения данных событий для обработчика.
name
строка / обязательно
Уникальное имя обработчика. Имя не может содержать специальных символов или пробелов.
pipe
словарь
Область определения канала, используемая для настройки канала передачи Sensu.
ПРИМЕЧАНИЕ: атрибут pipe требуется только для обработчиков транспорта (т.е. обработчиков, настроенных с "type": "transport").
severities
список / элементы=строка
Массив степеней серьезности результатов проверки, которые будет обрабатывать обработчик.
ПРИМЕЧАНИЕ: разрешение событий игнорирует эту фильтрацию.
Пример: ['warning', 'critical', 'unknown'].
socket
словарь
Область определения сокета, используемая для настройки сокета обработчика TCP/UDP.
ПРИМЕЧАНИЕ: атрибут socket требуется только для обработчиков TCP/UDP (т.е. обработчиков, настроенных с "type": "tcp" или "type": "udp").
state
строка
    Варианты:
  • present ←
  • absent
Указывает, должен ли обработчик быть присутствующим или нет
timeout
целое число
По умолчанию:
10
Таймаут продолжительности выполнения обработчика в секундах (жесткая остановка).
Используется только для обработчиков типа pipe и tcp.
type
строка
    Варианты:
  • pipe
  • tcp
  • udp
  • transport
  • set
Тип обработчика

Примечания

Примечание

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

Примеры

# Configure a handler that sends event data as STDIN (pipe)
- name: Configure IRC Sensu handler
  community.general.sensu_handler:
    name: "irc_handler"
    type: "pipe"
    command: "/usr/local/bin/notify-irc.sh"
    severities:
      - "ok"
      - "critical"
      - "warning"
      - "unknown"
    timeout: 15
  notify:
    - Restart sensu-client
    - Restart sensu-server

# Delete a handler
- name: Delete IRC Sensu handler
  community.general.sensu_handler:
    name: "irc_handler"
    state: "absent"

# Example of a TCP handler
- name: Configure TCP Sensu handler
  community.general.sensu_handler:
    name: "tcp_handler"
    type: "tcp"
    timeout: 30
    socket:
      host: "10.0.1.99"
      port: 4444
  register: handler
  notify:
    - Restart sensu-client
    - Restart sensu-server

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

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

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

Ключ Возвращаемое Описание
config
словарь
успешно
Эффективная конфигурация обработчика, когда состояние присутствует

Пример:
{'command': '/usr/local/bin/notify-irc.sh', 'name': 'irc', 'type': 'pipe'}
file
строка
успешно
Путь к файлу конфигурации обработчика

Пример:
/etc/sensu/conf.d/handlers/irc.json
name
строка
успешно
Имя обработчика

Пример:
irc


Авторы

  • David Moreau Simard (@dmsimard)

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

Spec-Zone.ru

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