Bugsnag Destination

1. From the Segment web app, click Catalog.
2. Search for "Bugsnag" in the Catalog, select it, and choose which of your sources to connect the destination to.
3. Add your API key to your connection settings. You can find your API key in your Bugsnag dashboard under "Settings", which is located in the upper left-hand corner
4. Segment automatically initializes Bugsnag's JavaScript script with your API key upon loading analytics.js

If you'd like to integrate with Bugsnag's iOS and/or Android SDKs, in addition to completing steps 1-3 in the previous section, you will also need to complete the install steps outlined below:

1. Android
2. iOS

Once you've set up your Bugsnag integration, call identify for each of your users as soon as you know their identity (typically after login or sign up), so that Bugsnag can show you which user encountered which error. To learn what the Identify method does, see the Segment Spec. An example call looks like:

1
analytics.identify('ze8rt1u89', {
2
  name: 'Zaphod Kim',
3
  gender: 'Male',
4
  email: 'jane.kim@example.com',
5
});

Bugsnag will show you the userId and traits in the Users tab of each error.

In addition to sending Bugsnag user-specific information, you can send handled exceptions and diagnostic data to your Bugsnag dashboard using Bugsnag's native methods. Documentation on these methods is available on their website.

Segment lets you change these destination settings from the Segment app without having to touch any code.