Настроить маяк м15: Настройка маяка М15 и М17 / База знаний StarLine / StarLine

Интервал маяка — Руководство по настройке маяка

• Логин
• Поддержка

• Промышленность и логистика
  • Поиск и поиск
  • Отслеживание заказов и материалов
  • Использование и инвентаризация активов
  • Мониторинг окружающей среды
  • Видимость и безопасность сотрудников
  • Управление транспортными средствами и каркасами
  • Калькулятор ROI
• Здравоохранение
  • Поиск и поиск
  • Управление койкой
  • Управление активами и инвентаризация
  • Поиск пациента
• Умные здания
  • Поиск и поиск
  • Геолокационные службы
  • Поиск пути клиента
  • Covid-19 Контактный Tracer
• Компания
  • О нас
  • Маяки и метки BLE
  • Стек продуктов и технологий
  • Партнеры
  • Истории успеха клиентов
  • Ресурсы
• Блог
• Купить маяки
• Связаться с отделом продаж

Блог

• Все
• Создание знаний
• Здравоохранение
• Промышленность 4.0
• Общественные места

Beacons

Beacons позволяют использовать систему событий Salt для отслеживания процессов, не связанных с Salt. В Система маяков позволяет миньону подключаться к различным системным процессам и постоянно контролировать эти процессы. Когда в системе происходит отслеживаемая активность процесса, на шину событий Salt отправляется событие, которое можно использовать для запуска реактор.

Соляные маяки в настоящее время могут отслеживать и отправлять солевые события для многих систем мероприятий, в том числе:

Настройка маяков

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

маяков обычно включаются путем размещения блока верхнего уровня : в / etc / salt / minion или любой файл в /etc/salt/minion.d/ , например /etc/salt/minion.d/beacons.conf или добавьте его в столбцы для этого миньона:

 маяков:
  inotify:
    - файлы:
        / etc / important_file: {}
        / opt: {}
 

Система маяков, как и многие другие системы в Salt, также может быть настроена через Столб миньонов, зерна или локальный файл конфигурации.

Примечание

Сигнал inotify работает только в операционных системах с поддержкой ядра inotify . В настоящее время сюда не входят FreeBSD, macOS и Windows.

Вся конфигурация маяков выполняется с использованием конфигурации на основе списка.

Несколько копий конкретного маяка Salt можно настроить, включив параметр beacon_module в конфигурацию маяка.

 маяков:
  watch_importand_file:
    - файлы:
        / etc / important_file: {}
    - beacon_module: inotify
  watch_another_file:
    - файлы:
        / etc / another_file: {}
    - beacon_module: inotify
 

Интервал мониторинга маяка

Маяки по умолчанию отслеживают с интервалом в 1 секунду.Чтобы установить другой интервал, предоставить маяку аргумент interval . Следующие маяки работают на 5- и 10-секундные интервалы:

 маяков:
  inotify:
    - файлы:
        / etc / important_file: {}
        / opt: {}
    - интервал: 5
    - disable_during_state_run: True
  нагрузка:
    - средние:
        1 м:
          - 0,0
          - 2,0
        5м:
          - 0,0
          - 1,5
        15м:
          - 0,1
          - 1.0
    - интервал: 10
 

Избегание циклов событий

Важно внимательно рассмотреть возможность создания петли. между реактором и маяком.Например, можно установить маяк, который контролирует, читается ли файл, что, в свою очередь, запускает реактор для запуска состояния который, в свою очередь, читает файл и повторно запускает маяк.

Чтобы избежать таких сценариев, аргумент disable_during_state_run может быть установлен. Если запуск состояния выполняется, маяк не будет запускаться на его регулярный интервал, пока миньон не обнаружит, что запуск состояния завершен, в в этот момент возобновится нормальный интервал между радиомаяками.

 маяков:
  inotify:
    - файлы:
        / etc / important_file: {}
    - disable_during_state_run: True
 

Примечание

Для авторов маяков: если вам нужно что-то еще, например, закрыть файл дескрипторы для disable_during_state_run , чтобы действительно работать, вы можете добавить функция close () для маяка, чтобы запускать эти дополнительные вещи.Увидеть inotify маяк.

