Issues

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, and Error States, but we plan to expand into more issue types 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 - Occurs when a user clicks repeatedly in frustration on an element.
• Dead Clicks - Occurs 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".

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, and Error State 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.

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 add custom rules to group issues together and assign them the same status. You can choose to group based on the contents of the error message or the type of error. You can also assign the group a custom name.

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.