Issues
Intelligently grouped problems impacting your users
Overview
The Issues page enables users to review all their frontend issues in one place and prioritize and learn more about the issues that are actually affecting the customer experience.
Currently, LogRocket's available issue types are Errors, Network Errors, Rage Clicks, Dead Clicks, Frustrating Network Requests, Error States, and Mobile Crashes, with more issue types planned in the future. You can toggle between these types or choose to view all with the dropdown in the upper righthand corner of the page.
Issue Types
- Errors - JavaScript (client-side), iOS, and Android errors. These errors may or may not directly impact the UI.
- Network Errors - Failed network requests. These errors may or may not directly impact the UI.
- Rage Clicks - Occur when a user clicks repeatedly in frustration on an element.
- Dead Clicks - Occur when a user clicks on an interactive element (button, link, etc), but the click had no visible effect (ie. a DOM change).
- Frustrating Network Requests - Compound events where a user shows impatient mouse actions during a particularly long network request.
- Error States - Triggered by the occurrence of Element Visible Definitions that are designated as "error states".
- Mobile Crashes - Occur when an iOS or Android app crashes.
Issues are retained for 1 month from the last instance of an issue. So if an issue stops occurring, it is available for 1 month after the last time it occurs. Issues retention is independent of an organization's session retention.
Pro & Enterprise plan issue types
Network Error, Rage Click, Dead Click, Frustrating Network Request, Error State, and Mobile Crash issues are available for Pro and Enterprise plan customers only.
Severe Issues via Galileo AI
See the Severe Issues doc to learn more about AI-recommended issues based on detection of significant user impact, with natural language descriptions.
Issues filters
Issues filters give users the ability to narrow the Issues list down to a specific subset of Issues more meaningful to their needs. Filters include:
- Issue Type
- Occurred within... / first detected within...
- Time Range
- Severity
- Page Definition / URL
- Triage Status
- Platform
Saved Issues filters
Users often have several groups of filters they go back to over and over again. To make this workflow easy, Issues have saved filters, that let you save and name the groups of Issues filters that mean the most to you and your team. Issues comes pre-loaded with several Issues saved filters to get you started:
The pin icon to the right of the Saved Issues filters dropdown pins the current saved Issues filter as the default when returning to the Issues tab in the future.
Issues list
Below the Issues filters, you'll see a list of Issues from across your application, along with metadata about each issue.
To the right of the issue title, you'll see the triage status of the issue, as well as a frequency histogram of its occurrences. At the end of the row, you'll see some additional metadata, including the number of sessions the specific issue has affected.
Card View
Screenshots can be see in the Card view of Issues. Toggle to "Card" in the top right corner of the Issues list.
Triage status
Triage status gives users the ability to categorize, with discretion, the impact of issues. The triage statuses are "Untriaged", "High Impact", "Low Impact", and "Ignored". To filter the list to issues of a specific triage status, click "Add Filter" in the Issues filters section and click "Triage Status". From here you can select one or more of the statuses to view.
Grouping issues
In order to categorize an issue directly from here, click the dropdown labeled Untriaged in the issue row and select whether the issue is High impact, Low impact, or should be Ignored completely.
You can also choose to open the Configure Issue modal. This allows you to assign the issue a custom name and also add custom rules to group issues together and assign them the same status. Setting custom issue group conditions can be done for Errors, Network Errors, and Frustrating Requests.
Any new issues that arise within your application and match any of these rules will be auto-categorized into the selected status.
You can also categorize and group issues directly from their Issue Detail page.
Grouping issues must be of the same type
Please note that you can currently only group issues of the same type. For example, you can create groups that contain different types of JavaScript exceptions as well as groups that bundle different types of Network Errors, but you cannot create a group containing both of these types.
Error State Issue Type
The Error State issue type groups instances where users receive a message indicating that something went wrong. This can include error pages, modals, or views. Error States are defined by the user for the each project in Definitions.
To enable Error State issues, on the Issues view click the Issue Types filter and click "Setup" next to the "Error States" option.
A Definitions side modal will open. Click "Add Definition" and create new "Element visible" definitions with the "Use as Error State" checkbox checked.
As you create these definitions, error state issues will begin to be recorded in LogRocket. Note: Element visible definitions are non-retroactive, meaning they will record events after being defined, but will not look back in time before their creation date. This means that once Error State definitions have been created, new Error State issues will start appearing from that point on, so you may need to check back in a few hours after creation to see the error states that users have hit.
Quickstart: Start out with default error state definitions
The quickest way to get started with Error State issues is to let LogRocket create them for you!
Check out the Default Error State Definitions doc to see how to bootstrap default error state definitions.
Page Definitions / URL filter
In order to see issues that only occurred in specific areas of your app, use the "Page Definitions / URL" filter. Once Page Definitions are selected, issues listed will be ones that have occurred within those Page Definitions (on those specific URLs) in your app.
Definitions (using the "Visited URL" filter) are a shared feature of LogRocket and can be found in the main navigation. To add Definitions, either click the definitions icon to the right of the "URL / Mobile Page" input within the Page Definition / URL modal, or go to the "Definitions" page and add new Page Definitions.
First Detected filter
By default, issues listed have occurred any time within the selected time range. You can use the First Detected filter to identify issues that have occurred for the first time within the selected time range, but may have continued occurring afterwards. Note that the 1 month issues retention also applies to the First Detected filter, so the first occurrence of an issue is based on events within the past month.
Platform filter
Each issue is comprised of events from a single platform - Browser, iOS, or Android. The Platform filter allows you narrow the scope of Issues to one of these platforms. Since React Native compiles to native code, apps that use the React Native SDK will find issues in the iOS and Android platforms.
Issue Detail page
You can click through on an individual issue to view more detailed information about the issue, including a sample playback of a user encountering the issue within a session. This is designed to give you information to help you categorize the priority of the issue. For example, issues that block users within a critical sign-up or checkout flow may be deemed higher-priority than issues that occur silently with no real user impact.
Below the playback is additional information related to the error. This includes stack traces if you have provided us with sourcemaps, and request and response information if the issue type is a network error.
The list to the left of the session playback shows the metadata associated with the specific session playback.
The 2nd tab, "Breakdown", reveals cumulative information about the issue, such as frequency of occurrence, most common browser, and number of users and sessions impacted.
3rd Party Ignore List
Network Errors and Frustrating Network Requests can be quite noisy when including 3rd party endpoints. When enabling "Ignore 3rd Party URLs" from "Issues Settings" (in "Settings"), network requests made from/to these endpoints will not generate issue events and therefore be excluded from Issues. These events will still be visible in Session Replay. The ignored 3rd Party URLs are ads and analytics tracking tools that are noisy, cause no negative affect to users when they are slow or fail, and are async. The 3rd party URLs are updated regularly and include a range of endpoints from major platforms, ie. ads.linkedin.com
and analytics.google.com/g/collect
.
Updated about 2 months ago