Services

Your Honeybadger data can be sent to a variety of third-party services, listed below. We support creating issues for errors in the SCM and project management tools, such as GitHub and Jira. For communication tools like Slack and PagerDuty, we can send notifications for errors, sites that go down (and come back up), and check-ins.

See the page on integrations for info on the settings that are common to all integrations.

AlertOps

1. Select the AlertOps integration

alertops integration

2. Enter the AlertOps URL

After you set up the integration URL at AlertOps, you can enter that URL here.

3. Save

That's it! You're good to go.

Asana

1. Select the Asana integration

asana integration

asana integration

2. Enter your API key

To get your Asana API key, go to Asana and do the following:

  • Click your profile photo from the top bar and select My Profile Settings
  • Navigate to the Apps tab
  • Select API Key

3. Enter your workspace id

To get your Workspace ID, log into Asana and go to https://app.asana.com/api/1.0/workspaces. This will give you a JSON object which contains your workspaces along with their IDs.

4. Enter your project id (optional)

You can optionally enter a Project id, if you want all tasks created by Honeybadger to belong to a specific project.

You can get your project's ID by looking at its Asana URL. It will be the first string of numbers directly after the /0/. For example if the URL is https://app.asana.com/0/3333333333333/777777777777 that means your project id is 3333333333333.

Save

That's it! You can test the integration by clicking "Test". Otherwise, just save it and you're ready to go.




Bitbucket

1. Select the Bitbucket integration

bitbucket integration bitbucket integration

2. Set the repository name

The repository name includes the account name. For example, Honeybadger has a repo called "docs" the repository name we'd enter here is "honeybadger/docs".

3. Authenticate

Click "Save and Authenticate With Bitbucket" to complete setup. This will send you to bitbucket.org to authenticate via OAuth.




Campfire

1. Select the Campfire integration

campfire integration campfire form

2. Set the API key

To get your Campfire API key, log into campfire and go into the "My Info" page. Then click on "Show your tokens." More info

3. Set the Subdomain

If you go to honeybadger.campfirenow.com to log into campfire, you'll enter "honeybadger" here. No need to enter the full domain name.

3. Set the Room

This is the name of your chatroom. It needs to exactly match the name you see on screen.

4. Save

That's it! You can test the integration by clicking "Test". Otherwise, just save it and you're ready to go.




Clubhouse

clubhouse integration

1. Set the organization

This is the name of the organization that you created when you set up your account. You can find this immediately after the domain name in the URL: e.g., for https://app.clubhouse.io/honeybadger the organization name is honeybadger.

2. Set the API Token

Your API Token can be found in the Clubhouse UI by clicking on the gear icon for settings, choosing the Your Account link, then choosing the API Tokens link. Choose a name for your token (like Honeybadger) and click Generate Token. Copy the highlighted token, and paste that in the API Token field.

3. Fetch project info

Click the Fetch project info button to make a request to the Clubhouse API to get your list of projects and workflow states. This will populate and enable the remaining checkboxes on the form.

4. Choose the project and workflow states

Each Honeybadger project is associated with one Clubhouse project, and you can make that choice here. You can also choose which of your Clubhouse workflow states will be chosen for stories when they are marked as resolved or unresolved. The stories will be updated to those states if you also enable the respective Error Events options.

Creating stories from the UI

Users can create stories in Clubhouse by clicking the Create Story button on the error detail page in the Honeybadger UI. By default, these stories will be created as the Clubhouse user whose API Token is configured in the integration settings. Users can have stories associated with their own Clubhouse account by getting an API Token as described previously and adding it to their authentication settings.




Datadog

1. Select the Datadog integration

datadog integration datadog form

2. Set the API key

You can generate a Datadog API key on the Datadog integrations page.

3. Choose whether to send metrics

Enabling the "Send metrics" option will result in the metric honeybadger.occurrences_per_minute to be reported to Datadog.

4. Save

That's it! You can test the integration by clicking "Test". Otherwise, just save it and you're ready to go.




Email

Heads Up! This isn't where you configure your personal email notifications. This email channel is specifically for integrating with services like Basecamp which consume inbound email.

1. Select the Email integration

email integration email form

2. Enter the email address

It's just an email address, folks. I'm sure you can figure it out. :wink:

3. Save

That's it! Just save and you're ready to go.




Flowdock

1. Select the Flowdock integration

flowdock integration flowdock form

2. Set the API key

You can get your Flowdock API key by logging into Flowdock, then going to Account > API Tokens.

3. Enter tags (optional)

If you'd like us to tag errors we send to Flowdock, just enter a comma-separated list of tags here.

4. Save

That's it! You can test the integration by clicking "Test". Otherwise, just save it and you're ready to go.




