Skip to content

Commit 38ef00e

Browse files
committed
Add blurb about custom grouping behavior
1 parent e11010e commit 38ef00e

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

docs/usage.rst

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -201,3 +201,24 @@ And set an ``Access-Control-Allow-Origin`` HTTP header on that file.
201201
202202
.. note:: both of these steps need to be done or your scripts might not
203203
even get executed
204+
205+
Custom Grouping Behavior
206+
------------------------
207+
208+
In some cases you may see issues where Sentry groups multiple events together
209+
when they should be separate entities. In other cases, Sentry simply doesn't
210+
group events together because they're so sporadic that they never look the same.
211+
212+
Both of these problems can be addressed by specifying the ``fingerprint``
213+
attribute.
214+
215+
For example, if you have HTTP 404 (page not found) errors, and you'd prefer they
216+
deduplicate by taking into account the URL:
217+
218+
.. code-block:: javascript
219+
220+
Raven.captureException(ex, {fingerprint: ['{{ default }}', 'http://my-url/']});
221+
222+
.. sentry:edition:: hosted, on-premise
223+
224+
For more information, see :ref:`custom-grouping`.

0 commit comments

Comments
 (0)