Capture your First Error

Now that the Demo App is up and running on your local environment integrated with the Sentry SDK, you’re ready to generate the first error.

Note: If you’re not using the provided React demo code, follow Capturing your first event to introduce an error to your source code and continue with Step 2

Step 1: Capture your First Event

  1. Launch the demo app by opening the localhost link in your browser

  2. Open the browser’s JavaScript Console to verify that an error has occurred

    Import and Configure SDK

  3. Click on any of the Buy! buttons to add products to your shopping cart

  4. Click on the Checkout button on the left panel to generate an error

    Import and Configure SDK

    Notice that:

    • An error message Something went wrong displays in the app
    • The error stack trace shows in the browser console
    • An alert sent to your email address configured on notifying you about an error that occurred in your app

      Import and Configure SDK

Step 2: Handle the Error

  1. Go to your email inbox and open the email notification from Sentry

    Import and Configure SDK

  2. Click on View on Sentry to view the full details and context of this error in your Sentry account

  3. Open the Event in the Issue details page

    Import and Configure SDK

    Note: Sentry aggregates similar errors (events) into one Issue

  4. Scroll down to the Exception stack trace

    Error Stack-trace

    • Notice that the stack trace is minified. JavaScript is typically minified to reduce to the size of the source code.
    • Sentry can un-minify the code back to its readable form and display source (code) context lines in the stack frames, which is covered in the next tutorial.

Step 3: Create New Alerts

You can create various alert rules per project and let Sentry know when, how, and whom you want to notify when errors occur in your application. Alert rules consist of Conditions and Actions, which are performed when the associated conditions are met. For more information, see Alerts.

By default, each project is created with one initial alert rule, notifying all project team members (via email) the first time a new issue appears. This means that the next time the Checkout error occurs, the notification is not triggered since the error is not “new.”

In this step, you create a new Alert rule notifying every time an event occurs, even if it’s associated with an already existing issue.

  1. Click on the cog icon next to the project name to open the Project Settings

    Open Project Settings

  2. Click on Alerts to open the Alerts Configuration page

    Notice the default alert rule already defined in your project

  3. Click on New Alert Rule

    Alerts Configuration

  4. In the New Alert Rule form, enter the following values

    New Alert Rule form

    The new alert rule notifies you every time an event is seen in All Environments via Mail

  5. Click Save Rule to create the new rule

  6. To test the new rule, reproduce the error in the demo app


Enable Readable Stack Traces in your Errors