Notifications - Revision history

Akuzmin: fix page link (installation > configuration)

2025-12-03T10:33:23Z

fix page link (installation > configuration)

← Older revision		Revision as of 13:33, 3 December 2025
Line 126:		Line 126:
	\|}		\|}

	{{Note\|type=reminder\|text=Для работы службы необходимо запускать Svacer с опцией '''[[Help:~~Installation~~#Указание_public-url\|public-url]]'''. Без указания этой опции служба не будет активирована, так как создаваемые в процессе ее работы ссылки должны содержать правильные URL}}		{{Note\|type=reminder\|text=Для работы службы необходимо запускать Svacer с опцией '''[[Help:Configuration#Указание_public-url\|public-url]]'''. Без указания этой опции служба не будет активирована, так как создаваемые в процессе ее работы ссылки должны содержать правильные URL}}

	==== Особенности работы почтового клиента, используемого Svacer ====		==== Особенности работы почтового клиента, используемого Svacer ====

Akuzmin: minor fixes

2025-09-01T10:44:57Z

minor fixes

← Older revision		Revision as of 13:44, 1 September 2025
Line 120:		Line 120:
	\|-		\|-
	\|advanced.transport_worker_period		\|advanced.transport_worker_period
	\|Значение по умолчанию — 30. Определяет период срабатывания очереди сообщения в наносекундах.		\|Значение по умолчанию — 30. Определяет период срабатывания очереди сообщения в наносекундах
	\|-		\|-
	\|advanced.trace_dir		\|advanced.trace_dir

Chernykov sv: /* Описание параметров конфигурации */

2025-09-01T07:19:31Z

Описание параметров конфигурации

← Older revision		Revision as of 10:19, 1 September 2025
Line 51:		Line 51:
	advanced:		advanced:
	transport_queue_len: 256		transport_queue_len: 256
	transport_worker_period: 30		transport_worker_period: 30000000000
	trace_dir: /tmp		trace_dir: /tmp
	telegram:		telegram:
Line 68:		Line 68:
	saveConnection: false		saveConnection: false
	debug: false</pre>		debug: false</pre>

			{{Note\|type=reminder\|text=При конфигурировании службы необходимо явно указать значение advanced.transport_worker_period для избежания проблемы повышенной загрузки CPU. Значение указывается в наносекундах}}

	==== Описание параметров конфигурации ====		==== Описание параметров конфигурации ====
Line 118:		Line 120:
	\|-		\|-
	\|advanced.transport_worker_period		\|advanced.transport_worker_period
	\|Значение по умолчанию — 30. Определяет период срабатывания очереди сообщения в ~~секундах~~		\|Значение по умолчанию — 30. Определяет период срабатывания очереди сообщения в наносекундах.
	\|-		\|-
	\|advanced.trace_dir		\|advanced.trace_dir

Akuzmin: add link to public-url

2025-07-28T14:51:02Z

add link to public-url

← Older revision		Revision as of 17:51, 28 July 2025
Line 124:		Line 124:
	\|}		\|}

	{{Note\|type=reminder\|text=Для работы службы необходимо запускать Svacer с опцией '''public-url'''. Без указания этой опции служба не будет активирована, так как создаваемые в процессе ее работы ссылки должны содержать правильные URL}}		{{Note\|type=reminder\|text=Для работы службы необходимо запускать Svacer с опцией '''[[Help:Installation#Указание_public-url\|public-url]]'''. Без указания этой опции служба не будет активирована, так как создаваемые в процессе ее работы ссылки должны содержать правильные URL}}

	==== Особенности работы почтового клиента, используемого Svacer ====		==== Особенности работы почтового клиента, используемого Svacer ====

Mitrofanov: /* Создание подписки (команда 'create') */

2025-05-26T07:41:06Z

Создание подписки (команда 'create')

← Older revision		Revision as of 10:41, 26 May 2025
Line 189:		Line 189:

	<pre class="">svacer subscription create --project MyProject --all-events</pre>		<pre class="">svacer subscription create --project MyProject --all-events</pre>
	~~Подписаться на события COMMENT маркера 'b96f5681-d57e-448c-939e-10dc1ba04fac':~~

	===== Получение списка подписок (команда list) =====		===== Получение списка подписок (команда list) =====

Akuzmin at 13:18, 16 May 2025

2025-05-16T13:18:40Z

← Older revision		Revision as of 16:18, 16 May 2025
Line 22:		Line 22:
	* Тип подписки		* Тип подписки

	'''Цель''' – определяет объект в отношении которого должно произойти событие, чтобы пользователь получил оповещение. Возможна подписка на проекты и ветки<br />		'''Цель''' – определяет объект, в отношении которого должно произойти событие, чтобы пользователь получил оповещение. Возможна подписка на проекты и ветки<br />
	'''Класс события''' – определяет один из трех классов события, описанных выше (кроме удаления контейнеров)<br />		'''Класс события''' – определяет один из трех классов события, описанных выше (кроме удаления контейнеров)<br />
	'''Флаг''' – дополнительное условие к активации подписки. Возможны следующие значения:<br />		'''Флаг''' – дополнительное условие к активации подписки. Возможны следующие значения:<br />

