Skip to content

Commit 2b9103b

Browse files
authored
update device vitals and crash/error reporting (#2934)
1 parent 4ee217e commit 2b9103b

File tree

7 files changed

+31
-16
lines changed

7 files changed

+31
-16
lines changed

docs/mobile-apps/features/mobile-app-diagnostics/app-crash-logs.md renamed to docs/mobile-apps/features/mobile-app-diagnostics/crash-error-reporting.md

Lines changed: 22 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,40 @@
11
---
2-
id: app-crash-logs
3-
title: App Crash Logs
4-
sidebar_label: App Crash Logs
2+
id: crash-error-reporting
3+
title: Crash/Error Reporting
4+
sidebar_label: Crash/Error Reporting
55
---
66

77
import useBaseUrl from '@docusaurus/useBaseUrl';
88

9-
The App Crash Logs feature on Sauce Labs' Real Device Cloud (RDC) platform facilitates the automatic capture and display of crash data, both during live and automated testing. This eliminates the necessity to integrate an SDK or connect crash reporting tools to our system.
9+
<p><small><span className="sauceGreen">Real Devices Only</span></small></p>
1010

11-
Through the App Crash Logs feature, users gain access to a centralized view encompassing an array of app diagnostic signals. This expedites the debugging process for teams and reduces issue resolution time. Our primary objective is to establish expedited feedback loops for developers, enabling the early identification of risks and ensuring comprehensive coverage within the development cycle. With this enhanced capability, teams can effectively prioritize errors, crashes, and test failures based on complete data and context, focusing their efforts on the most critical issues.
11+
The Crash/Error Reporting feature on Sauce Labs' Real Device Cloud (RDC) platform facilitates the automatic capture and display of crash data, both during live and automated testing. This eliminates the necessity to integrate an SDK or connect crash reporting tools to our system.
12+
13+
Through the Crash/Error Reporting feature, users gain access to a centralized view encompassing an array of app diagnostic signals. This expedites the debugging process for teams and reduces issue resolution time. Our primary objective is to establish expedited feedback loops for developers, enabling the early identification of risks and ensuring comprehensive coverage within the development cycle. With this enhanced capability, teams can effectively prioritize errors, crashes, and test failures based on complete data and context, focusing their efforts on the most critical issues.
1214

1315
Our tool has the capability to detect and record fatal errors (crashes) that occur during the testing of both iOS and Android apps. Specifically for Android apps, this information is sent to [Error Reporting](/error-reporting/getting-started/), enabling the viewing of detailed call stack information. Furthermore, our interface also renders all non-fatal errors and warnings originating from the native application visible. This feature streamlines debugging and facilitates seamless integration with other Mobile App Diagnostics components, ultimately enhancing issue identification and resolution efficiency.
1416

1517
## What You'll Need
1618

1719
- A Sauce Labs account ([Log in](https://accounts.saucelabs.com/am/XUI/#login/) or sign up for a [free trial license](https://saucelabs.com/sign-up))
1820
- A native Android, iOS, or iPadOS mobile app
19-
- Make sure instrumentation is enabled, no other configuration is required.
2021

21-
## Viewing the App Crash Logs for Real Devices​
22+
## Using Crash/Error Reporting for Real Devices
23+
24+
To use the Crash/Error Reporting feature, you must ensure that the functionality is enabled for your app.
25+
26+
1. In Sauce Labs, from the left navigation, click **App Management**.
27+
<img src={useBaseUrl('img/mobile-apps/app-management.png')} alt="App Management" width="700"/>
28+
2. Upload your mobile app.
29+
<img src={useBaseUrl('img/mobile-apps/app-logs-8.png')} alt="App Logs" width="700"/>
30+
3. After you’ve uploaded your app, locate it in the table and select **Settings** from the corresponding row.
31+
<img src={useBaseUrl('img/mobile-apps/app-management-select-settings.png')} alt="Select Settings" width="700"/>
32+
4. Under **Real Device Settings** first enable **Instrumentation** and then toggle **Crash/Error Reporting** on.
33+
<img src={useBaseUrl('img/mobile-apps/crash-error-reporting-app-setting.png')} alt="Crash/Error Reporting App Setting" width="700"/>
34+
35+
## Viewing the App Crash Logs for Real Devices
2236

23-
The App Crash Logs feature is automatically activated when the [Instrumentation feature](/mobile-apps/features/mobile-app-diagnostics/interactions/#using-interactions-for-real-devices) is enabled. Upon detecting a crash, our system will exhibit an `App Crashed` label for the corresponding test result, regardless of the test's status.
37+
Upon detecting a crash, our system will exhibit an `App Crashed` label for the corresponding test result, regardless of the test's status.
2438

2539
<br/><img src={useBaseUrl('img/mobile-apps/app-crash-scr1.png')} alt="Mobile app settings navigation" width="900"/>
2640

docs/mobile-apps/features/mobile-app-diagnostics/device-vitals.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,8 @@ import useBaseUrl from '@docusaurus/useBaseUrl';
88
import Tabs from '@theme/Tabs';
99
import TabItem from '@theme/TabItem';
1010

11+
<p><small><span className="sauceGreen">Real Devices Only</span></small></p>
12+
1113
Device Vitals is a functionality that allows you to debug and observe an app’s performance during test execution for both, [Live](/mobile-apps/live-testing/live-mobile-app-testing/) and [Automated](/mobile-apps/automated-testing/) testing. With this feature, the app's performance is recorded during the test session and displayed for your test results.
1214

1315
## What You'll Need
@@ -17,17 +19,16 @@ Device Vitals is a functionality that allows you to debug and observe an app’s
1719

1820
## Using Device Vitals for Real Devices
1921

20-
By default, Device Vitals is enabled if the instrumentation feature is enabled.
21-
To enable device instrumentation:
22+
To use Device Vitals, you must ensure that the functionality is enabled for your app.
2223

2324
1. In Sauce Labs, from the left navigation, click **App Management**.
24-
<img src={useBaseUrl('img/mobile-apps/app-logs5.png')} alt="App Logs" width="300"/>
25+
<img src={useBaseUrl('img/mobile-apps/app-management.png')} alt="App Management" width="700"/>
2526
2. Upload your mobile app.
2627
<img src={useBaseUrl('img/mobile-apps/app-logs-8.png')} alt="App Logs" width="700"/>
27-
3. After you’ve uploaded your app, hover your mouse over your app, then select **Settings**.
28-
<img src={useBaseUrl('img/mobile-apps/app-logs-6.png')} alt="App Logs" width="700"/>
29-
4. Under **Real Device Settings** toggle **Instrumentation** to **Enabled**.
30-
<img src={useBaseUrl('img/mobile-apps/app-logs-7.png')} alt="App Logs" width="700"/>
28+
3. After you’ve uploaded your app, locate it in the table and select **Settings** from the corresponding row.
29+
<img src={useBaseUrl('img/mobile-apps/app-management-select-settings.png')} alt="Select Settings" width="700"/>
30+
4. Under **Real Device Settings** first enable **Instrumentation** and then toggle **Device Vitals** on.
31+
<img src={useBaseUrl('img/mobile-apps/device-vitals-app-setting.png')} alt="Device Vitals App Setting" width="700"/>
3132

3233
Now you can start your live or automated testing session. Your Device Vitals will be captured and be part of your test results.
3334

sidebars.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1366,8 +1366,8 @@ module.exports = {
13661366
collapsed: true,
13671367
items: [
13681368
'mobile-apps/features/mobile-app-diagnostics/app-logs',
1369-
'mobile-apps/features/mobile-app-diagnostics/app-crash-logs',
13701369
'mobile-apps/features/mobile-app-diagnostics/device-vitals',
1370+
'mobile-apps/features/mobile-app-diagnostics/crash-error-reporting',
13711371
'mobile-apps/features/mobile-app-diagnostics/interactions',
13721372
'mobile-apps/features/mobile-app-diagnostics/view-tree',
13731373
'mobile-apps/features/network-capture',
Loading
134 KB
Loading
Loading
Loading

0 commit comments

Comments
 (0)