Пример маяка

Этот пример демонстрирует настройку inotify маяк для отслеживания изменений в файле, а затем восстанавливает файл на его исходное содержимое, если было внесено изменение.

Примечание

Для маячка inotify требуется Pyinotify на миньоне, установите его с помощью salt myminion pkg. Установить python-inotify .

Создать отслеживаемый файл

Создайте файл с именем / etc / important_file и добавьте простой контент:

Добавить конфигурации маяков в Minion

На миньоне Salt добавьте следующую конфигурацию в / и т. Д. / Соль / миньон.d / beacons.conf :

 маяков:
  inotify:
    - файлы:
        / etc / important_file:
          маска:
            - изменить
    - disable_during_state_run: True
 

Сохраните файл конфигурации и перезапустите службу миньонов. Маяк сейчас настроен для уведомления соли об изменениях, внесенных в файл.

Примечание

Параметр disable_during_state_run: True предотвращает создание реактора маяком inotify события из-за самой соли, изменяющей файл.

Просмотр событий на главном устройстве

На вашем Salt master запустите средство запуска событий, используя следующую команду:

 salt-run state.event pretty = true
 

Этот бегун отображает события в том виде, в каком они были получены мастером на Соли. автобус событий. Чтобы проверить маяк, который вы установили в предыдущем разделе, сделайте и сохраните модификация / etc / important_file . Вы увидите событие, подобное следующее на автобусе событий:

 {
 «_stamp»: «2015-09-09T15: 59: 37.972753 ",
 "данные": {
     "изменить": "IN_IGNORED",
     "id": "ларри",
     "путь": "/ etc / important_file"
 },
 "tag": "salt / beacon / larry / inotify // etc / important_file"
}
 

Это означает, что событие фиксируется и отправляется правильно. Теперь вы можете создать реактор для принятия мер при возникновении этого события.

Создание реактора

Этот реактор возвращает файл с именем / etc / important_file в содержимое доставляется солью каждый раз, когда она изменяется.

Реактор SLS

На своем Salt master создайте файл с именем / srv / Reaction / revert.SLS .

Примечание

Если каталог / srv / Reaction не существует, создайте его.

Добавьте следующее в /srv/reactor/revert.sls :

 ревертированный файл:
  local.state.apply:
    - tgt: {{данные ['данные'] ['идентификатор']}}
    - аргумент:
      - keep_important_file
 

Примечание

В дополнение к настройке disable_during_state_run: True для маяка inotify, реакция которого чтобы изменить наблюдаемый файл, важно убедиться, что применяемое состояние также идемпотентный.

Государственный SLS

Создайте файл состояния sls, на который ссылается файл sls реактора. Этот файл состояния будет находиться по адресу /srv/salt/maintain_important_file.sls .

 важный_файл:
  file.managed:
    - имя: / etc / important_file
    - содержание: |
        important_config: Верно
 

Мастер конфигурации

Настройте мастер для сопоставления события маяка inotify с реакцией revert в /etc/salt/master.d/reactor.conf :

:
  - соль / маяк / * / inotify // etc / important_file:
    - / срв / реактор / реверт.sls
 

Примечание

У вас может быть только одна секция реактора верхнего уровня , поэтому, если она уже существует, добавьте этот код в существующий раздел. См. Здесь, чтобы узнать больше о синтаксисе SLS реактора.

Запустите Salt Master в режиме отладки

Для устранения неполадок запустите мастер Salt в режиме отладки:

 сервисная остановка соли-мастера
соль-мастер -l отладка
 

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

Запустить реактор

На миньоне внесите и сохраните еще одно изменение в / etc / important_file . На Salt master, вы увидите сообщения отладки, указывающие, что событие было получено, и было отправлено state.apply job. Когда вы просматриваете файл на миньоне, вы увидите, что содержимое файла было восстановлено до important_config: Правда .

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

Написание подключаемых модулей Beacon

Beacon используют стандартную систему загрузчика соли, что означает, что многие из конструкции из других систем плагинов, таких как __virtual__ функция.