GitHub

1. Select the GitHub integration

github integration github form

2. Authenticate

If you haven't already granted our GitHub app access to your account, you will be prompted to do so. After that is done, you'll be prompted to install our GitHub app in your GitHub repositories. Once that's done, you'll be able to create a new GitHub integration.

3. Set the repository name

The repository name includes the account or organization name. For example, our gem is hosted at https://github.com/honeybadger-io/honeybadger-ruby, so we'd enter "honeybadger-io/ruby" for the repo name to connect to that repository.

4. Enter labels (optional)

If you'd like us to label issues we create in GitHub, just enter a comma-separated list of tags here.

5. Save

That's it! You can test the integration by clicking "Test". Otherwise, just save it and you're ready to go.




GitLab

1. Select the GitLab integration

gitlab integration

2. Set the repository name

The repository name includes the account or organization name. For example, if your project is hosted at https://gitlab.com/honeybadger-io/app, you'd enter "honeybadger-io/app" for the repo name to connect to that repository.

3. Enter labels (optional)

If you'd like us to label issues we create in GitLab, just enter a comma-separated list of tags here.

4. Enter Server URL and Personal access token (optional)

Our default configuration assumes you are hosting your code at gitlab.com and that we'll use OAuth to connect to your account for creating issues. If you are using a self-hosted version of GitLab, then enter the URL of the GitLab installation and enter a personal access token. We will use that personal access token (generated in the GitLab UI at Settings -> Access Tokens) rather than OAuth.

5. Save

That's it! You'll be redirected to GitLab to grant OAuth access (if you left the server URL unchanged), or back to the integrations list if you used a custom server URL and a personal access token. Either way, once you're back at the integrations list, you can Edit your new GitLab integration and use the Test button to test creating an issue in your repository.




Google Hangouts Chat

1. Select the Google Hangouts Chat integration

google hangouts chat integration

2. Set the Webhook URL

You can get the Webhook URL by clicking the channel name where you want the notifications to appear in the Hangouts Chat UI:

Channel settings menu

Choosing the "Configure webhooks" option presents a popup that allows you to create a new webhook. You can enter Honeybadger for the name, and saving the webhook generates the webhook URL:

Webhook popup

Choose the Copy icon to copy the URL to your clipboard, then enter that url in channel settings in the Honeybadger UI.

3. Save

That's it! You can test the integration by clicking "Test". Otherwise, just save it and you're ready to go.

Bonus Step

If you'd like to install our chat bot in Google Hangouts Chat, search for "Honeybadger" in the "Find people, rooms, bots" search box in the Chat UI. Adding our bot will in Chat will prompt you to authorize the bot's access to your Honeybadger account. Once you do that, you'll be able to work with your Honeybadger data from within Chat.




HipChat

1. Select the HipChat integration

hipchat integration hipchat form

2. Set the repository name

You can create a HipChat API token by logging into HipChat and visiting the API Tokens page.

3. Set the room

This is the name of your chatroom. It needs to exactly match the name you see on screen.

4. Use a custom HipChat server (optional)

If you have a self-hosted version of HipChat, you can enter its url here and we'll use it.

5. Save

That's it! You can test the integration by clicking "Test". Otherwise, just save it and you're ready to go.




Intercom

1. Select the Intercom integration

intercom integration

intercom form

2. Enter your APP ID and API key

To get your APP ID and API key, go to Intercom and do the following:

  • Hover over your profile photo at the bottom of the left bar and select App Settings
  • Navigate to the API Keys tab
  • Grab your APP ID and API Key (or create a new "Full Access" API Key)

4. Enter your context field

This is the field that you set in the context in your application with the user ID that is associated with your Intercom users. For example, if you are identifying users with Intercom with current_user.id, and you have current_user.id in the user_id field of your context, then enter user_id in this field.

Save

That's it! You can test the integration by clicking "Test". Otherwise, just save it and you're ready to go.




Jira

Honeybadger only works with "Software Development" projects on Jira. This is because of the "issue types" we send, which are "bugs".

1. Select the Jira integration

jira integration jira form

2. Configure

Here's an overview of the options:

  • The username and password will be your login for Jira.
  • The server url is the subdomain of your Jira instance, such as "https://hb4lyfe.atlassin.net". Don't forget the "https://".
  • The project key was setup when you created the project. It can be found (on Jira) from Project Overview > Administration > Edit Project.
  • The transition ID's can be set in your workflows on Jira when viewed in text mode. ID's are unique, so make sure there are no conflicting values.

3. Save

That's it! You can test the integration by clicking "Test". Otherwise, just save it and you're ready to go.




OpsGenie

1. Select the OpsGenie integration

