Перейти к содержимому

Изменения документа Примеры

Редактировал(а) Alexandr Fokin 2026/08/26 19:05
От версии 4.1
отредактировано Alexandr Fokin
на 2026/04/27 13:25
Изменить комментарий: Вложение перемещено из xwiki:Проекты и репозитории.Библиотеки.Движок cccc1808\. ProcessEngine.WebHome.
К версии 8.46
отредактировано Alexandr Fokin
на 2026/08/18 12:23
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

Свойства страницы
Родительский документ
... ... @@ -1,1 +1,1 @@
1 -Проекты и репозитории.Библиотеки.Движок cccc1808\. ProcessEngine.WebHome
1 +Проекты и репозитории.Библиотеки.Движок cccc1808\. ProcessEngine.Тема\. Сигналы и триггеры.WebHome
Содержимое
... ... @@ -1,7 +1,15 @@
1 -|1|Родительский процесс, N дочерних процессов.|(((
2 -|(((
3 -В данном примере имеется в виду, что дочерние процессы могут выполняться параллельно другу и независимо друг от друга, но в конце должны оповестить родительский процесс о необходимости продолжения обработки.
1 +{{toc/}}
2 +
3 +
4 +| |(% style="width:188px" %)**Пример задачи**|(% style="width:1268px" %)**Наборы решений**
5 +|1|(% style="width:188px" %)(((
6 +=== 1 родительский процесс и N дочерних процессов. ===
7 +)))|(% style="width:1268px" %)(((
8 +|В данном примере имеется в виду, что дочерние процессы могут выполняться параллельно другу и независимо друг от друга, но в конце должны оповестить родительский процесс о необходимости продолжения обработки.
4 4  Если речь идет о каких-либо зависимостях порядка выполнения в дочерних процессах, то это может контролировать дочерний процесс (выделяя группу, которую сейчас можно запустить и ожидая окончания).
10 +|(((
11 +|(((
12 +Вариант 1: CounterTrigger.
5 5  )))
6 6  |(((
7 7  1. Родительский процесс создает триггер со счетчиком N, создает и запускает дочерние процессы, засыпает.
... ... @@ -17,19 +17,91 @@
17 17  Для таких случаев создается страхующий триггер (1 общий на тип процесса). Этот триггер запускается периодически и проходится по всем ожидающим процессам, проверяя условие (в реализации можно использовать keyset пагинацию) (в реализации можно использовать join для проверки условия).
18 18  Этот триггер выполняется периодически с более крупной временной задержкой. В случае обнаружения потери TriggerEvent, он поднимет заклинивший родительский процесс и он будет обработан (но позже). Можно установить этому триггеру низкий приоритет.
19 19  )))
20 -|
28 +|[[image:Родительский дочерний процесс. Sequence.jpg]]
29 +)))
21 21  |(((
22 -
31 +Вариант №2:
32 +
33 +Мы просто ставим TimerTrigger на условно 1-5-10 минут (насколько важна задержка) и перепроверяем условие завершения.
34 +В этом случае будет
35 +
36 +* Из минус: что родительский процесс узнает о завершении дочерних процессов с задержкой.
37 +Если дочерний процесс падает в ошибку, TimerTrigger все равно будет крутиться и создавать пустую нагрузку.
38 +* Из плюсов: будет меньше пишущей нагрузки на БД чем в варианте 1 (но больше читающей - на проверку) т.к. у нас не будет CounterTrigger, но будет периодический запрос на проверку завершения всех дочерних процессов (аналогично страхующему триггер).
39 +* [Расширенный]: Дочерние процессы в блоке wakeup condition проверяют наличие незавершенных процессов.
40 +** Если все процессы завершены или (незавершенных процессов мало и нет процессов с ошибкой), то можно опубликовать событие на TimerTrigger на сброс или установку минимальной задержки.
23 23  )))
42 +|(((
43 +Вариант №3:
44 +
45 +Дочерние процессы выполняются через родительский (ограничение в рамках одной ноды).
46 +Точкой выполнения является родительский процесс, который внутри себя (параллельно или последовательно) выполняет дочерние процессы.
47 +За счет такого способа у нас также отсутствует конкуренция передачи сигнала в родительский процесс.
48 +Но мы ограничены выполнением дочерних процессов одной одной сервиса.
49 +Сложнее контролировать распределение нагрузки, если будет вложенный параллелизм.
50 +Также решает проблему, если дочерний процесс содержит ожидание (например асинхронный запрос-ответ), тут будет конкуренция сигнала от хендлера ответа к родительскому процессу.
24 24  )))
25 -|2|Transaction outbox stream process.|
26 -|3|Stream trigger|(((
52 +|(((
53 +Вариант №4:
54 +
55 +SimpleStreamTrigger + Timer.
56 +
57 +* Триггер проверяет условие завершения всех дочерних процессов (можно прикинуть количество незавершенных дочерних процессов).
58 +** Если все обработано, то пробуждает процесс и деактивируется.
59 +** Иначе:
60 +*** деактивируется (до поступления хотя бы одного сигнала),
61 +*** взводит признак стрима - процесс ожидает,
62 +*** взводит флаг новых сигналов на 0,
63 +*** выставляет задержку от оценки количества необработанных процессов (< N - малая задержка, иначе большая задержка).
64 +* [Расширенный]: Дочерние процессы в блоке wakeup condition проверяют наличие незавершенных процессов.
65 +** Если все процессы завершены или (незавершенных процессов мало и нет процессов с ошибкой), то можно опубликовать событие на SimpleStreamTrigger на сброс или установку минимальной задержки (в дополнение к сигналу).
66 +* Читающей нагрузки будет немного больше чем в варианте 2 (чтение триггера на поступлении сигнала),
67 +но пишущей нагрузки будет меньше чем в варианте 1 (запись - только на активации новым сигналом).
68 +* Если сигналов нет, то нет пустых срабатываний в отличие от варианта 2 (т.к. нет поступления сигнала от дочерних процессов).
69 +)))
70 +|(((
71 +|Вариант №5:
72 +SimpleStreamTrigger + Счетчик в [[Redis>>doc:Разработка.Базы данных.NoSQL.Ключ-значение структура.Redis.WebHome]]. (на текущий момент самый лучший вариант).
73 +|InMemory счетчик, нагрузка на БД и конкуренция.
74 +Дочерний процесс уменьшает счетчик. И публикует событие только если счетчик достиг 0.
75 +Совмещает преимущества из варианта 1.1 (при этом не нагружает БД), в случае ошибки переключается на режим 1.4.
76 +|(((
77 +Проблема: изменение счетчика не привязано к основной транзакции БД.
78 +
79 +Возможно:
80 +
81 +1. В начале транзакции (или шага) атомарно проверяем MemberSet, если есть запись то удаляем и увеличиваем счетчик на 1 (означает что процесс уже уменьшал счетчик, но потом было падение).
82 +1. До коммита транзакции атомарно добавляем значение в MemberSet и уменьшаем счетчик на 1. Если счетчик равен 0, то публикуем TriggerEvent
83 +(добавляем в ручную компенсацию вызов из пункта 1 (при откате изоляции шага и компенсации транзакции)).
84 +1. После коммита транзакции удаляем запись из MemberSet.
85 +(Если мы падаем тут, то процесс уже перешел на другой шаг или даже завершился, поэтому наличие единичной остаточной записи в memberSet не будет критичным).
86 +1. Trigger получает событие. (Необязательно) в хендлере может првоерить значения счетчиков и MemberSet.
87 +
88 +MemberSet используется для уменьшения вероятности увеличить или уменьшить счетчик дважды одним экземпляром дочернего процесса.
89 +)))
90 +|(((
91 +В случае обнаружения повреждения обработка фактически переходит в режим 1.4: начинает публиковать событий каждый раз и используется задержка.
92 +
93 +Примеры проблемы:
94 +
95 +* Падение InMemory хранилища. Предполагается режим без снимков и удаление ключей.
96 +Обнаружение (со стороны дочернего процесса) через отсутствие ключей (проверяется в транзакции).
97 +* Дублирование обновления счетчика.
98 +Обнаружение (со стороны дочернего процесса) через значение счетчика < 0.
99 +Обнаружение (со стороны триггера) через активацию триггера (поступления сигнала от процесса), при этом обнаруживается что не все процессы завершены.
100 +)))
101 +)))
102 +)))
103 +|2|(% style="width:188px" %)Transaction outbox stream process.|(% style="width:1268px" %)[[image:TransactionOutbox. Sequence.jpg]]
104 +|3|(% style="width:188px" %)Stream trigger|(% style="width:1268px" %)(((
27 27  | |(((
28 28  * Позволяет убрать лишние запросы пробуждения процесса (когда он и так запущен).
29 -* Позволяет полностью убрать задержку после остановки процесса (если есть новое сообщения, то он сразу же будет пробужден).
107 +* __Позволяет полностью убрать задержку после остановки процесса__ (если есть новое сообщения, то он сразу же будет пробужден).
30 30  За счет того, что триггер точно знает, что есть новые сообщения и процесс только что уснул.
31 31  * Вводит 2 типа события, 1 сигнал о новом сообщении (содержит offset значение), 2 - процесс идет спать (содержит offset значение).
32 32  * Вводит дополнительное состояние в триггер: максимальный offset сообщения, максимальный offset обработанного процессом сообщения, флаг состояния сна процесса.
111 +* В некоторых случаях позволяет не выполнять wakeup код в конце сессии обработки (если отключить wakeup, оставить только stream trigger)
112 +(блокировка и обновление wakeup entity, проверка wakeup условия), __улучшает перформанс такта работы__.
33 33  )))
34 34  |Алгоритм триггера.|(((
35 35  * При получении события о засыпании процесса:
... ... @@ -45,5 +45,67 @@
45 45  Если есть сообщения со смещением больше чем указал процесс, то делает гарантированное пробуждение процесса.
46 46  Когда поступает сигнал о новом сообщении (от отправителя сообщения), то обновляет данные о максимальном смещении и пробуждает процесс, если он спит
47 47  )))
48 -| |TODO:
128 +|Заготовка|[[https:~~/~~/github.com/cccc1808/cccc1808.ProcessEngine/tree/cccc1808/feature/trigger_stream_trigger>>https://github.com/cccc1808/cccc1808.ProcessEngine/tree/cccc1808/feature/trigger_stream_trigger]]
49 49  )))
130 +|4|(% style="width:188px" %)Групповое действие|(% style="width:1268px" %)(((
131 +| |Действие, которое нужно применить к диапазону строк (сравнительно большому), независимо для каждой строки.
132 +Наличие у строк упорядоченного столбца (для выделения диапазонов).
133 +| |(((
134 +|(% style="width:888px" %)Родительские процесс определяет границы диапазона [min, max].|(% style="width:266px" %){{code language="none"}}select min(), max()
135 +where condition(){{/code}}
136 +|(% style="width:888px" %)Родительский процесс нарезает диапазон [min, max] на поддиапазоны. На каждый поддиапазон создается дочерний процесс.|(% style="width:266px" %)
137 +|(% style="width:888px" %)Каждый дочерний процесс обрабатывает свой поддиапазон строк (параллельно).|(% style="width:266px" %)Внутри поддиапазона может использоваться keyset пагинация.
138 +|(% style="width:888px" %)Родительский процесс ожидает завершения дочерних процессов (см. пример 1).|(% style="width:266px" %)
139 +)))
140 +)))
141 +|5|(% style="width:188px" %)Распределение заявок между исполнителями
142 +(Заготовка).|(% style="width:1268px" %)(((
143 +|(% style="width:94px" %)Описание|(% style="width:1156px" %)Есть поток заявок на деталь (создание детали требует ресурсов, 1 станок, время).
144 +Есть N станков. Опционально: у станка есть уровень ресурсов и коэффициент скорости работы.
145 +Реализация системы распределения и обработки.
146 +|(% style="width:94px" %)Вариант 1|(% style="width:1156px" %)(((
147 +| |Планирование без очереди к станку.
148 +| |(((
149 +* У процесса планировщика есть
150 +** StreamTrigger на поток заявок.
151 +(Можно использовать расширение SignalCode, чтобы временно игнорировать откладывать этот сигнал пока все слоты станков заняты).
152 +** StreanTrigger на поток сигналов об освобождении слота станка.
153 +)))
154 +| |Процесс планировщик назначает заявку на свободный станок.
155 +Вопрос наиболее эффективной функции выбора (оценка наибольшее количество ресурсов, наилучшая скорость обработки и др.).
156 +Когда все станки заняты планировщик ожидает освобождения станков.
157 +)))
158 +|(% style="width:94px" %)Вариант 2|(% style="width:1156px" %)(((
159 +| |Планировщик с очередью к станку.
160 +| |(((
161 +* У процесса станка есть StreamTrigger, на который планировщик подает сигнал в добавления задачи в его очередь.
162 +* У процесса планировщика есть StreamTrigger на поток заявок.
163 +)))
164 +| |При поступлении заявки процесс планировщик сразу назначает в очередь на какой либо станок.
165 +Вопрос наиболее эффективной функции выбора (оценка размера очереди, достаточности у станка ресурсов для ее обработки, общего количества ресурсов, скорости работы станка и др.).
166 +)))
167 +)))
168 +
169 +----
170 +
171 +==== Внутренние ссылки: ====
172 +
173 +====== Дочерние страницы: ======
174 +
175 +{{children/}}
176 +
177 +====== Обратные ссылки: ======
178 +
179 +{{velocity}}
180 +#set ($links = $doc.getBacklinks())
181 +#if ($links.size() > 0)
182 + #foreach ($docname in $links)
183 + #set ($rdoc = $xwiki.getDocument($docname).getTranslatedDocument())
184 + * [[$escapetool.xml($rdoc.fullName)]]
185 + #end
186 +#else
187 + No back links for this page!
188 +#end
189 +{{/velocity}}
190 +
191 +----
%D0%A0%D0%BE%D0%B4%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D1%81%D0%BA%D0%B8%D0%B9%20%D0%B4%D0%BE%D1%87%D0%B5%D1%80%D0%BD%D0%B8%D0%B9%20%D0%BF%D1%80%D0%BE%D1%86%D0%B5%D1%81%D1%81.%20Sequence.jpg
Автор
... ... @@ -1,1 +1,0 @@
1 -XWiki.cccc1808
Размер
... ... @@ -1,1 +1,0 @@
1 -280.7 KB
Содержимое
TransactionOutbox.%20Sequence.jpg
Автор
... ... @@ -1,1 +1,0 @@
1 -XWiki.cccc1808
Размер
... ... @@ -1,1 +1,0 @@
1 -247.1 KB
Содержимое
Родительский дочерний процесс. Sequence.jpg
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.cccc1808
Размер
... ... @@ -1,0 +1,1 @@
1 +280.7 KB
Содержимое
XWiki.XWikiComments[0]
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.cccc1808
Комментарий
... ... @@ -1,0 +1,4 @@
1 +Замечание: конфигурация задержки trigger consumer вычитывания и накопления батча trigger events.
2 +
3 +* Для примера 1 предпочтительная более большая задержка т.к. это уменьшит нагрузку на БД (агрегирует больше сигналов от дочерних процессов в одну операцию обновления). Throughput.
4 +* Для примера 3 в контексте inbox stream trigger, может быть предпочтительная более низкая задержка, чтобы не раздувать задержку от поступления сообщения до его обработки. Latency.
Дата
... ... @@ -1,0 +1,1 @@
1 +2026-05-01 15:36:23.922