@dynatrace/react-native-plugin 2.287.3 → 2.291.1

package/README.md

@@ -15,6 +15,8 @@ If you want to start using this plugin and are not a Dynatrace customer yet, hea
   * Reporting React Native errors
 * Manual instrumentation
   * Typescript bindings to add manual instrumentation
+* New React-Native architecture
+>**Note:** With iOS specifically, we noticed that there are some features that are not working the same as when using the current default architecture. You may experience issues with crash reporting being captured and web requests being linked to specific user actions. Per react native, [the new architecture is experimental](https://reactnative.dev/docs/the-new-architecture/landing-page#should-i-use-the-new-architecture-today). We will keep an eye on new updates and will continue to improve our support for the new architecture on both platforms.
 
 ## Requirements
 * React v16.8 or newer
@@ -29,8 +31,8 @@ If you want to start using this plugin and are not a Dynatrace customer yet, hea
 ## Agent Versions
 This agent versions are configured in this plugin:
 
-* Android Agent: 8.287.1.1006
-* iOS Agent: 8.287.2.1009
+* Android Agent: 8.291.1.1002
+* iOS Agent: 8.291.1.1004
 
 ## Quick Setup
 
@@ -55,7 +57,7 @@ This agent versions are configured in this plugin:
   * [Crash Reporting](#manually-report-a-crash)
   * [User Privacy Options](#user-privacy-options)
   * [Report GPS Position](#report-gps-location)
-  * [Business events capturing](#business-event-capturing)
+  * [Business event capturing](#business-event-capturing)
   * [Platform independent reporting](#platform-independent-reporting)
   * [Set beacon headers](#setting-beacon-headers)
   * [Exclude Individual JSX Elements](#exclude-individual-jsx-elements)
@@ -73,6 +75,7 @@ This agent versions are configured in this plugin:
   * [Agent debug logs](#native-oneagent-debug-logs)
 * [How does Dynatrace determine the user action name?](#how-does-dynatrace-determine-the-user-action-name)
   * [Using dtActionName](#using-dtactionname-to-change-the-name-of-the-action)
+* [How does Dynatrace automatically report crashes?](#how-does-dynatrace-automatically-report-crashes)
 * [React Automatic Runtime](#react-automatic-runtime)
 * [Using a second transformer besides the dynatrace transformer](#using-a-second-transformer-besides-the-dynatrace-transformer)
 * [Upgrading project to Gradle 6](#updating-to-gradle-6)
@@ -217,10 +220,10 @@ module.exports = {
 
 Example of a startup call:
 
-```js
+```ts
 import { Dynatrace, ConfigurationBuilder } from '@dynatrace/react-native-plugin';
 
-Dynatrace.start(new ConfigurationBuilder("beaconUrl", "applicationId").buildConfiguration());
+await Dynatrace.start(new ConfigurationBuilder("beaconUrl", "applicationId").buildConfiguration());
 ```
 
 For more details see the section about [startup API](#plugin-startup).
@@ -231,39 +234,45 @@ For more details see the section about [startup API](#plugin-startup).
 
 To use the API of the React Native plugin, import the API:
 
-```js
-import { Dynatrace, Platform } from '@dynatrace/react-native-plugin';
+```ts
+import { Dynatrace } from '@dynatrace/react-native-plugin';
 ```
 
 ### Plugin startup
 
 The manual startup of the plugin is triggered via the `start(configuration: IConfiguration)` method. If you configured `dynatrace.config.js` for manual startup then the plugin doesn't send any data when not calling this function. Besides the application id and the beacon URL, there are several optional configuration parameters, which are shown in the table below. 
 
-```js
+```ts
+import { Dynatrace, ConfigurationBuilder, LogLevel } from '@dynatrace/react-native-plugin';
+
 const configurationBuilder = new ConfigurationBuilder("beaconUrl", "applicationId");
 
 configurationBuilder.withCrashReporting(true)
+  .withErrorHandler(true)
+  .withReportFatalErrorAsCrash(true)
   .withLogLevel(LogLevel.Info)
   .withLifecycleUpdate(false)
   .withUserOptIn(false)
   .withActionNamePrivacy(false)
   .withBundleName(undefined);
   
-Dynatrace.start(configurationBuilder.buildConfiguration());
+await Dynatrace.start(configurationBuilder.buildConfiguration());
 ```
 
-**Info**: The values used in the function calls for the parameters are also their default value.
+**Info**: The value used in the function calls for the parameters is also their default value.
 
-| Property name    | Type   | Default     | Description                                       |
-|------------------|--------|-------------|---------------------------------------------------|
-|beaconUrl         |string  |undefined         |Identifies your environment within Dynatrace. This property is mandatory for [manual startup](#manual-oneagent-startup). OneAgent issues an error when the key isn't present.|
-|applicationId     |string  |undefined         |Identifies your mobile app. This property is mandatory for [manual startup](#manual-oneagent-startup). OneAgent issues an error when the key isn't present.|
-|reportCrash       |boolean |true         |Reports crashes.                  |
-|logLevel          |LogLevel|LogLevel.Info|Allows you to choose between `LogLevel.Info` and `LogLevel.Debug`. Debug returns more logs. This is especially important when something is not functioning correctly.|
-|lifecycleUpdate   |boolean |false        |Decide if you want to see update cycles on lifecycle actions as well. This is per default false as it creates a lot more actions.|
-|userOptIn        |boolean  |false        |Activates the privacy mode when set to `true`. User consent must be queried and set. The privacy settings for [data collection](#data-collection) and [crash reporting](#crash-reporting) can be changed via  OneAgent SDK for Mobile as described under Data privacy. The default value is `false`.|
-|actionNamePrivacy|boolean|false|Activates a privacy mode especially for Touchables and Buttons. Setting this option to true means that a name for the control will no longer be shown, e.g. "Touch on Button". When setting a dtActionName onto the component this setting will be ignored. 
-|bundleName|string|undefined|Should be used only if you have a multiple bundle setup where you load several .bundle files within your React Native application. Enter the name of your bundle. This should be unique in comparison to your other bundle names. This will ensure that actions coming from different bundles will not interfere with each other.
+| Property name           | Type   | Default     | Description                                       |
+|-------------------------|--------|-------------|---------------------------------------------------|
+|beaconUrl                |string  |undefined         |Identifies your environment within Dynatrace. This property is mandatory for [manual startup](#manual-oneagent-startup). OneAgent issues an error when the key isn't present.|
+|applicationId            |string  |undefined         |Identifies your mobile app. This property is mandatory for [manual startup](#manual-oneagent-startup). OneAgent issues an error when the key isn't present.|
+|reportCrash              |boolean |true         |Reports crashes.                  |
+|errorHandler             |boolean |true         |Enables the error/crash handler.  |
+|reportFatalErrorAsCrash  |boolean |true         |Reports an unhandled fatal error as a crash or an error. |
+|logLevel                 |LogLevel|LogLevel.Info|Allows you to choose between `LogLevel.Info` and `LogLevel.Debug`. Debug returns more logs. This is especially important when something is not functioning correctly.|
+|lifecycleUpdate          |boolean |false        |Decide if you want to see update cycles on lifecycle actions as well. This is per default false as it creates a lot more actions.|
+|userOptIn                |boolean |false        |Activates the privacy mode when set to `true`. User consent must be queried and set. The privacy settings for [data collection](#user-privacy-options) and [crash reporting](#crash-reporting) can be changed via  OneAgent SDK for Mobile as described under Data privacy. The default value is `false`.|
+|actionNamePrivacy        |boolean |false        |Activates a privacy mode especially for Touchables and Buttons. Setting this option to true means that a name for the control will no longer be shown, e.g. "Touch on Button". When setting a dtActionName onto the component this setting will be ignored. 
+|bundleName               |string  |undefined    |Should be used only if you have a multiple bundle setup where you load several .bundle files within your React Native application. Enter the name of your bundle. This should be unique in comparison to your other bundle names. This will ensure that actions coming from different bundles will not interfere with each other.
 
 **Attention:** 
 * Keep in mind that configuration within the `dynatrace.config.js` file is the basis, even for manual startup. When we look at the lifecycleUpdate property: Per default if not used, it is false. If enabled (set to true) in `dynatrace.config.js` file, this will be also true if manual startup is used. You can still override this behavior by calling `ConfigurationBuilder.withLifecycleUpdate(false)`.
@@ -275,13 +284,16 @@ A component can be either monitored automatically or manually. The auto instrume
 
 * Example with Functional Component:
 
-```js
+```ts
+import { Dynatrace } from '@dynatrace/react-native-plugin';
+
 export function MyFunctionalComponent(){
   ...
 }
 
 Dynatrace.withMonitoring(MyFunctionalComponent, "MyFunctionalComponent");
 ```
+![rnFunctionalComp](https://dt-cdn.net/images/rnfunctionalcomp-800-d98eacef6d.png)
 
 The String "MyFunctionalComponent" is optional as the name of the component can be retrieved through [different properties](#how-does-dynatrace-determine-the-user-action-name).
 
@@ -293,24 +305,31 @@ There are two options to create an action. Either using `enterAutoAction` (the p
 
 * `enterAutoAction` - Creates an Action which will be automatically handled by the plugin (This is the type of action which is internally used by the plugin when monitoring components and touchables). This means that the plugin decides about the hierachy of this action. If there is no open action, the following action will be a root action. All other actions created by this method, while a root action is open, will be automatically inserted as a child action. Furthermore the plugin will automatically link webrequest (if they are not tagged manually) to the open root action.
 
-```js
-let myAction = Dynatrace.enterAutoAction("MyButton tapped");
+```ts
+import { Dynatrace } from '@dynatrace/react-native-plugin';
+
+const myAction = Dynatrace.enterAutoAction("MyButton tapped");
 //Perform the action and whatever else is needed.
 myAction.leaveAction();
 ```
+![rnSingle](https://dt-cdn.net/images/rnsingle-800-e7e1b343ed.png)
 
 * `enterManualAction` - Creates an Action which will NOT be handled by the plugin. This means that you have full control about the hierachy of your actions. This function will create a root action for you, which has the ability to create child actions via `enterAction`. Be aware, because of the full manual approach the plugin will not link webrequest automatically. Webrequest have to be manually tagged by using the tag provided by the action via `getRequestTag`.
 
-```js
-let myAction = Dynatrace.enterManualAction("MyButton tapped");
+```ts
+import { Dynatrace } from '@dynatrace/react-native-plugin';
+
+const myAction = Dynatrace.enterManualAction("MyButton tapped");
 //Perform the action and whatever else is needed.
 myAction.leaveAction();
 ```
 
 To create a custom action named `"MyButton tapped"`, use the following code. The *leaveAction* closes the action again. To report values for this action before closing, see [Report Values](#report-values).
 
-```js
-let myAction = Dynatrace.enterAutoAction("MyButton tapped");
+```ts
+import { Dynatrace } from '@dynatrace/react-native-plugin';
+
+const myAction = Dynatrace.enterAutoAction("MyButton tapped");
 //Perform the action and whatever else is needed.
 myAction.leaveAction();
 ```
@@ -319,20 +338,25 @@ myAction.leaveAction();
 
 You can create a single custom action as well as sub actions. The `MyButton Sub Action` is automatically put under the `MyButton tapped`. As long as `MyButton tapped` is open, it gathers all the web requests.
 
-```js
-let myAction = Dynatrace.enterManualAction("MyButton tapped");
-let mySubAction = myAction.enterAction("MyButton Sub Action");
+```ts
+import { Dynatrace } from '@dynatrace/react-native-plugin';
+
+const myAction = Dynatrace.enterManualAction("MyButton tapped");
+const mySubAction = myAction.enterAction("MyButton Sub Action");
 //Perform the action and whatever else is needed.
 mySubAction.leaveAction();
 myAction.leaveAction();
 ```
+![subAction](https://dt-cdn.net/images/subaction-800-172dbcca6c.png)
 
 ### Cancel actions
 
 Actions can be canceled. That means they will not be sent and discarded fully. This also means that any values and sub actions attached to the action will be removed. 
 
-```js
-let myAction = Dynatrace.enterAutoAction("MyButton tapped");
+```ts
+import { Dynatrace } from '@dynatrace/react-native-plugin';
+
+const myAction = Dynatrace.enterAutoAction("MyButton tapped");
 // Action will be canceled
 myAction.cancel();
 
@@ -347,7 +371,9 @@ You can manually tag and time your web requests. With the API shown below, you a
 **Note:** 
 Using this API will force the request to be added to the action that is manually created. 
 
-```js
+```ts
+import { Dynatrace, DynatraceWebRequestTiming } from '@dynatrace/react-native-plugin';
+
 let url = 'https://www.dynatrace.com';
 // You can also use enterAutoAction if desired
 let action = Dynatrace.enterManualAction("Manual Web Request");
@@ -368,10 +394,13 @@ try {
   action.leaveAction();
 }
 ```
+![rnManualWeb](https://dt-cdn.net/images/rnmanualweb-800-662d009613.png)
 
 There is also the option to report values for request and response size:
 
-```js
+```ts
+import { Dynatrace, DynatraceWebRequestTiming } from '@dynatrace/react-native-plugin';
+
 let url = 'https://www.dynatrace.com';
 // You can also use enterAutoAction if desired
 let action = Dynatrace.enterManualAction("Manual Web Request");
@@ -380,7 +409,11 @@ let timing = new DynatraceWebRequestTiming(url, tag);
 
 try {      
   timing.startWebRequestTiming();
-  let axiosResponse = await axios.get(url);
+  let axiosResponse = await axios.get(url, {
+    headers: {
+        timing.getRequestTagHeader(): tag
+    }
+  });
   timing.stopWebRequestTimingWithSize(axiosResponse.status, axiosResponse.data, 122, 63);
 } catch (error) {
   timing.stopWebRequestTiming(-1, error);
@@ -388,6 +421,7 @@ try {
   action.leaveAction();
 }
 ```
+![rnBytes](https://dt-cdn.net/images/rnbytes-800-139042060c.png)
 
 ### Report values
 
@@ -403,11 +437,14 @@ reportStringValue(valueName: string, value: string, platform?: Platform): void
 
 To report a string value, use the following:
 
-```js
-let myAction = Dynatrace.enterAutoAction("MyButton tapped");
+```ts
+import { Dynatrace } from '@dynatrace/react-native-plugin';
+
+const myAction = Dynatrace.enterAutoAction("MyButton tapped");
 myAction.reportStringValue("ValueName", "ImportantValue");
 myAction.leaveAction();
 ```
+![rnReportString](https://dt-cdn.net/images/rnreportstring-800-739e5ba752.png)
 
 If you look at the API calls, you will see the optional parameter `platform?: Platform`. This parameter offers the possibility to report values only for a specific platform. to know more, see [Platform independent reporting](#platform-independent-reporting).
 
@@ -419,6 +456,7 @@ To manually report an error stacktrace, use the following API call:
 ```ts
 reportErrorStacktrace(errorName: string, errorValue: string, reason: string, stacktrace: string, platform?: Platform): void;
 ```
+![rnStack](https://dt-cdn.net/images/rnstack-800-26c6ac7408.png)
 
 **Note:**
 The previous API without *errorValue* is deprecated and will be removed in the future. Please use the new API with errorValue if possible.
@@ -427,15 +465,20 @@ The previous API without *errorValue* is deprecated and will be removed in the f
 
 You can identify a user and tag the current session with a name by making the following call:
 
-```js
+```ts
+import { Dynatrace } from '@dynatrace/react-native-plugin';
+
 Dynatrace.identifyUser("User XY");
 ```
+![rnTag](https://dt-cdn.net/images/rntag-800-77fe848023.png)
 
 ### End the current user session
 
 To end the current user session, use the following API call:
 
-```js
+```ts
+import { Dynatrace } from '@dynatrace/react-native-plugin';
+
 Dynatrace.endSession();
 ```
 
@@ -449,6 +492,7 @@ You can manually report a crash via the following API call:
 reportCrash(crashName: string, reason: string, stacktrace: string, platform?: Platform): void;
 reportCrashWithException(crashName: string, crash: Error, platform?: Platform): void;
 ```
+![rnCrash](https://dt-cdn.net/images/rncrash-800-3e7391140f.png)
 
 > **Note**: If you use this API call to report a crash manually, it will force the session to be completed. Any new actions that are captured afterwards will be added into a new session.
 
@@ -480,12 +524,16 @@ applyUserPrivacyOptions(userPrivacyOptions: UserPrivacyOptions, platform?: Platf
 To check the current privacy options that are set:
 
 ```ts
-let privacyOptions = await Dynatrace.getUserPrivacyOptions();
+import { Dynatrace } from '@dynatrace/react-native-plugin';
+
+const privacyOptions = await Dynatrace.getUserPrivacyOptions();
 ```
 
 If you want to create a new `UserPrivacyOptions` object:
 
 ```ts
+import { DataCollectionLevel, UserPrivacyOptions } from '@dynatrace/react-native-plugin';
+
 let privacyConfig = new UserPrivacyOptions(DataCollectionLevel.UserBehavior, true);
 ```
 
@@ -506,6 +554,8 @@ let crashReporting = privacyConfig.crashReportingOptedIn;
 To apply the values that were set on the object:
 
 ```ts
+import { Dynatrace } from '@dynatrace/react-native-plugin';
+
 Dynatrace.applyUserPrivacyOptions(privacyConfig);
 ```
 
@@ -521,33 +571,41 @@ setGPSLocation(latitude: number, longitude: number, platform?: Platform): void
 
 You probably noticed that each method has an additional *optional* parameter named `platform` of type `Platform`. You can use this to only trigger manual instrumentation for a specific OS. The available values are: `Platform.Ios` and `Platform.Android`. Default is that it will work on any platform. Otherwise it is passed *only* to the relevant OS. For example:
  * Passing to **iOS** only:
-```js
-let myAction = Dynatrace.enterAutoAction("MyButton tapped", Platform.Ios);
+```ts
+import { Dynatrace, Platform } from '@dynatrace/react-native-plugin';
+
+const myAction = Dynatrace.enterAutoAction("MyButton tapped", Platform.Ios);
 //Perform the action and whatever else is needed.
 myAction.leaveAction("ios"); 
 ```
  
  * Passing to **Android** only:
-```js
-let myAction = Dynatrace.enterAutoAction("MyButton tapped", Platform.Android);
+```ts
+import { Dynatrace, Platform } from '@dynatrace/react-native-plugin';
+
+const myAction = Dynatrace.enterAutoAction("MyButton tapped", Platform.Android);
 //Perform the action and whatever else is needed.
 myAction.leaveAction("android"); 
 ```
  
  * Passing to **both**:
-```js
-let myAction = Dynatrace.enterAutoAction("MyButton tapped");
+```ts
+import { Dynatrace } from '@dynatrace/react-native-plugin';
+
+const myAction = Dynatrace.enterAutoAction("MyButton tapped");
 //Perform the action and whatever else is needed.
 myAction.leaveAction(); 
 ```
 
-### Business events capturing
+### Business event capturing
 
 With `sendBizEvent`, you can report business events. These events are standalone events, as OneAgent sends them detached from user actions or user sessions.
 
 For more information on business events, see [dynatrace documentation](https://www.dynatrace.com/support/help/how-to-use-dynatrace/business-analytics/ba-events-capturing#expand--example-configuration-files-for-rum--2).
 
-```dart
+```ts
+import { Dynatrace } from '@dynatrace/react-native-plugin';
+
 Dynatrace.sendBizEvent("com.easytravel.funnel.booking-finished", {
   "event.name" : "Confirmed Booking",
   "screen": "booking-confirmation",
@@ -562,6 +620,7 @@ Dynatrace.sendBizEvent("com.easytravel.funnel.booking-finished", {
   "childrenTravelers": 0
 });
 ```
+![rnBiz](https://dt-cdn.net/images/rnbiz-1262-f57a0a67f3.png)
 
 ### Setting beacon headers
 
@@ -569,7 +628,7 @@ This allows you to put a set of http headers on every agent http request (i.e. A
 
 **Note:** To clear the previously set headers, call the method without the headers parameter or with a null value for the headers parameter.
 
-```js
+```ts
 setBeaconHeaders(headers?: Map<string, string> | null, platform?: Platform): void;
 ```
 
@@ -577,7 +636,7 @@ setBeaconHeaders(headers?: Map<string, string> | null, platform?: Platform): voi
 
 If you want to instrument a functional component or class component but want to exclude a certain button or element, you can do this via the `dtActionIgnore` property. Example:
 
-```js
+```ts
 function TouchableHighlightScreen() {
     return (
         <View>
@@ -755,13 +814,15 @@ module.exports = {
 
 ### Manual Startup Counterparts
 
-Here is a list of all the counterparts for the options that can be used with a manual startup. Below the counterparts table you will find an example configuration block for both Android and iOS.
+Here is a list of all the counterparts for the options that can be used with a manual startup. Below in the counterparts table you will find an example configuration block for both Android and iOS.
 
 | Property Name | Default | Android | iOS | React |
 |---------------|------|---------|-------------|-------------|
 |beaconUrl|undefined|autoStart.beaconUrl|DTXBeaconURL| - |
 |applicationId|undefined|autoStart.applicationId|DTXApplicationId| - |
 |reportCrash|true|crashReporting|DTXCrashReportingEnabled| - |
+|errorHandler|true| - | - |errorHandler.enabled|
+|reportFatalErrorAsCrash|true| - | - |errorHandler.reportFatalErrorAsCrash|
 |logLevel|LogLevel.Info|debug.agentLogging|DTXLogLevel| debug |
 |lifecycleUpdate|false| - | - | lifecycle.includeUpdate |
 |userOptIn|false|userOptIn|DTXUserOptIn| - |
@@ -816,6 +877,25 @@ react: {
 
 This activates the debug mode. You will get more console output during instrumentation and at runtime.
 
+#### Error Handler
+
+```js
+react: {
+  errorHandler: {
+    enabled: true,
+    reportFatalErrorAsCrash: true,
+  },
+}
+```
+
+The `enabled` property activates our Error/Crash handler which will insert our handler into your React Native application. This is true per default. 
+
+The `reportFatalErrorAsCrash` property should be set to false if you are wanting to report a fatal/unhandled error as an error and NOT a crash. Setting this value to false will keep the current session open.
+
+**Note:**
+if `enabled` is set to false, the value of `reportFatalErrorAsCrash` is not be considered/used as our error handler will not be started.
+
+
 #### Autostart
 
 ```js
@@ -824,7 +904,7 @@ react: {
 }
 ```
 
-This activates the AutoStart mode, which will insert an auto start call in your React Native application. This is per default true. If you want to use a manual startup call, please have a look into the [manual startup section](#manual-oneagent-startup).
+This activates the AutoStart mode which will insert an auto start call in your React Native application. This is true per default. If you want to use a manual startup call, please have a look into the [manual startup section](#manual-oneagent-startup).
 
 #### Bundle Name
 
@@ -927,7 +1007,7 @@ The variable ${APPLICATION_ID} must then be inserted with a prebuild script. Mak
 
 ## User opt-in mode
 
-Specifies if the user has to opt-in for being monitored. When enabled, you must specify the privacy setting. For more information, see the [API section](#data-collection).
+Specifies if the user has to opt-in for being monitored. When enabled, you must specify the privacy setting. For more information, see the [API section](#user-privacy-options).
 
 ### Android
 
@@ -1040,6 +1120,19 @@ JavaScript:
 
 *Note:* [actionNamePrivacy](#plugin-startup) has no impact on using dtActionName. dtActionName will always be used.
 
+## How does Dynatrace automatically report crashes?
+ 
+In general, Dynatrace always closes the session when a crash occurs. Usually a crash is when the application gets fully terminated. In React Native, we also see fatal errors in the JavaScript part as a full crash even though the native application is still alive. When this happens we will end the session. This is due to visibility reasons and may change in the future. The automated crash reporting will be (automatically) put in place by the transformer at the very beginning of the application. Using a custom error handler afterwards will not interfere with our crash handler.
+
+**Note:** The behavior mentioned below occurs if an error contains a stacktrace or if the stacktrace is empty/missing.
+
+* Non fatal error: If the internal React Native crash handler shows the error is not fatal, we will report it as error.
+* Fatal error: If the error is considered as fatal by the React Native crash handler, it will be treated as crash.
+* Native crashes: If a crash appears solely on the native side and is not noticed by the internal React Native crash handler, it will be reported directly by the Android or iOS agent.
+  * Exception: Some JavaScript crashes will result in Native crashes. Therefore, they are filtered on the native side as normally the crash would be reported twice. On the JavaScript side, these crashes are already reported by us before they hit the native side resulting in no lost information.
+Additionally, you can use our crash and error reporting APIs which are available with [manual instrumentation](#manual-instrumentation).
+
+
 ## React Automatic Runtime
 
 React introduced with React v17.x, React v16.14.0, React v15.7.0, and React v14.10 the automatic runtime which changes the JSX transformation (https://reactjs.org/blog/2020/09/22/introducing-the-new-jsx-transform.html). 
@@ -1308,6 +1401,7 @@ To resolve problems with the plugin, first look at creating logs and identify wh
 ** The android configuration was not added to your project. Please refer to the [install the plugin](#install-the-plugin) section.
 * For Android, if you see an error like "Gradle sync failed: Could not find com.dynatrace.tools.android:gradle-plugin:8.223.1.1003.", please see the [MavenCentral](#mavenCentral) section for an example and more information.
 * When using NodeJS version `15+` and version `2.231.1` of our plugin you could encounter the following error: `npm ERR! Could not resolve dependency: npm ERR! peer react@"^16.0" from @react-native-community/picker@1.8.1`. Using the old deprecrated [Picker dependency](https://www.npmjs.com/package/@react-native-community/picker) was causing peer dependency issues so we updated the auto-instrumentation to use the [new Picker dependency.](https://www.npmjs.com/package/@react-native-picker/picker) If you are still using this `@react-native-community/picker`, you can manually instrument the picker without issue ([create custom actions](#create-custom-actions)).
+* To disable the error handler when using manual startup, you will need to use/migrate to the `ConfigurationBuilder` instead of the deprecated `ManualStartupConfiguration`. There is no option to disable the crash handler using `ManualStartupConfiguration`.
 
 ## Report a bug or open a support case
 
@@ -1320,6 +1414,15 @@ If you are struggling with a problem, submit a support ticket to Dynatrace (supp
 <br/><br/>
 ## Changelog
 
+2.291.1
+* Update Android (8.291.1.1002) & iOS Agent (8.291.1.1004)
+* Updated the way we report unhandled errors without a stacktrace
+
+2.289.1
+* Update Android (8.289.2.1007) & iOS Agent (8.289.1.1015)
+* Added option to disable error handler for auto and manual start
+* Updated touchable instrumentation for React Native v74
+
 2.287.3
 * Update Android (8.287.1.1006) & iOS Agent (8.287.2.1009)
 * Added request and response size to [manual web request tagging](#manual-web-request-tagging)
@@ -1464,7 +1567,7 @@ If you are struggling with a problem, submit a support ticket to Dynatrace (supp
 * Fixed transformation problems with TSImportType and JSX
 * Updated error handler to report crashes instead of error stacktraces
 * Added [setBeaconHeaders API](#setting-beacon-headers)
-* Added [UserPrivacyOptions API](#data-collection)
+* Added [UserPrivacyOptions API](#user-privacy-options)
 * Updated DataCollection level enum members to match native agents
 
 1.202.0

package/android/build.gradle

@@ -70,7 +70,7 @@ repositories {
 }
 
 dependencies {
-	implementation 'com.dynatrace.agent:agent-android:8.287.1.1006'
+	implementation 'com.dynatrace.agent:agent-android:8.291.1.1002'
     implementation "com.facebook.react:react-native:${safeExtGet('reactNative', '+')}"
 }
   

package/android/src/main/java/com/dynatrace/android/agent/DynatraceRNBridgeImpl.java

@@ -161,12 +161,11 @@ public class DynatraceRNBridgeImpl {
         }
     }
 
-    public void reportCrash(String errorName, String reason, String stacktrace, boolean isRealError, boolean newSession, String platform){
+    public void reportCrash(String errorName, String reason, String stacktrace, boolean isRealError, String platform){
         if (this.shouldWorkOnAndroid(platform)) {
             Dynatrace.reportCrash(isRealError ? PlatformType.JAVA_SCRIPT : PlatformType.CUSTOM, errorName, reason, stacktrace);
-            if(newSession){
-                Dynatrace.createNewSession();
-            }     
+            // Generate new session like iOS to make sure the behavior is the same
+            Dynatrace.createNewSession();
         }
     }
 

package/android/src/new/java/com/dynatrace/android/agent/DynatraceRNBridge.java

@@ -71,12 +71,12 @@ public class DynatraceRNBridge extends NativeDynatraceBridgeSpec {
     }
 
     @Override
-    public void reportCrash(String errorName, String reason, String stacktrace, boolean isRealError, boolean newSession, String platform){
-        this.impl.reportCrash(errorName, reason, stacktrace, isRealError, newSession, platform);
+    public void reportCrash(String errorName, String reason, String stacktrace, boolean isRealError, String platform){
+        this.impl.reportCrash(errorName, reason, stacktrace, isRealError, platform);
     }
 
     @Override
-    public void storeCrash(String errorName, String reason, String stacktrace, String platform){
+    public void storeCrash(String errorName, String reason, String stacktrace){
         // Empty on Purpose
     }
 

package/android/src/old/java/com/dynatrace/android/agent/DynatraceRNBridge.java

@@ -73,12 +73,12 @@ public class DynatraceRNBridge extends ReactContextBaseJavaModule {
     }
 
     @ReactMethod
-    public void reportCrash(String errorName, String reason, String stacktrace, boolean isRealError, boolean newSession, String platform){
-        this.impl.reportCrash(errorName, reason, stacktrace, isRealError, newSession, platform);
+    public void reportCrash(String errorName, String reason, String stacktrace, boolean isRealError, String platform){
+        this.impl.reportCrash(errorName, reason, stacktrace, isRealError, platform);
     }
 
     @ReactMethod
-    public void storeCrash(String errorName, String reason, String stacktrace, String platform){
+    public void storeCrash(String errorName, String reason, String stacktrace){
         // Empty on Purpose
     }
 

package/files/default.config.js

@@ -10,6 +10,20 @@ module.exports = {
          */
         debug: true,
 
+        errorHandler: {
+            /**
+             * Error handler is enabled.
+             */
+            enabled: true,
+
+            /**
+             * If we catch an unhandled error (fatal) with our error handler, we will report it as a crash 
+             * when using the default value of true. If the value is set to false, we will report the fatal 
+             * error as an error and continue the session.
+             */
+            reportFatalErrorAsCrash: true,
+        },
+
         lifecycle: {
             /**
              * Decide if you want to see Update Cycles as well

package/files/plugin.gradle

@@ -1,3 +1,3 @@
 dependencies {
-	classpath 'com.dynatrace.tools.android:gradle-plugin:8.287.1.1006'
+	classpath 'com.dynatrace.tools.android:gradle-plugin:8.291.1.1002'
 }

package/ios/DynatraceRNBridge.mm

@@ -172,22 +172,22 @@ RCT_EXPORT_METHOD(reportError:(NSString *)errorName errorValue:(NSString *)error
     }
 }
 
-RCT_EXPORT_METHOD(reportCrash:(NSString *)errorName errorReason:(NSString *)errorReason stacktrace:(NSString *)stacktrace isRealError:(BOOL)isRealError newSession:(BOOL)newSession platform: (NSString *) platform)
+RCT_EXPORT_METHOD(reportCrash:(NSString *)errorName errorReason:(NSString *)errorReason stacktrace:(NSString *)stacktrace isRealError:(BOOL)isRealError platform: (NSString *) platform)
 {
     if ([self shouldWorkOnIosWithPlatform: platform])
     {
         if(isRealError){
-            [DTXAction reportExternalCrashForPlatformType:DTXActionPlatformJavaScript crashName:errorName reason:errorReason stacktrace:stacktrace];
+            [DTXAction reportExternalCrashForPlatformType:DTXActionPlatformCustom crashName:errorName reason:errorReason stacktrace:stacktrace]; 
         }else{
             [DTXAction reportExternalCrashForPlatformType:DTXActionPlatformCustom crashName:errorName reason:errorReason stacktrace:stacktrace];
         }
         
-        // We ignore the newSession parameter and always end the session as the iOS agent has no troubles with this behavior
+        // Always end the session as the iOS agent has no troubles with this behavior
         [Dynatrace endVisit];
     }
 }
 
-RCT_EXPORT_METHOD(storeCrash:(NSString *)crashName reason:(NSString *)reason stacktrace:(NSString *)stacktrace newSession:(BOOL)newSession) {
+RCT_EXPORT_METHOD(storeCrash:(NSString *)crashName reason:(NSString *)reason stacktrace:(NSString *)stacktrace) {
     NSString* dirPath = [[[[NSFileManager defaultManager] URLsForDirectory:NSApplicationSupportDirectory inDomains:NSUserDomainMask] firstObject] path];
     dirPath = [dirPath stringByAppendingPathComponent:@"DTXExternalCrashes"];
     // Create the Application Support/DTXExternalCrashes directory if it does not exist
@@ -202,10 +202,7 @@ RCT_EXPORT_METHOD(storeCrash:(NSString *)crashName reason:(NSString *)reason sta
     // Store react native crash
     [[NSFileManager defaultManager] createFileAtPath:[dirPath stringByAppendingPathComponent:@"RNCrash.txt"] contents:[crashJson dataUsingEncoding:NSUTF8StringEncoding] attributes:nil];
 
-    // Create a new session if the app is in debug mode or reloadOnFatalError value is set to true where the crash is caught and the app is not forced to shutdown
-    if (newSession) {
-        [Dynatrace endVisit];
-    }
+    [Dynatrace endVisit];
 }
 
 RCT_EXPORT_METHOD(reportErrorInAction:(nonnull NSString *)key errorName:(NSString *)errorName errorCode:(nonnull NSNumber *)errorCode platform: (NSString *) platform)