Sentry uses breadcrumbs to create a trail of events that happened prior to an issue. These events are very similar to traditional logs, but can record more rich structured data.
SDKs automatically start recording breadcrumbs by enabling integrations. To learn how to do this for your platform, select the platform from the sidebar, then review the breadcrumbs documentation for that platform.
If an error event provides a trail, sentry.io displays the breadcrumbs on the Issue Details page:
Each part of the breadcrumb displays in a separate row and each row includes the following details: Type, Category, Description, Level, and Time.
- A semi-internal attribute
typecan control the type of the breadcrumb. By default, all breadcrumbs are recorded as
default, which makes them appear as a
Debugentry, but Sentry provides other types that influence how the breadcrumbs are rendered.
- The category of the event. This data is similar to a logger name, and helps you understand the area in which an event took place, such as auth.
- A description is either:
Message: A string describing the event, rendered as text with all whitespace preserved. It's often used as a drop-in for a traditional log message.
Data: A key-value mapping of event metadata. This is often used instead of a message, but may be used in addition to one. sentry.io displays all the data sent.
- The severity of an event. The level is set to one of five values, which are — in order of severity — fatal, error, warning, info, and debug.
- A timestamp representing when the breadcrumb occurred. The format is either a string, as defined in RFC 3339, or a numeric (integer or float) value representing the number of seconds that have elapsed since the Unix epoch. By default, sentry.io displays the timestamp as an absolute time. You can click the toggle to update the display to relative time:
Learn more detailed information about breadcrumb data in the Breadcrumbs Interface developer documentation.
You can filter the list of breadcrumbs by type and level. The provided types and levels are displayed as options in the filter:
If you type anything in the filter search field, sentry.io filters out all fragmented data and attempts to find a match to the search criteria. If it finds one, the match is highlighted. Full-text search also works in conjunction with option to Filter By.