Skip to content

Commit 91c6c26

Browse files
Un-single-source React Native and Expo RUM docs (DataDog#17810)
* Un-single-source React Native and Expo RUM docs * Update content/en/real_user_monitoring/reactnative/integrated_libraries.md Co-authored-by: Louis Zawadzki <louiszawadzki@users.noreply.github.com> * add integrated libraries and light edits * added more info to integrated libraries * Louis suggestions * Add data_collected * add data collected to side nav * louis suggestions --------- Co-authored-by: Louis Zawadzki <louiszawadzki@users.noreply.github.com>
1 parent a8b87d1 commit 91c6c26

File tree

16 files changed

+1830
-384
lines changed

16 files changed

+1830
-384
lines changed

.github/CODEOWNERS

Lines changed: 21 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -45,27 +45,30 @@ docker-compose-docs.yml @DataDog/corpweb
4545
documentation/content/en/cloud_cost_management/_index.md @DataDog/cloud-cost-management-visibility @DataDog/documentation
4646

4747
# Log collection
48-
content/en/logs/log_collection/android/ @Datadog/rum-mobile @DataDog/documentation
49-
content/en/logs/log_collection/flutter.md @Datadog/rum-mobile @DataDog/documentation
50-
content/en/logs/log_collection/ios/ @Datadog/rum-mobile @DataDog/documentation
48+
content/en/logs/log_collection/android.md @Datadog/rum-mobile @DataDog/documentation
49+
content/en/logs/log_collection/flutter.md @Datadog/rum-mobile @DataDog/documentation
50+
content/en/logs/log_collection/ios.md @Datadog/rum-mobile @DataDog/documentation
5151

5252
# Traces
53-
content/en/tracing/trace_collection/dd_libraries/android.md @Datadog/rum-mobile @DataDog/documentation
54-
content/en/tracing/trace_collection/dd_libraries/ios.md @Datadog/rum-mobile @DataDog/documentation
53+
content/en/tracing/trace_collection/dd_libraries/android.md @Datadog/rum-mobile @DataDog/documentation
54+
content/en/tracing/trace_collection/dd_libraries/ios.md @Datadog/rum-mobile @DataDog/documentation
5555

5656
# Mobile SDK
57-
content/en/real_user_monitoring/android/ @Datadog/rum-mobile @DataDog/documentation
58-
content/en/real_user_monitoring/flutter/ @Datadog/rum-mobile @DataDog/documentation
59-
content/en/real_user_monitoring/ios.md @Datadog/rum-mobile @DataDog/documentation
60-
content/en/real_user_monitoring/error_tracking/android.md @Datadog/rum-mobile @DataDog/documentation
61-
content/en/real_user_monitoring/error_tracking/flutter.md @Datadog/rum-mobile @DataDog/documentation
62-
content/en/real_user_monitoring/error_tracking/ios.md @Datadog/rum-mobile @DataDog/documentation
63-
content/en/real_user_monitoring/roku/ @Datadog/rum-mobile @DataDog/documentation
57+
content/en/real_user_monitoring/android/ @Datadog/rum-mobile @DataDog/documentation
58+
content/en/real_user_monitoring/flutter/ @Datadog/rum-mobile @DataDog/documentation
59+
content/en/real_user_monitoring/ios/ @Datadog/rum-mobile @DataDog/documentation
60+
content/en/real_user_monitoring/reactnative/ @Datadog/rum-mobile @DataDog/documentation
61+
content/en/real_user_monitoring/roku/ @Datadog/rum-mobile @DataDog/documentation
62+
content/en/real_user_monitoring/error_tracking/android.md @Datadog/rum-mobile @DataDog/documentation
63+
content/en/real_user_monitoring/error_tracking/expo.md @Datadog/rum-mobile @DataDog/documentation
64+
content/en/real_user_monitoring/error_tracking/flutter.md @Datadog/rum-mobile @DataDog/documentation
65+
content/en/real_user_monitoring/error_tracking/ios.md @Datadog/rum-mobile @DataDog/documentation
66+
content/en/real_user_monitoring/error_tracking/reactnative.md @Datadog/rum-mobile @DataDog/documentation
6467

6568
# Browser SDK
66-
content/en/real_user_monitoring/browser/ @Datadog/rum-browser @DataDog/documentation
67-
content/en/real_user_monitoring/guide/ @Datadog/rum-browser @DataDog/documentation
68-
content/en/real_user_monitoring/session_replay/ @Datadog/rum-browser @DataDog/documentation
69-
content/en/logs/log_collection/javascript.md @Datadog/rum-browser @DataDog/documentation
70-
content/en/logs/error_tracking/browser_and_mobile.md @Datadog/rum-browser @DataDog/documentation
71-
content/en/real_user_monitoring/error_tracking/browser.md @Datadog/rum-browser @DataDog/documentation
69+
content/en/real_user_monitoring/browser/ @Datadog/rum-browser @DataDog/documentation
70+
content/en/real_user_monitoring/guide/ @Datadog/rum-browser @DataDog/documentation
71+
content/en/real_user_monitoring/session_replay/ @Datadog/rum-browser @DataDog/documentation
72+
content/en/logs/log_collection/javascript.md @Datadog/rum-browser @DataDog/documentation
73+
content/en/logs/error_tracking/browser_and_mobile.md @Datadog/rum-browser @DataDog/documentation
74+
content/en/real_user_monitoring/error_tracking/browser.md @Datadog/rum-browser @DataDog/documentation

.gitignore

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -87,16 +87,6 @@ content/en/compliance_monitoring/default_rules/*.md
8787
*.log
8888
npm-debug.log*
8989

90-
# RUM
91-
content/en/real_user_monitoring/error_tracking/expo.md
92-
content/en/real_user_monitoring/error_tracking/reactnative.md
93-
content/en/real_user_monitoring/reactnative/_index.md
94-
content/en/real_user_monitoring/reactnative/advanced_configuration.md
95-
content/en/real_user_monitoring/reactnative/integrated_libraries.md
96-
content/en/real_user_monitoring/reactnative/codepush.md
97-
content/en/real_user_monitoring/reactnative/mobile_vitals.md
98-
content/en/real_user_monitoring/reactnative/expo.md
99-
10090
# Continuous Testing
10191
content/en/continuous_testing/cicd_integrations/configuration.md
10292
content/en/continuous_testing/cicd_integrations/github_actions.md

config/_default/menus/menus.en.yaml

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3287,36 +3287,46 @@ main:
32873287
parent: rum
32883288
identifier: rum_reactnative
32893289
weight: 4
3290+
- name: Data Collected
3291+
url: real_user_monitoring/reactnative/data_collected/
3292+
parent: rum_reactnative
3293+
identifier: rum_reactnative_data_collected
3294+
weight: 401
32903295
- name: Advanced Configuration
32913296
url: real_user_monitoring/reactnative/advanced_configuration/
32923297
parent: rum_reactnative
32933298
identifier: rum_reactnative_advanced_configuration
3294-
weight: 401
3299+
weight: 402
32953300
- name: Mobile Vitals
32963301
url: real_user_monitoring/reactnative/mobile_vitals/
32973302
parent: rum_reactnative
32983303
identifier: rum_reactnative_mobile_vitals
3299-
weight: 402
3304+
weight: 403
33003305
- name: Web View Tracking
33013306
url: real_user_monitoring/reactnative/web_view_tracking/
33023307
parent: rum_reactnative
33033308
identifier: rum_reactnative_web_view_tracking
3304-
weight: 403
3309+
weight: 404
33053310
- name: Expo
33063311
url: real_user_monitoring/reactnative/expo/
33073312
parent: rum_reactnative
33083313
identifier: rum_reactnative_expo
3309-
weight: 404
3314+
weight: 405
33103315
- name: CodePush
33113316
url: real_user_monitoring/reactnative/codepush/
33123317
parent: rum_reactnative
33133318
identifier: rum_reactnative_codepush
3314-
weight: 405
3319+
weight: 406
3320+
- name: Integrated Libraries
3321+
url: real_user_monitoring/reactnative/integrated_libraries/
3322+
parent: rum_reactnative
3323+
identifier: rum_reactnative_integrated_libraries
3324+
weight: 407
33153325
- name: Troubleshooting
33163326
url: real_user_monitoring/reactnative/troubleshooting/
33173327
parent: rum_reactnative
33183328
identifier: rum_reactnative_troubleshooting
3319-
weight: 406
3329+
weight: 408
33203330
- name: Flutter Monitoring
33213331
url: real_user_monitoring/flutter/
33223332
parent: rum
Lines changed: 107 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
---
2+
title: Expo Crash Reporting and Error Tracking
3+
kind: documentation
4+
description: Capture Expo crash reports in Datadog.
5+
further_reading:
6+
- link: https://www.datadoghq.com/blog/debug-android-crashes/
7+
tag: Blog
8+
text: Debug Android crashes faster with Datadog
9+
- link: https://www.datadoghq.com/blog/ios-crash-reporting-datadog/
10+
tag: Blog
11+
text: Debug iOS crashes efficiently with Datadog
12+
- link: /real_user_monitoring/error_tracking/
13+
tag: Documentation
14+
text: Learn about Error Tracking
15+
- link: /real_user_monitoring/error_tracking/explorer
16+
tag: Documentation
17+
text: Visualize Error Tracking data in the RUM Explorer
18+
19+
---
20+
## Overview
21+
22+
Enable Expo Crash Reporting and Error Tracking to get comprehensive crash reports and error trends with Real User Monitoring.
23+
24+
With this feature, you can access the following features:
25+
26+
- Aggregated Expo crash dashboards and attributes
27+
- Symbolicated iOS and deobfuscated Android crash reports
28+
- Trend analysis with Expo error tracking
29+
30+
In order to symbolicate your stack traces and deobfuscate Android crashes, upload your .dSYM, Proguard mapping files and source maps to Datadog using the `expo-datadog` config plugin.
31+
32+
Your crash reports appear in [**Error Tracking**][1].
33+
34+
## Setup
35+
36+
Use the [`expo-datadog` package and configuration plugin][2]. For more information, see the [Expo and Expo Go documentation][3].
37+
38+
Add `@datadog/datadog-ci` as a development dependency. This package contains scripts to upload the source maps. You can install it with NPM:
39+
40+
```sh
41+
npm install @datadog/datadog-ci --save-dev
42+
```
43+
44+
or with Yarn:
45+
46+
```sh
47+
yarn add -D @datadog/datadog-ci
48+
```
49+
50+
Run `eas secret:create` to set `DATADOG_API_KEY` to your Datadog API key.
51+
52+
### Disable file uploads
53+
54+
You can disable some files from uploading by setting the `iosDsyms`, `iosSourcemaps`, `androidProguardMappingFiles`, or `androidSourcemaps` parameters to `false`.
55+
56+
```json
57+
{
58+
"expo": {
59+
"plugins": [
60+
[
61+
"expo-datadog",
62+
{
63+
"errorTracking": {
64+
"iosDsyms": false
65+
}
66+
}
67+
]
68+
]
69+
}
70+
}
71+
```
72+
73+
### Setting the Datadog site
74+
75+
Run `eas secret:create` to set `DATADOG_SITE` to the host of your Datadog site, for example: `datadoghq.eu`. By default, `datadoghq.com` is used.
76+
77+
### Plugin configuration options
78+
79+
| Parameter | Default | Description |
80+
| ----------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------- |
81+
| `iosDsyms` | `true` | Enables the uploading of dSYMS files for the symbolication of native iOS crashes. |
82+
| `iosSourcemaps` | `true` | Enables the uploading of JavaScript source maps on iOS builds. |
83+
| `androidProguardMappingFiles` | `true` | Enables the uploading of Proguard mapping files to deobfuscate native Android crashes (is only applied if obfuscation is enabled). |
84+
| `androidSourcemaps` | `true` | Enables the uploading of JavaScript source maps on Android builds. |
85+
86+
### Using with Sentry
87+
88+
Both Datadog and Sentry config plugins use regular expressions to modify the "Bundle React Native code and images" iOS build phase to send the sourcemap. This can make your EAS builds fail with a `error: Found argument 'datadog-ci' which wasn't expected, or isn't valid in this context` error.
89+
90+
To use both plugins, make sure to add the `expo-datadog` plugin first in order in your `app.json` file:
91+
92+
```
93+
"plugins": [
94+
"expo-datadog",
95+
"sentry-expo"
96+
]
97+
```
98+
99+
If you are using the `expo-dev-client` and already have the `expo-datadog` plugin, revert its changes to the `project.pbxproj` file before adding `sentry-expo` and running `npx expo prebuild` with both plugins.
100+
101+
## Further reading
102+
103+
{{< partial name="whats-next/whats-next.html" >}}
104+
105+
[1]: https://app.datadoghq.com/rum/error-tracking
106+
[2]: https://github.com/DataDog/expo-datadog
107+
[3]: /real_user_monitoring/reactnative/expo/#usage

0 commit comments

Comments
 (0)