Важной функцией в подключаемом модуле Beacon является функция маяка . когда маяк настроен на работу, эта функция будет выполняться повторно миньон. Следовательно, функция маяка не может блокироваться и должна быть как можно легче.Маяк также должен возвращать список диктовок, каждый dict в списке будет преобразован в событие на мастере.

Маяки также могут реализовать функцию проверки , которая принимает конфигурацию маяка в качестве аргумента и гарантирует, что действительно до продолжения. Эта функция вызывается автоматически погрузчиком соли при загрузке маяка.

См. В качестве примера маяк inotify .

Маяк Функция

Система маяков будет искать в модуле функцию с именем beacon .Если эта функция отсутствует, то маяк не будет активирован. Эта функция вызывается на регулярной основе и по умолчанию вызывается на каждой итерации миньон, который может быть от десятков до сотен раз в секунду. Это значит, что маяк Функция не может блокироваться и не должна интенсивно использовать ЦП или ввод-вывод.

Функция маяка будет передана в конфигурации для выполняемого маяк. Это позволяет легко установить гибкую конфигурацию для каждого называется маяком. Это также предпочтительный способ приема сигнала маяка. конфигурация, поскольку она позволяет динамически обновлять конфигурацию пока миньон бежит, настроив маяк в столбе миньона.

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

Ожидается, что информация, возвращаемая маяком, будет следовать заранее определенному структура. Возвращаемое значение должно быть списком словарей (стандартный словари python предпочтительнее, упорядоченные словари не нужны).

Словари представляют отдельные события, которые должны быть запущены на миньоне и автобусы мастер событий. Каждый диктант — это отдельное событие. Dict может содержать любые произвольные ключи, но ключ ‘tag’ будет извлечен и добавлен к тегу сработало событие.

Структура возвращаемых данных будет выглядеть примерно так:

 [{'changes': ['/ foo / bar'], 'tag': 'foo'},
 {'изменения': ['/ foo / baz'], 'tag': 'bar'}]
 

Вызов модулей исполнения

Исполнительные модули по-прежнему являются предпочтительным местом для всей работы и всей системы. взаимодействие должно происходить в Salt. По этой причине переменная __salt__ является доступно внутри маяка.

Будьте осторожны при вызове функций в __salt__ , пока это предпочтительные средства выполнения сложных процедур в Salt не все исполнительные модули были написаны с учетом маяков.Берегись модули исполнения, которые могут быть загружены ЦП или связаны с вводом-выводом. Не стесняйтесь добавлять новые исполнительные модули и функции для поддержки определенных маяков.

Распространение специальных радиомаяков

Пользовательские маяки можно раздавать миньонам стандартными методами, см. Модульные системы.

Beacons

Beacons позволяют использовать систему событий Salt для отслеживания процессов, не связанных с Salt. В Система маяков позволяет миньону подключаться к различным системным процессам и постоянно контролировать эти процессы. Когда в системе происходит отслеживаемая активность процесса, на шину событий Salt отправляется событие, которое можно использовать для запуска реактор.

Соляные маяки в настоящее время могут отслеживать и отправлять солевые события для многих систем мероприятий, в том числе:

Настройка маяков

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

маяков обычно включаются путем размещения блока верхнего уровня : в / etc / salt / minion или любой файл в /etc/salt/minion.d/ , например /etc/salt/minion.d/beacons.conf или добавьте его в столбцы для этого миньона:

 маяков:
  inotify:
    - файлы:
        / etc / important_file: {}
        / opt: {}
 

Система маяков, как и многие другие системы в Salt, также может быть настроена через Столб миньонов, зерна или локальный файл конфигурации.

Примечание

Сигнал inotify работает только в операционных системах с поддержкой ядра inotify . В настоящее время сюда не входят FreeBSD, macOS и Windows.

Вся конфигурация маяков выполняется с использованием конфигурации на основе списка.

Несколько копий конкретного маяка Salt можно настроить, включив параметр beacon_module в конфигурацию маяка.

 маяков:
  watch_importand_file:
    - файлы:
        / etc / important_file: {}
    - beacon_module: inotify
  watch_another_file:
    - файлы:
        / etc / another_file: {}
    - beacon_module: inotify
 

