Usm peleng - История изменений

N.Skrypnik в 13:57, 28 ноября 2023

2023-11-28T13:57:46Z

← Предыдущая версия		Версия от 13:57, 28 ноября 2023
Строка 74:		Строка 74:
	Например, для 1500 устройств, которые должны опрашиватся раз в 9 часов, для ежеминутного запуска понадобится 1500 * 1 / (9 * 60) = 2.8, т.е. 3 копии usm_peleng.		Например, для 1500 устройств, которые должны опрашиватся раз в 9 часов, для ежеминутного запуска понадобится 1500 * 1 / (9 * 60) = 2.8, т.е. 3 копии usm_peleng.

	Пример из cron запуска ~~пяти~~ копий модуля:		Пример из cron запуска трех копий модуля:
	* * * * * perl /opt/userside/usm_peleng/usm_peleng.pl &> /dev/null		* * * * * perl /opt/userside/usm_peleng/usm_peleng.pl &> /dev/null
	* * * * * perl /opt/userside/usm_peleng/usm_peleng.pl &> /dev/null		* * * * * perl /opt/userside/usm_peleng/usm_peleng.pl &> /dev/null

Uscld2: /* Установка и настройка модуля */

2023-11-28T12:57:44Z

Установка и настройка модуля

← Предыдущая версия		Версия от 12:57, 28 ноября 2023
Строка 64:		Строка 64:
	# При запуске модуль обрабатывает только одно устройство		# При запуске модуль обрабатывает только одно устройство

	Модуль usm_peleng не предназначен для определения доступности абонентов по наличию их MAC адресов, так как операция чтения MAC адресов и последующей ~~обработке~~ считанных данных слишком избыточна для этого. Используйте модуль [[usm_checker]] для определения доступности узлов в сети.		Модуль usm_peleng не предназначен для определения доступности абонентов по наличию их MAC адресов, так как операция чтения MAC адресов с последующей обработкой считанных данных слишком избыточна для этого. Используйте модуль [[usm_checker]] для определения доступности узлов в сети.

	Для большинства устройств (в частности коммутаторов) достаточно считывать и обрабатывать данные по MAC-адресам на оборудовании не чаще раза в 6..12 часов. Мы рекомендуем придерживаться этих значений для рассчета количества одновременно запускаемых модулей в системном планировщике cron.		Для большинства устройств (в частности коммутаторов) достаточно считывать и обрабатывать данные по MAC-адресам на оборудовании не чаще раза в 6..12 часов. Мы рекомендуем придерживаться этих значений для рассчета количества одновременно запускаемых модулей в системном планировщике cron.

Uscld2 в 12:52, 28 ноября 2023

2023-11-28T12:52:28Z

← Предыдущая версия		Версия от 12:52, 28 ноября 2023
Строка 70:		Строка 70:
	Запускайте модули как можно чаще с как можно меньшим количеством одновременных запусков. Стандартной рекомендацией будет запуск модуля раз в минуту. Количество копий, которое должно быть запущено одновременно, вычисляется из рассчета количества устройств с активным параметром "Опрашивать устройство модулем usm_peleng". Это значение можно вычислить по формуле:		Запускайте модули как можно чаще с как можно меньшим количеством одновременных запусков. Стандартной рекомендацией будет запуск модуля раз в минуту. Количество копий, которое должно быть запущено одновременно, вычисляется из рассчета количества устройств с активным параметром "Опрашивать устройство модулем usm_peleng". Это значение можно вычислить по формуле:

	Количество копий = количество устройств * период запуска в минутах / ~~длительность~~ цикла опроса для устройства		Количество копий = количество устройств * период запуска в минутах / период цикла опроса для устройства в минутах

	Например, для 1500 устройств, которые должны опрашиватся раз в 9 часов, для ежеминутного запуска понадобится 1500 * 1 / (9 * 60) = 2.8, т.е. 3 копии usm_peleng.		Например, для 1500 устройств, которые должны опрашиватся раз в 9 часов, для ежеминутного запуска понадобится 1500 * 1 / (9 * 60) = 2.8, т.е. 3 копии usm_peleng.

