Skip to content
Honeybadger Docs

Customizing error grouping

Honeybadger groups similar exceptions together using rules which we’ve found to work the best in most cases. The default information we use to group errors is:

  1. The file name, method name, and line number of the error’s location
  2. The class name of the error
  3. The component/controller name

We use this information to construct a “fingerprint” of the exception. Exceptions with the same fingerprint are treated as the same error in Honeybadger.

You can customize the grouping for each exception by changing the error class name, component, or stack trace—or by sending a custom fingerprint.

The fingerprint parameter can be used to override the fingerprint for an exception reported with the honeybadger.notify method. The fingerprint value will be converted to a string if it isn’t already:

from honeybadger import honeybadger


honeybadger.notify(exception, fingerprint="a unique string")

All errors with the fingerprint “a unique string” will be grouped together in Honeybadger.

For more information about the honeybadger.notify method, see Reporting Errors.