Интервал мониторинга маяка

Маяки по умолчанию отслеживают с интервалом в 1 секунду.Чтобы установить другой интервал, предоставить маяку аргумент interval . Следующие маяки работают на 5- и 10-секундные интервалы:

 маяков:
  inotify:
    - файлы:
        / etc / important_file: {}
        / opt: {}
    - интервал: 5
    - disable_during_state_run: True
  нагрузка:
    - средние:
        1 м:
          - 0,0
          - 2,0
        5м:
          - 0,0
          - 1,5
        15м:
          - 0,1
          - 1.0
    - интервал: 10
 

Избегание циклов событий

Важно внимательно рассмотреть возможность создания петли. между реактором и маяком.Например, можно установить маяк, который контролирует, читается ли файл, что, в свою очередь, запускает реактор для запуска состояния который, в свою очередь, читает файл и повторно запускает маяк.

Чтобы избежать таких сценариев, аргумент disable_during_state_run может быть установлен. Если запуск состояния выполняется, маяк не будет запускаться на его регулярный интервал, пока миньон не обнаружит, что запуск состояния завершен, в в этот момент возобновится нормальный интервал между радиомаяками.

 маяков:
  inotify:
    - файлы:
        / etc / important_file: {}
    - disable_during_state_run: True
 

Примечание

Для авторов маяков: если вам нужно что-то еще, например, закрыть файл дескрипторы для disable_during_state_run , чтобы действительно работать, вы можете добавить функция close () для маяка, чтобы запускать эти дополнительные вещи.Увидеть inotify маяк.

Пример маяка

Этот пример демонстрирует настройку inotify маяк для отслеживания изменений в файле, а затем восстанавливает файл на его исходное содержимое, если было внесено изменение.

Примечание

Для маячка inotify требуется Pyinotify на миньоне, установите его с помощью salt myminion pkg. Установить python-inotify .

Создать отслеживаемый файл

Создайте файл с именем / etc / important_file и добавьте простой контент:

Добавить конфигурации маяков в Minion

На миньоне Salt добавьте следующую конфигурацию в / и т. Д. / Соль / миньон.d / beacons.conf :

 маяков:
  inotify:
    - файлы:
        / etc / important_file:
          маска:
            - изменить
    - disable_during_state_run: True
 

Сохраните файл конфигурации и перезапустите службу миньонов. Маяк сейчас настроен для уведомления соли об изменениях, внесенных в файл.

Примечание

Параметр disable_during_state_run: True предотвращает создание реактора маяком inotify события из-за самой соли, изменяющей файл.

Просмотр событий на главном устройстве

На вашем Salt master запустите средство запуска событий, используя следующую команду:

 salt-run state.event pretty = true
 

Этот бегун отображает события в том виде, в каком они были получены мастером на Соли. автобус событий. Чтобы проверить маяк, который вы установили в предыдущем разделе, сделайте и сохраните модификация / etc / important_file . Вы увидите событие, подобное следующее на автобусе событий:

 {
 «_stamp»: «2015-09-09T15: 59: 37.972753 ",
 "данные": {
     "изменить": "IN_IGNORED",
     "id": "ларри",
     "путь": "/ etc / important_file"
 },
 "tag": "salt / beacon / larry / inotify // etc / important_file"
}
 

Это означает, что событие фиксируется и отправляется правильно. Теперь вы можете создать реактор для принятия мер при возникновении этого события.

Создание реактора

Этот реактор возвращает файл с именем / etc / important_file в содержимое доставляется солью каждый раз, когда она изменяется.

Реактор SLS

На своем Salt master создайте файл с именем / srv / Reaction / revert.SLS .

Примечание

Если каталог / srv / Reaction не существует, создайте его.

Добавьте следующее в /srv/reactor/revert.sls :

 ревертированный файл:
  local.state.apply:
    - tgt: {{данные ['данные'] ['идентификатор']}}
    - аргумент:
      - keep_important_file
 

Примечание

В дополнение к настройке disable_during_state_run: True для маяка inotify, реакция которого чтобы изменить наблюдаемый файл, важно убедиться, что применяемое состояние также идемпотентный.