Uscld2: /* Установка и настройка модуля */

2023-11-28T11:15:21Z

Установка и настройка модуля

← Предыдущая версия		Версия от 11:15, 28 ноября 2023
Строка 62:		Строка 62:
	'''Уточнения:'''		'''Уточнения:'''
	# При добавлении нового коммутатора в систему, у него автоматически включается параметр - опрашивать устройство модулем usm_peleng		# При добавлении нового коммутатора в систему, у него автоматически включается параметр - опрашивать устройство модулем usm_peleng
	# При запуске модуль обрабатывает только одно устройство. Следовательно в системный cron следует записать вызов необходимого количества копий модуля ''(из расчёта количества коммутаторов в системе и желаемой частоты опроса)''.		# При запуске модуль обрабатывает только одно устройство

	~~Если вы хотите использовать модуль~~ для ~~обновления даты активности~~ абонентов~~/оборудования, то при указании количества копий модуля следует исходить из следующего: в ERP "UserSide"~~ по-умолчанию время активности в сети составляет 15 минут ''(т.е. это время, через которое абонент/дом/узел будет считаться неактивным)''. Следовательно, в течении 15 минут модули должны успевать обрабатывать все устройства. Модуль при запуске обрабатывает одно устройство. Следовательно за 15 минут модуль успеет обработать 15 устройств. Если устройств больше - то необходимо использовать вторую копию модуля, ~~третью~~ и т.д. Копий модуля можно запускать любое количество. Для того чтобы одновременный запуск большого количества копий модуля не приводил к увеличенной нагрузке на базу данных ~~и процессор ''(ведь при запуске будут выполняться одни и те же однотипные задачи)'' предназначен параметр "$delay"~~. ~~Указав~~ в нём цифру произвольное задержки например в "20" - можно добиться что модули будут запускаться с 1 по 20 секунду в произвольном порядке и нагрузка распределится.		Модуль usm_peleng не предназначен для определения доступности абонентов по наличию их MAC адресов, так как операция чтения MAC адресов и последующей обработке считанных данных слишком избыточна для этого. Используйте модуль [[usm_checker]] для определения доступности узлов в сети.

	~~Также при большом количестве оборудования~~ - ~~нет смысла запускать опрос оборудования каждые 15 минут~~. ~~Для распределения нагрузки~~ можно ~~настроить так работу~~, ~~чтобы опрос каждого~~ устройства ~~происходил один~~ раз в 1~~-4 часа~~. ~~Этого в принципе достаточно~~. ~~А для фиксации активности по абонентам/оборудовании используйте модуль [[usm_checker]]~~.		Для большинства устройств (в частности коммутаторов) достаточно считывать и обрабатывать данные по MAC-адресам на оборудовании не чаще раза в 6..12 часов. Мы рекомендуем придерживаться этих значений для рассчета количества одновременно запускаемых модулей в системном планировщике cron.

			Запускайте модули как можно чаще с как можно меньшим количеством одновременных запусков. Стандартной рекомендацией будет запуск модуля раз в минуту. Количество копий, которое должно быть запущено одновременно, вычисляется из рассчета количества устройств с активным параметром "Опрашивать устройство модулем usm_peleng". Это значение можно вычислить по формуле:

			Количество копий = количество устройств * период запуска в минутах / длительность цикла опроса для устройства

			Например, для 1500 устройств, которые должны опрашиватся раз в 9 часов, для ежеминутного запуска понадобится 1500 * 1 / (9 * 60) = 2.8, т.е. 3 копии usm_peleng.

	Пример из cron запуска пяти копий модуля:		Пример из cron запуска пяти копий модуля:
	* * * * * perl /~~home~~/usm_peleng/usm_peleng.pl &> /dev/null		* * * * * perl /opt/userside/usm_peleng/usm_peleng.pl &> /dev/null
	* * * * * perl /~~home~~/~~usm_peleng/usm_peleng.pl &> /dev/null~~		* * * * * perl /opt/userside/usm_peleng/usm_peleng.pl &> /dev/null
	* * * * * perl /home/usm_peleng/usm_peleng.pl &> /dev/null		* * * * * perl /opt/userside/usm_peleng/usm_peleng.pl &> /dev/null
	* * * * * perl /~~home/usm_peleng/usm_peleng.pl &> /dev/null~~
	* * * * * perl /~~home~~/usm_peleng/usm_peleng.pl &> /dev/null

	В карточке устройства, на котором включен модуль usm_peleng можно по соответствующей ссылке посмотреть историю опроса этого устройства модулем и общую таблицу опроса устройств.		В карточке устройства, на котором включен модуль usm_peleng можно по соответствующей ссылке посмотреть историю опроса этого устройства модулем и общую таблицу опроса устройств.

