Install and configure Bugsnag Enterprise on your server.
To get started with your Bugsnag installation, you’ll need the following things prepared in advance:
/data, with at least 200gb of space. Ext4 or XFS filesystems are preferred.Confirm Docker is installed correctly and running on your machine. If successful, this command should report information about your running Docker instance.
$ sudo docker info
Download the bugsnag installation and management script and install it into your PATH.
$ curl -O https://bugsnag.com/enterprise-v2/bugsnag
$ chmod +x bugsnag
$ sudo mv bugsnag /usr/bin
Downloading and installing Bugsnag can take between 15-30 minutes.
$ sudo bugsnag install
During installation you’ll be prompted to select a data directory. This should be on a large volume (at least 200gb) with an Ext4 or XFS filesystem. This is the directory that will contain your Bugsnag data, and will need to be backed up.
In order to send notification emails when crashes occur, Bugsnag needs to have SMTP access configured.
You’ll need to edit the SMTP settings in /etc/bugsnag/env.sh:
# The hostname of your SMTP server
SMTP_ADDRESS=smtpserver.internal.example.com
# The port of your SMTP server (default: 25)
SMTP_PORT=25
# Specify a valid HELO domain (a valid, resolvable domain name)
# See http://bit.ly/1kbCMCo for details
SMTP_DOMAIN=example.com
# Specify a sender address for Bugsnag emails
SMTP_FROM=[email protected]
# If your mail server requires authentication, set the username here
SMTP_USERNAME=your-smtp-username
# If your mail server requires authentication, set the password here
SMTP_PASSWORD=your-smtp-password
# If your mail server requires authentication, you need to specify the
# authentication type here. This can be either plain, login or cram_md5.
SMTP_AUTHENTICATION=login
Bugsnag Enterprise exposes various services, which you may wish to map to user-friendly hostnames and ports. See Services, hostnames & ports for more information.
Once you have chosen where you’ll expose the Bugsnag dashboard, you’ll need to let the Bugsnag Enterprise know the hostname you’ve chosen by editing the BUGSNAG_WEBSITE_HOST setting in /etc/bugsnag/env.sh:
BUGSNAG_WEBSITE_HOST=http://bugsnag.internal.example.com
Now you’ve installed and configured Bugsnag, you’ll need to start the Bugsnag apps. This may take around 5 minutes the first time:
$ sudo bugsnag start
To check Bugsnag’s status as it boots, you can run the following command:
$ sudo bugsnag status
When all services are marked as up, your Bugsnag installation is complete.
Now Bugsnag is running, you should be able to access the Bugsnag dashboard, where you’ll need to create your account and first project.
Visit your Bugsnag dashboard in a web browser (available by default at x.x.x.x:49080) to set up your account and create projects for each of the applications you wish to monitor.
By default, Bugsnag reporting libraries will send errors to notify.bugsnag.com, so you’ll need to configure your applications to send errors to your on-premise installation, at the hostname/port you configured for the Bugsnag Event Server endpoint above.
For example, in ruby apps:
Bugsnag.configure do |config|
config.api_key = "your-api-key"
config.endpoint = "notify.bugsnag.internal.example.com"
end
Check the documentation for your library for details.
If you’re developing iOS/OS X applications, you’ll need to configure Xcode to send debug symbols to your on-premise installation, at the hostname/port you configured for the Bugsnag Upload Server endpoint above.
See the dSYM Upload API for how to configure this.
If you’re developing Android applications which are obfuscated using ProGuard, you’ll need to configure the Bugsnag Gradle Plugin to upload ProGuard mapping files to your on-premise installation, at the hostname/port you configured above for the Bugsnag Upload Server endpoint above.
See the custom endpoints for details.