Государственный SLS

Создайте файл состояния sls, на который ссылается файл sls реактора. Этот файл состояния будет находиться по адресу /srv/salt/maintain_important_file.sls .

 важный_файл:
  file.managed:
    - имя: / etc / important_file
    - содержание: |
        important_config: Верно
 

Мастер конфигурации

Настройте мастер для сопоставления события маяка inotify с реакцией revert в /etc/salt/master.d/reactor.conf :

:
  - соль / маяк / * / inotify // etc / important_file:
    - / срв / реактор / реверт.sls
 

Примечание

У вас может быть только одна секция реактора верхнего уровня , поэтому, если она уже существует, добавьте этот код в существующий раздел. См. Здесь, чтобы узнать больше о синтаксисе SLS реактора.

Запустите Salt Master в режиме отладки

Для устранения неполадок запустите мастер Salt в режиме отладки:

 сервисная остановка соли-мастера
соль-мастер -l отладка
 

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

Запустить реактор

На миньоне внесите и сохраните еще одно изменение в / etc / important_file . На Salt master, вы увидите сообщения отладки, указывающие, что событие было получено, и было отправлено state.apply job. Когда вы просматриваете файл на миньоне, вы увидите, что содержимое файла было восстановлено до important_config: Правда .

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

Написание подключаемых модулей Beacon

Beacon используют стандартную систему загрузчика соли, что означает, что многие из конструкции из других систем плагинов, таких как __virtual__ функция.

Важной функцией в подключаемом модуле Beacon является функция маяка . когда маяк настроен на работу, эта функция будет выполняться повторно миньон. Следовательно, функция маяка не может блокироваться и должна быть как можно легче.Маяк также должен возвращать список диктовок, каждый dict в списке будет преобразован в событие на мастере.

Маяки также могут реализовать функцию проверки , которая принимает конфигурацию маяка в качестве аргумента и гарантирует, что действительно до продолжения. Эта функция вызывается автоматически погрузчиком соли при загрузке маяка.

См. В качестве примера маяк inotify .

Маяк Функция

Система маяков будет искать в модуле функцию с именем beacon .Если эта функция отсутствует, то маяк не будет активирован. Эта функция вызывается на регулярной основе и по умолчанию вызывается на каждой итерации миньон, который может быть от десятков до сотен раз в секунду. Это значит, что маяк Функция не может блокироваться и не должна интенсивно использовать ЦП или ввод-вывод.

Функция маяка будет передана в конфигурации для выполняемого маяк. Это позволяет легко установить гибкую конфигурацию для каждого называется маяком. Это также предпочтительный способ приема сигнала маяка. конфигурация, поскольку она позволяет динамически обновлять конфигурацию пока миньон бежит, настроив маяк в столбе миньона.

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

Ожидается, что информация, возвращаемая маяком, будет следовать заранее определенному структура. Возвращаемое значение должно быть списком словарей (стандартный словари python предпочтительнее, упорядоченные словари не нужны).

Словари представляют отдельные события, которые должны быть запущены на миньоне и автобусы мастер событий. Каждый диктант — это отдельное событие. Dict может содержать любые произвольные ключи, но ключ ‘tag’ будет извлечен и добавлен к тегу сработало событие.

Структура возвращаемых данных будет выглядеть примерно так:

 [{"changes": ["/ foo / bar"], "tag": "foo"}, {"changes": ["/ foo / baz"], "tag": "bar"}]
 

Вызов модулей исполнения

Исполнительные модули по-прежнему являются предпочтительным местом для всей работы и всей системы. взаимодействие должно происходить в Salt. По этой причине переменная __salt__ является доступно внутри маяка.

Будьте осторожны при вызове функций в __salt__ , пока это предпочтительные средства выполнения сложных процедур в Salt не все исполнительные модули были написаны с учетом маяков.Берегись модули исполнения, которые могут быть загружены ЦП или связаны с вводом-выводом. Не стесняйтесь добавлять новые исполнительные модули и функции для поддержки определенных маяков.

Распространение специальных радиомаяков

Пользовательские маяки можно раздавать миньонам стандартными методами, см. Модульные системы.