N.Skrypnik в 15:07, 30 октября 2023

2023-10-30T15:07:49Z

← Предыдущая версия		Версия от 15:07, 30 октября 2023
Строка 82:		Строка 82:

	$usUrl - URL к ERP "UserSide"		$usUrl - URL к ERP "UserSide"
	$usApiKey - [[~~UserSide_API_Key_EN~~\|API]]-ключ к ERP "UserSide"		$usApiKey - [[UserSide_API_Key\|API]]-ключ к ERP "UserSide"
	$logsPath - Путь к каталогу для логов модуля		$logsPath - Путь к каталогу для логов модуля

N.Skrypnik в 15:07, 30 октября 2023

2023-10-30T15:07:29Z

← Предыдущая версия		Версия от 15:07, 30 октября 2023
Строка 82:		Строка 82:

	$usUrl - URL к ERP "UserSide"		$usUrl - URL к ERP "UserSide"
	$usApiKey - [[API]]-ключ к ERP "UserSide"		$usApiKey - [[UserSide_API_Key_EN\|API]]-ключ к ERP "UserSide"
	$logsPath - Путь к каталогу для логов модуля		$logsPath - Путь к каталогу для логов модуля

N.Skrypnik в 13:45, 30 октября 2023

2023-10-30T13:45:41Z

← Предыдущая версия		Версия от 13:45, 30 октября 2023
Строка 1:		Строка 1:
			[[Usm_peleng_EN\|en]] \| [[Usm_peleng\|ru]]

	{{activ}}		{{activ}}

Uscld2 в 18:21, 8 мая 2023

2023-05-08T18:21:08Z

← Предыдущая версия		Версия от 18:21, 8 мая 2023
Строка 19:		Строка 19:
	URI::Escape		URI::Escape
	LWP::UserAgent		LWP::UserAgent
	LWP::Protocol		LWP::Protocol::https
	JSON		JSON
	Data::Dumper		Data::Dumper

Uscld2 в 18:14, 8 мая 2023

2023-05-08T18:14:08Z

← Предыдущая версия		Версия от 18:14, 8 мая 2023
Строка 19:		Строка 19:
	URI::Escape		URI::Escape
	LWP::UserAgent		LWP::UserAgent
	LWP::Protocol ~~''(для https-соединений)''~~		LWP::Protocol
	JSON		JSON
	Data::Dumper		Data::Dumper

Uscld2 в 08:21, 17 апреля 2020

2020-04-17T08:21:26Z

← Предыдущая версия		Версия от 08:21, 17 апреля 2020
Строка 113:		Строка 113:

	В файлах логов анализируем полученную информацию.		В файлах логов анализируем полученную информацию.

			== Запуск в Docker-окружении ==

			Если Вы используете USERSIDE в Docker-окружении, то вам наверняка будет интересно запускать в отдельных Docker-контейнерах и внешние модули usm.

			Мы предоставляем docker-окружение для запуска модуля usm_peleng (окружение не содержит файлов модуля - их необходимо загрузить из личного кабинета самостоятельно).

			Загрузить docker-окружение можно по ссылке: https://github.com/userside/usm_peleng-docker-env/releases