pagerduty integration pagerduty form

2. Set the API key

You can generate a OpsGenie API key by logging in to OpsGenie then clicking on "Settings". Here's a detailed walkthrough.

3. Save

That's it! You can test the integration by clicking "Test". Otherwise, just save it and you're ready to go.




PagerDuty

1. Select the PagerDuty integration

pagerduty integration pagerduty form

2. Set the API key

You can generate a PagerDuty API key by logging in to PagerDuty then clicking on "Add New Service" and choosing "Honeybadger" as the service type. Here's a walkthrough.

3. Save

That's it! You can test the integration by clicking "Test". Otherwise, just save it and you're ready to go.




Pivotal Tracker

1. Select the Pivotal Tracker integration

pivotal integration pivotal form

2. Set the API key

You can find your Pivotal Tracker API key by logging in to Pivotal and visiting your profile page.

2. Set the project id

You can find your project's id by examining the URL. If your project's url is pivotaltracker.com/projects/777 then the project id is "777".

3. Enter labels (optional)

If you'd like us to label the stories we create, just enter a comma-separated list of labels here.

4. Save

That's it! You can test the integration by clicking "Test". Otherwise, just save it and you're ready to go.




Redmine

1. Select the Redmine integration

redmine integration redmine form

2. Set the server & API key

The server URL is the full URL of your server - including https://.

You can find your API key on your account page when logged into Redmine

3. Configure transitions (optional)

You can specify the ids of transitions to be run when issues are resolved and reopened.

4. Save

That's it! You can test the integration by clicking "Test". Otherwise, just save it and you're ready to go.




Slack

1. Select the Slack integration

slack integration

When you click on the link to add Slack to your project, you will be redirected to Slack to approve the connection to your Slack team. After you choose the channel to receive Honeybadger messages and click the Authorize button, you will be redirected back to Honeybadger to finish editing the optional channel settings.

2. Save

That's it! You can test the integration by clicking "Test". Otherwise, just save it and you're ready to go.

Interactive messages

Messages about errors include a button to resolve or reopen the error:

Slack notification

The first time you click one of the buttons, you will be given a link that will allow you to connect your Slack account to your Honeybadger account. This connection only needs to be done once, and then you will be able to use the buttons and interact with the bot.

Using the bot

Once you have installed the Honeybadger Slack app, you will have a Honeybadger bot available to your Slack team. You can message the bot directly or you can invite it to join a channel and address it... either way, it understands the following commands:

Command Description
help Get help :)
show project <Project Name> Returns a list of faults that occurred recently in the Project Name project.
show fault <fault #> See details about the requested fault. The fault number can be found in the Honeybadger UI.
resolve fault <fault #> Mark the specified fault as resolved.
reopen fault <fault #> Mark the specified fault as reopened.




Sprintly

1. Select the Sprintly integration

sprintly integration sprintly form

2. Set the email & API key

You can get your Sprintly API key by logging into Sprintly and going to your Profile page. The key is at the bottom.

3. Set the product id

You can find your product's id by examining the URL. If your product's url is sprint.ly/product/777 then the product id is "777".

4. Save

That's it! You can test the integration by clicking "Test". Otherwise, just save it and you're ready to go.




Trello

1. Select the Trello integration

trello integration trello form

2. Connect your Trello Account

Just click the button to connect to trello via OAuth.

3. Select the board and list

These two dropdowns will be populated when you connect your account.

4. Save

That's it! Hit save and you're good to go.




VictorOps

1. Select the VictorOps integration

pagerduty integration pagerduty form

2. Set the API key

You can generate a VictorOps API key on the VictorOps integrations page.

3. Set the routing key (optional)

If you like, you can specify an arbitrary routing key for use by Victorops.

4. Save

That's it! You can test the integration by clicking "Test". Otherwise, just save it and you're ready to go.




WebHook

1. Select the WebHook integration

webhook integration webhook form

2. Set the URL for your webhook

We'll post notifications to this URL. Make sure to include the protocol: e.g., https://mysite.com/hook.

Make sure you have a service running that can accept POST requests, and hopefully do something interesting with JSON payloads like this one:

{
  "event":"occurred",
  "message":"[Crywolf/test] RuntimeError - oops",
  "fault":{
    "id":3151009,
    "project_id":1717,
    "klass":"RuntimeError",
    "component":null,
    "action":null,
    "environment":"development",
    "resolved":true,
    "ignored":false,
    "created_at":"2014-01-08T18:55:48Z",
    "comments_count":1,
    "message":"oops",
    "notices_count":9,
    "last_notice_at":"2014-01-08T19:02:21Z"
  }
}

3. Save

That's it! Hit save and you're good to go.