Akuzmin: minor fixes

2025-05-16T13:18:13Z

minor fixes

← Older revision		Revision as of 16:18, 16 May 2025
Line 22:		Line 22:
	* Тип подписки		* Тип подписки

	'''Цель''' – определяет ~~проект или ветку~~ в отношении которого должно произойти событие, чтобы пользователь получил оповещение. Возможна подписка на ~~все объекты (~~проекты, ветки)<br />		'''Цель''' – определяет объект в отношении которого должно произойти событие, чтобы пользователь получил оповещение. Возможна подписка на проекты и ветки<br />
	'''Класс события''' – определяет один из трех классов события, описанных выше (кроме удаления контейнеров)<br />		'''Класс события''' – определяет один из трех классов события, описанных выше (кроме удаления контейнеров)<br />
	'''Флаг''' – дополнительное условие к активации подписки. Возможны следующие значения:<br />		'''Флаг''' – дополнительное условие к активации подписки. Возможны следующие значения:<br />

Chernykov sv at 07:46, 16 May 2025

2025-05-16T07:46:05Z

← Older revision		Revision as of 10:46, 16 May 2025
Line 22:		Line 22:
	* Тип подписки		* Тип подписки

	'''Цель''' – определяет проект или ветку в отношении которого должно произойти событие, чтобы пользователь получил оповещение. Возможна подписка на все объекты (проекты, ветки ~~и маркеры~~)<br />		'''Цель''' – определяет проект или ветку в отношении которого должно произойти событие, чтобы пользователь получил оповещение. Возможна подписка на все объекты (проекты, ветки)<br />
	'''Класс события''' – определяет один из трех классов события, описанных выше (кроме удаления контейнеров)<br />		'''Класс события''' – определяет один из трех классов события, описанных выше (кроме удаления контейнеров)<br />
	'''Флаг''' – дополнительное условие к активации подписки. Возможны следующие значения:<br />		'''Флаг''' – дополнительное условие к активации подписки. Возможны следующие значения:<br />

Akuzmin: minor fixes

2025-05-15T11:13:55Z

minor fixes

← Older revision		Revision as of 14:13, 15 May 2025
Line 22:		Line 22:
	* Тип подписки		* Тип подписки

	'''Цель''' – ~~Определяет~~ проект или ветку в отношении которого должно произойти событие, чтобы пользователь получил оповещение. Возможна подписка на все объекты (проекты, ветки и маркеры)<br />		'''Цель''' – определяет проект или ветку в отношении которого должно произойти событие, чтобы пользователь получил оповещение. Возможна подписка на все объекты (проекты, ветки и маркеры)<br />
	'''Класс события''' – ~~Определяет~~ один из трех классов события, описанных выше (кроме удаления контейнеров)<br />		'''Класс события''' – определяет один из трех классов события, описанных выше (кроме удаления контейнеров)<br />
	'''Флаг''' – ~~Дополнительное~~ условие к активации подписки. Возможны следующие значения: <br />		'''Флаг''' – дополнительное условие к активации подписки. Возможны следующие значения:<br />
	:''~~участие~~'' – подписка приведет к созданию сообщения пользователю только в том случае, если в указанной цели есть какая-либо активность пользователя (разметка или комментарий), кому подписка принадлежит<br />		:''Участие'' – подписка приведет к созданию сообщения пользователю только в том случае, если в указанной цели есть какая-либо активность пользователя (разметка или комментарий), кому подписка принадлежит<br />
	'''Тип подписки''' – ~~Подписка~~ может иметь ~~"~~исключающее~~"~~ свойство, когда она подавляет создание сообщений. Полезно при исключении некоторых целей из списка срабатывания (например, когда есть подписка на проект, но некоторые ветки не требуют внимания)		'''Тип подписки''' – подписка может иметь "исключающее" свойство, когда она подавляет создание сообщений. Полезно при исключении некоторых целей из списка срабатывания (например, когда есть подписка на проект, но некоторые ветки не требуют внимания)

	Пользователи могут настраивать каналы оповещения (почта или telegram) посредством изменения своего '''профиля подписок'''. Профиль подписок не включает в себя сами подписки, а позволяет контролировать только механизм доставки создаваемых подписками сообщений. Профиль можно изменять как в GUI, так и через команды CLI.		Пользователи могут настраивать каналы оповещения (почта или telegram) посредством изменения своего '''профиля подписок'''. Профиль подписок не включает в себя сами подписки, а позволяет контролировать только механизм доставки создаваемых подписками сообщений. Профиль можно изменять как в GUI, так и через команды CLI.
