Sentry объединяет события, когда их данные для группировки выглядят одинаково. Два разных пользовательских сценария могут пройти через один wrapper и оставить одинаковый stack trace; обратная ситуация — один дефект распадётся на группы из-за динамического текста.

Не начинайте с fingerprint по URL или user ID. Возьмите два event из одного Issue и сравните exception, stack frames, release и Grouping Information. Если полезные frames не дошли, ручное правило лишь спрятет проблему качества событий.

По паре событий видно, что именно совпало

НаблюдениеВероятная причинаСледующий шаг
Одинаковый верхний in-app frameОбщий error wrapperПередать исходную cause и stack
Есть только messageException преобразован в строку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.

  1. Выбрать два ложных объединения и два правильных объединения.
  2. Зафиксировать текущие fingerprints и releases.
  3. Исправить stack/sourcemap, если причина в телеметрии.
  4. Включить новое правило только для нужного класса ошибок.
  5. Отправить тестовые события с двумя разрешёнными reason.
  6. Проверить группировку и возможность отката версии правила.

Слишком широкое разделение тоже ломает мониторинг

Fingerprint из request URL, случайного текста, timestamp или customer ID создаёт Issue почти на каждое событие. А один константный fingerprint склеивает всё обратно. Хороший ключ соответствует единице исправления: компонент + стабильный класс причины, при этом стандартный stack остаётся частью решения, если это уместно.

Материалы для точного исправления

Подготовьте два event ID, platform/SDK version, release, Grouping Information, обезличенный stack и желаемое правило «вместе/раздельно». DSN, cookies, полный request и пользовательские поля удалите. Такой набор позволяет проверить правило без доступа к содержимому рабочих запросов.

Проверенные источники