Все материалы
Перед первой интеграциейИмпорт CSV без потерьСобытия, повторы и дубликатыКак понять, что интеграция работаетРазбор ошибок по шагамКороткий словарь интеграцийКак понять, что интеграция работает
Метрики доставки и сигналы, которые помогают разобраться.
Следите за результатом
Запущенный процесс ещё не означает, что данные доходят. Для каждого сценария измеряйте время от поступления записи до подтверждённого результата в принимающей системе.
| Показатель | Что показывает |
|---|---|
| Возраст старейшей записи | Насколько давно очередь перестала продвигаться |
| Время доставки | Какую задержку видит команда |
| Ошибки по причинам | Где нужен повтор, а где исправление данных |
| Повторные события | Как часто срабатывает защита от дубликатов |
Связывайте шаги одним идентификатором
Передавайте идентификатор операции между компонентами и сохраняйте его в журналах. Тогда путь конкретной записи можно восстановить без поиска по имени или телефону человека.
В журнале полезны время, этап, результат и короткий код ошибки. Для секретов и чувствительных полей используйте маскирование или вовсе исключайте их из записи.
Настройте понятные уведомления
Хорошее уведомление объясняет, какой процесс нарушен, с какого момента и где посмотреть детали. Единичную краткую ошибку лучше отделить от устойчивой проблемы несколькими последовательными проверками.
Уведомление об исчезновении ошибки полезно только после подтверждения, что очередь снова обрабатывается и новые записи доходят.
Периодически сверяйте данные
Даже при наличии событий выполняйте контрольную сверку источника и получателя. Сравнивайте идентификаторы и версии, а не только общее количество строк: одинаковые числа не гарантируют одинаковое содержимое.