Sentry объединяет события, когда их данные для группировки выглядят одинаково. Два разных пользовательских сценария могут пройти через один wrapper и оставить одинаковый stack trace; обратная ситуация — один дефект распадётся на группы из-за динамического текста.
Не начинайте с fingerprint по URL или user ID. Возьмите два event из одного Issue и сравните exception, stack frames, release и Grouping Information. Если полезные frames не дошли, ручное правило лишь спрятет проблему качества событий.
По паре событий видно, что именно совпало
| Наблюдение | Вероятная причина | Следующий шаг |
|---|---|---|
| Одинаковый верхний in-app frame | Общий error wrapper | Передать исходную cause и stack |
| Есть только message | Exception преобразован в строку | Capture Error/Exception object |
| Minified frames без sourcemap | Нет символизации release | Проверить artifacts и release match |
| Разные стабильные domain code | Действительно разные причины | Добавить code в fingerprint |
| Различается user/URL/query | Высокая кардинальность контекста | Оставить как tag, не как fingerprint |
Теги помогают фильтровать события, но сами по себе не обязаны менять группировку. Это полезное разделение: environment, tenant и endpoint остаются контекстом, а Issue соответствует исправляемой причине.
Сначала возвращаем нормальный exception
Строка «Request failed» не содержит stack trace исходного места. Передавайте объект ошибки и его cause, не создавайте одинаковый new Error в одном catch для всех сбоев. Для браузера проверьте, что release и dist совпадают с загруженными sourcemaps; для backend — что frames отмечены как in-app корректно.
- Сравнить событие до и после последнего release.
- Проверить наличие exception values и stacktrace frames.
- Убедиться, что wrapper не заменяет исходную ошибку строкой.
- Проверить symbolication/sourcemap diagnostics для конкретного event.
- Не прикладывать request body и персональные данные ради группировки.
Fingerprint опирается на стабильную причину
Sentry.withScope((scope) => {
const reason = normalizeProviderCode(error.code);
scope.setFingerprint(["{{ default }}", "payment-provider", reason]);
scope.setTag("provider_reason", reason);
Sentry.captureException(error);
});Плейсхолдер {{ default }} сохраняет вклад стандартной группировки там, где он поддерживается документацией выбранного SDK, а дополнительные части делят события по нормализованной причине. Используйте конечный allowlist reason, а неизвестные значения сводите в unknown; сырое message или ID заказа создадут неограниченное число Issues.
Правило проверяем на исторической выборке
Перед rollout выгрузите небольшой набор event IDs, которые должны остаться вместе, и набор, который нужно разделить. Прогоните функцию нормализации локально на сохранённых обезличенных полях. После включения следите за числом новых Issues на событие и долей unknown.
- Выбрать два ложных объединения и два правильных объединения.
- Зафиксировать текущие fingerprints и releases.
- Исправить stack/sourcemap, если причина в телеметрии.
- Включить новое правило только для нужного класса ошибок.
- Отправить тестовые события с двумя разрешёнными reason.
- Проверить группировку и возможность отката версии правила.
Слишком широкое разделение тоже ломает мониторинг
Fingerprint из request URL, случайного текста, timestamp или customer ID создаёт Issue почти на каждое событие. А один константный fingerprint склеивает всё обратно. Хороший ключ соответствует единице исправления: компонент + стабильный класс причины, при этом стандартный stack остаётся частью решения, если это уместно.
Материалы для точного исправления
Подготовьте два event ID, platform/SDK version, release, Grouping Information, обезличенный stack и желаемое правило «вместе/раздельно». DSN, cookies, полный request и пользовательские поля удалите. Такой набор позволяет проверить правило без доступа к содержимому рабочих запросов.