Session Reporting

Session Reporting #

Now that you’ve added the Embrace SDK to your project and can login to the Embrace dashboard, you’re ready to create your first session. Here are the steps you’ll be taking to create your first session.

  1. Import Embrace
  2. Add a start call to the Embrace SDK
  3. End the Startup Moment
  4. Build and run the application
  5. Trigger a session upload

Import Embrace #

Start by importing the Embrace native SDK in the file that applies for each platform.

Open the AppDelegate.m file (usually located at <project root>/ios/<MyApp>/AppDelegate.m) and import Embrace.

#import <Embrace/Embrace.h>

Open the MainApplication.java file (usually located at <project root>/android/app/src/main/java/com/<MyApp>/MainApplication.java) and import Embrace.

import io.embrace.android.embracesdk.Embrace;
If you used the setup script mentioned on the Adding the Embrace SDK page, this change has already been made for you.

Add the Start Call #

After importing Embrace, update the same files that you edited in the previous step to make a call to the Embrace SDK to start capturing data.

@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *) launchOptions
{
    // Replace with your APP_ID, which is a 5-character value, e.g. "aBc45"
    [[Embrace sharedInstance] startWithKey:@"APP_ID" launchOptions: launchOptions framework:EMBAppFrameworkReactNative];
    return YES;
}
If you are using Swift, follow the steps in the iOS Linking Embrace section.
public class MainApplication extends Application implements ReactApplication {

    @Override
    public void onCreate() {
        super.onCreate();
        // Add this line right after the super.onCreate();
        Embrace.getInstance().start(this, false, Embrace.AppFramework.REACT_NATIVE);
    }
}

End the Startup Moment #

Embrace automatically starts the startup moment when your application launches. You’ll learn more about moments in Performance Monitoring guide. For now, you can think of the startup moment as a timer that measures how long it took your application to launch. Although in both Android and iOS the moment is started automatically, ending it is platform specific.

For Android, the SDK will end the moment automatically. To end the startup moment when you React component mounts, see the Android guide to prevent the moment from ending automatically.

The iOS SDK does not end the moment automatically.

In either platform, you can end the startup moment when your application mounts.

import {endAppStartup} from 'react-native-embrace';

export default class App extends Component {
  componentDidMount() {
    // Add this command at the end of componentDidMount
    endAppStartup();
  }
}
import React, {useEffect, useState} from 'react'
import {endAppStartup} from 'react-native-embrace';

const App = ()=> {

  useEffect(()=>{
    endAppStartup();
  },[])

 return ...
}
export default App
As useEffect does not block the render thread, unlike componentDidMount, it might be necessary to add a variable such as isReady to wait until all your background process are finished and the user is able to interact with the application.

End the startup moment as soon as your users are able to interact with the application.

Build and Run the Application #

Now you’re ready to build and run the application. Launch the application how you usually would during development.

If you encounter any errors, please get in touch on Slack and we can assist you.

Trigger a Session Upload #

To trigger a session upload, simply stop the application by either force killing it or using the stop button in either Xcode for iOS or Android Studio for Android. Now run the application again. This second launch will upload the previous session immediately. Refresh the dashboard in your browser and you should now see that you’ve moved on to the next step.


Congratulations! At this point you’ve completed a basic integration of Embrace. Embrace is already collecting interesting data from your application. You can see this data by browsing around the timeline page for the session you just captured.

Up next, you’ll be learning about uploading crash reports.

Upload Crash Report