Line 34:		Line 34:
	Механизм подписок может удерживать некоторые сообщения, накапливая их в очереди, для минимизации числа соединений с сервером (почтовым или telegram). Отправка сообщений происходит 1 раз в 30 секунд, в связи с чем могут быть задержки с получением сообщений.		Механизм подписок может удерживать некоторые сообщения, накапливая их в очереди, для минимизации числа соединений с сервером (почтовым или telegram). Отправка сообщений происходит 1 раз в 30 секунд, в связи с чем могут быть задержки с получением сообщений.

	Кроме того, действия по разметке маркера могут быть аккумулированы в одно сообщение, если они происходят достаточно быстро (~~нексолько~~ событий на одном маркере для одной подписки в пределах 20 секунд).		Кроме того, действия по разметке маркера могут быть аккумулированы в одно сообщение, если они происходят достаточно быстро (несколько событий на одном маркере для одной подписки в пределах 20 секунд).

	В некоторых случаях, при активности большого количества пользователей со средней суммарной активностью пользователей приблизительно в 3072 события разметки в минуту, сообщения могут быть отброшены системой, чтобы не приводить к спаму.		В некоторых случаях, при активности большого количества пользователей со средней суммарной активностью пользователей приблизительно в 3072 события разметки в минуту, сообщения могут быть отброшены системой, чтобы не приводить к спаму.
Line 115:		Line 115:
	\|-		\|-
	\|advanced.transport_queue_len		\|advanced.transport_queue_len
	\|Значение по умолчанию - 256. Определяет максимальный размер буфера накапливаемых сообщений. Если буфер полный - новые сообщения будут игнорироваться (о чем будет сообщение в логах сервера)		\|Значение по умолчанию — 256. Определяет максимальный размер буфера накапливаемых сообщений. Если буфер полный, новые сообщения будут игнорироваться (о чем будет сообщение в логах сервера)
	\|-		\|-
	\|advanced.transport_worker_period		\|advanced.transport_worker_period
	\|Значение по умолчанию - 30. Определяет период срабатывания очереди сообщения в секундах.		\|Значение по умолчанию — 30. Определяет период срабатывания очереди сообщения в секундах
	\|-		\|-
	\|advanced.trace_dir		\|advanced.trace_dir
	\|Значение по умолчанию - определяется типом системы (Для ~~linux -~~ /tmp). Позволяет указать папку, в которой будут размещаться отладочные файлы работы службы оповещений.		\|Значение по умолчанию определяется типом системы (Для Linux — /tmp). Позволяет указать папку, в которой будут размещаться отладочные файлы работы службы оповещений
	\|}		\|}

	~~'''<u>!Важно!</u>'''~~ Для работы службы ~~также~~ необходимо запускать ~~'''~~Svacer~~'''~~ с опцией '''public-url'''. Без указания этой опции служба не будет активирована, так как создаваемые в процессе ее работы ссылки должны содержать правильные ~~url ссылки.~~		{{Note\|type=reminder\|text=Для работы службы необходимо запускать Svacer с опцией '''public-url'''. Без указания этой опции служба не будет активирована, так как создаваемые в процессе ее работы ссылки должны содержать правильные URL}}

	==== Особенности работы почтового клиента, используемого Svacer ====		==== Особенности работы почтового клиента, используемого Svacer ====
Line 138:		Line 138:
	Все команды собраны в группу ''svacer subscription''. Доступны следующие подкоманды:		Все команды собраны в группу ''svacer subscription''. Доступны следующие подкоманды:

	* <code>transport</code> – функции по работе (конфигурации) используемых механизмов доставки сообщений (mail,tg)		* <code>transport</code> – функции по работе (конфигурации) используемых механизмов доставки сообщений (mail, tg)
	* <code>profile</code> – управление профилем подписки пользователя		* <code>profile</code> – управление профилем подписки пользователя
	* <code>admin</code> – управление службой подписок		* <code>admin</code> – управление службой подписок
Line 385:		Line 385:
	mail:		mail:
	enabled: true		enabled: true
	smtpAddress: "~~nail~~-server.ispras.ru"		smtpAddress: "mail-server.ispras.ru"
	smtpPort: 25		smtpPort: 25
	smtpUsername: ""		smtpUsername: ""

Chernykov sv: /* Пример конфигурационного файла для активации службы уведомлений при запуске Svacer */

2025-05-14T09:44:17Z

Пример конфигурационного файла для активации службы уведомлений при запуске Svacer

← Older revision		Revision as of 12:44, 14 May 2025
Line 385:		Line 385:
	mail:		mail:
	enabled: true		enabled: true
	smtpAddress: "~~relay~~.ispras.ru"		smtpAddress: "nail-server.ispras.ru"
	smtpPort: 25		smtpPort: 25
	smtpUsername: ""		smtpUsername: ""