Amazon SQS

Integrating with Amazon SQS

Setup instructions

  1. In Raygun, on the application sidebar, click Integrations, then Amazon SQS:

  1. Click on the Setup tab, then enter the SQS Queue URL, details of the access key and secret key which has access to write to the queue, and the region code where your queue is being hosted. A table of valid region codes are listed below.

We strongly recommend that you set up a unique IAM user account so that the access key and secret key that you use for integration with Raygun can be specifically restricted with access rights to the queues that you are going to publish to via Raygun.

  1. Check the Enabled checkbox to enable the integration and then click Save Changes.
  2. Done! Error notifications will now be delivered to your Amazon SQS queue.

Notifications

Raygun will send notifications to you when the follow happens

  • A new error has occured (NewErrorOccurred)
  • Error reoccured after being resolved or ignored (ErrorReoccurred)
  • Error still occuring 1, 5, 10, 30, 60 minute/s later (OneMinuteFollowUp, FiveMinuteFollowUp, TenMinuteFollowUp, ThirtyMinuteFollowUp, HourlyFollowUp)

Supported Region Codes

USEast1 US East (N. Virginia)
USWest1 US West (N. California)
USWest2 US West (Oregon)
EUWest1 EU (Ireland)
SAEast1 South America (São Paulo)
APSoutheast1 Asia Pacific (Singapore)
APSoutheast2 Asia Pacific (Sydney)
APNortheast1 Asia Pacific (Tokyo)

 

JSON Payload

Payloads that are submitted to SQS will be in the following JSON format

{

  "CrashReportingNotification": {
    "NotificationInfo": {
      "Type": "NewErrorOccurred", // see Notifications section above for the valid range of codes supplied
      "Message": "A new error has been reported for Mindscape Website, the error was document.width is not a function"
    },
    "Application": {
      "Name": "Mindscape Website",
      "Url": "http://app.raygun.com/crashreporting/8rty6f"
    },
    "Group": {
      "Title": "document.width is not a function",
      "Url": "http://app.raygun.com/crashreporting/8rty6f/errors/1102848291",
      "FirstOccurredOn": "2015-09-06T02:14:48Z",
      "Count": 19530, // refers to the total number of occurrences of this error seen across all time
      "RecentRate": 123.45, // refers to the current rate of errors over the last minute
      "RecentTrend": "Increasing" // indicates if RecentRage is increasing or decreasing
    },
    "Error": {
      "OccurredOn": "2016-08-10T22:14:07.8771382Z",
      "Url": "http://app.raygun.com/crashreporting/8rty6f/errors/1102848291#1102848292",
      "Details": { // this section contains a copy of the full payload data that was submitted to Raygun
        "Error": {
          "ClassName": "TypeError",
          "Message": "document.width is not a function",
          "StackTrace": [
            {
              "LineNumber": 1,
              "ColumnNumber": 98012,
              "ClassName": "line 1, column 98012",
              "FileName": "http://www.mindscapehq.com/content/js/inner_E22C8C0D74230CDEF0A594B375FC930E.js",
              "MethodName": "at "
            },
            {
              "LineNumber": 1,
              "ColumnNumber": 254,
              "ClassName": "line 1, column 254",
              "FileName": "http://cdn.raygun.io/raygun4js/raygun.min.js",
              "MethodName": "b"
            },
            {
              "LineNumber": 1,
              "ColumnNumber": 37420,
              "ClassName": "line 1, column 37420",
              "FileName": "http://www.mindscapehq.com/content/js/inner_E22C8C0D74230CDEF0A594B375FC930E.js",
              "MethodName": "dispatch"
            },
            {
              "LineNumber": 1,
              "ColumnNumber": 33299,
              "ClassName": "line 1, column 33299",
              "FileName": "http://www.mindscapehq.com/content/js/inner_E22C8C0D74230CDEF0A594B375FC930E.js",
              "MethodName": "i"
            }
          ]
        },
        "Environment": {
          "UtcOffset": -4,
          "Browser-Width": 1904,
          "Browser-Height": 924,
          "Screen-Width": 1920,
          "Screen-Height": 1080,
          "Color-Depth": 24,
          "Browser": "Mozilla",
          "Browser-Name": "Netscape",
          "Browser-Version": "5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/52.0.2743.116 Safari/537.36",
          "Platform": "Win32"
        },
        "Client": {
          "Name": "raygun-js",
          "Version": "2.1.0"
        },
        "UserCustomData": {},
        "Tags": [],
        "Request": {
          "Url": "http://www.mindscapehq.com/blog/index.php/2012/1/12/caliburn-micro-part-1-getting-started/",
          "QueryString": {},
          "Headers": {
            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/52.0.2743.116 Safari/537.36",
            "Referer": "http://www.mindscapehq.com/products/wpfelements/mvvm-pattern-in-wpf",
            "Host": "www.mindscapehq.com"
          }
        },
        "Version": "3.4.0.0",
        "User": {
          "Identifier": "testing-identifier",
          "IsAnonymous": true,
          "UUID": "testing-user"
        }
      }
    }
  }
}

 

Asana

Asana - Integrating Asana With Raygun

Asana is a task tracking platform to help streamline your businesses teamwork. Create new tasks in Asana, or attach Raygun error groups to an existing Asana task, all directly from within Raygun.

Setup instructions

1. In the application sidebar, click on Integrations, then Asana:

2. Click the Setup tab, then click the 'Connect to Asana' button:

3. Grant Raygun permission to access Asana:

4. Re-enter your Raygun credentials

5. Select the Asana project, check the 'Enabled' box and click 'Save Changes':

6. You can now create a new Asana task or link to an existing one from a Raygun error group. Just click 'Asana' from the 'Integrations' drop down:

Assembla

Assembla - Integrating Assembla With Raygun

Assembla is for development teams, with hosted version control for code and files, tickets for tracking tasks and bugs, and many other project management tools. Create new tickets in Assembla, or attach Raygun error groups to an existing Assembla ticket, all directly from within Raygun.

Setup instructions

  1. In Raygun, in the application sidebar, click on Integrations, then Assembla:

  2. Click the Setup tab, then click the blue 'Connect to Assembla' button to grant access to Assembla:

  3. When prompted, enter your Assembla credentials.
  4. Select the 'Space' you want to want to link Raygun Crash Reporting to and click 'Enabled'.
  5. Click 'Save Changes'. Done!
  6. View an error group in Raygun Crash Reporting and you'll notice an 'Integrations' dropdown option. Click on 'Integrations' and pick Assembla to create a new issue for the error, or link with an existing one:

  7. If linking with an existing Assembla ticket, you can search for the ticket with either the ticket number or the ticket summary.

Azure Service Bus

Integrating with Windows Azure Service Bus Queues

Integrate Azure Service Bus with Raygun to push error notifications into the queue of your choosing so you are always aware of application errors.

Setup instructions

  1. In Raygun, on the application sidebar, click Integrations, then Azure Service Bus:

Locating the Azure Service Bus integration

  1. Click on the Setup tab, then enter the name of your service bus as the Namespace, the name of your Queue and the name of the Shared Access Policy and the access key for your access policy.

  1. Check the Enabled checkbox to enable the integration and then click Save Changes.
  2. Done! Error notifications will now be delivered to your Azure Service Bus queue.

Notifications

Raygun will send notifications to you when the follow happens

  • A new error has occured (NewErrorOccurred)
  • Error reoccured after being resolved or ignored (ErrorReoccurred)
  • Error still occuring 1, 5, 10, 30, 60 minute/s later (OneMinuteFollowUp, FiveMinuteFollowUp, TenMinuteFollowUp, ThirtyMinuteFollowUp, HourlyFollowUp)

JSON Payload

Payloads that are submitted to your queue will be in the following JSON format

{

  "CrashReportingNotification": {
    "NotificationInfo": {
      "Type": "NewErrorOccurred", // see Notifications section above for the valid range of codes supplied
      "Message": "A new error has been reported for Mindscape Website, the error was document.width is not a function"
    },
    "Application": {
      "Name": "Mindscape Website",
      "Url": "http://app.raygun.com/crashreporting/8rty6f"
    },
    "Group": {
      "Title": "document.width is not a function",
      "Url": "http://app.raygun.com/crashreporting/8rty6f/errors/1102848291",
      "FirstOccurredOn": "2015-09-06T02:14:48Z",
      "Count": 19530, // refers to the total number of occurrences of this error seen across all time
      "RecentRate": 123.45, // refers to the current rate of errors over the last minute
      "RecentTrend": "Increasing" // indicates if RecentRage is increasing or decreasing
    },
    "Error": {
      "OccurredOn": "2016-08-10T22:14:07.8771382Z",
      "Url": "http://app.raygun.com/crashreporting/8rty6f/errors/1102848291#1102848292",
      "Details": { // this section contains a copy of the full payload data that was submitted to Raygun
        "Error": {
          "ClassName": "TypeError",
          "Message": "document.width is not a function",
          "StackTrace": [
            {
              "LineNumber": 1,
              "ColumnNumber": 98012,
              "ClassName": "line 1, column 98012",
              "FileName": "http://www.mindscapehq.com/content/js/inner_E22C8C0D74230CDEF0A594B375FC930E.js",
              "MethodName": "at "
            },
            {
              "LineNumber": 1,
              "ColumnNumber": 254,
              "ClassName": "line 1, column 254",
              "FileName": "http://cdn.raygun.io/raygun4js/raygun.min.js",
              "MethodName": "b"
            },
            {
              "LineNumber": 1,
              "ColumnNumber": 37420,
              "ClassName": "line 1, column 37420",
              "FileName": "http://www.mindscapehq.com/content/js/inner_E22C8C0D74230CDEF0A594B375FC930E.js",
              "MethodName": "dispatch"
            },
            {
              "LineNumber": 1,
              "ColumnNumber": 33299,
              "ClassName": "line 1, column 33299",
              "FileName": "http://www.mindscapehq.com/content/js/inner_E22C8C0D74230CDEF0A594B375FC930E.js",
              "MethodName": "i"
            }
          ]
        },
        "Environment": {
          "UtcOffset": -4,
          "Browser-Width": 1904,
          "Browser-Height": 924,
          "Screen-Width": 1920,
          "Screen-Height": 1080,
          "Color-Depth": 24,
          "Browser": "Mozilla",
          "Browser-Name": "Netscape",
          "Browser-Version": "5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/52.0.2743.116 Safari/537.36",
          "Platform": "Win32"
        },
        "Client": {
          "Name": "raygun-js",
          "Version": "2.1.0"
        },
        "UserCustomData": {},
        "Tags": [],
        "Request": {
          "Url": "http://www.mindscapehq.com/blog/index.php/2012/1/12/caliburn-micro-part-1-getting-started/",
          "QueryString": {},
          "Headers": {
            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/52.0.2743.116 Safari/537.36",
            "Referer": "http://www.mindscapehq.com/products/wpfelements/mvvm-pattern-in-wpf",
            "Host": "www.mindscapehq.com"
          }
        },
        "Version": "3.4.0.0",
        "User": {
          "Identifier": "testing-identifier",
          "IsAnonymous": true,
          "UUID": "testing-user"
        }
      }
    }
  }
}

Bitbucket

Bitbucket - Integrating Bitbucket With Raygun

This integration will allow you to link a Raygun error group to a new or existing Bitbucket issue.

On this page:

Setup Instructions

  1. Log in to both your Bitbucket and Raygun accounts. In Raygun, in the application sidebar, click on Integrations, then Bitbucket:

  2. Click the Setup tab, then click the blue 'Bitbucket' button to grant access to Bitbucket:

  3. When prompted, enter your Raygun email address and password.
  4. Select which repository you want the issues to be delivered to, click 'Enabled' then 'Save Changes'.
  5. If you're using Bitbucket error tracking: View an error group in Raygun Crash Reporting and you'll notice an 'Integrations' dropdown option. Click on 'Integrations' and pick Bitbucket to create a new issue for the error, or link with an existing one:

Notes

Issue tracking

To connect Raygun error groups to issues in Bitbicket, or create new issues in in Bitbucket from an error group, you need to have Bitbucket issue tracking enabled.

This setting is found by going to  your repository in Bitbicket, clicking the 'Settings' on the left sidebar, then clicking the 'Issue tracker settings' option under the 'Issues' heading. You can then chose your issue tracking options:

If the issue tracker settings are set to 'No issue tracker', you will not be able to create or link any Bitbucket issues and an error message will appear:

 

Deployment tracking

The Bitbucket integration supports deployment tracking, which means:

  • More detailed deployment information
  • Ability to link your commits and release notes directly from Raygun to your source code

You do not need Bitbucket issue tracking to use this feature.

Create a webhook in Bitbucket

By using a webhook, resolving issues in Bitbucket will also resolve the linked Raygun error groups. Here's how to create a webhook in Bitbucket so you can get those error groups resolved in no time!

Setup instructions:

  1. Login to Bitbucket and ensure you are a repository administrator
  2. Navigate to the repository linked to your Raygun application
  3. Click on 'Settings' located the left sidebar
  4. Click on 'Webhooks' located under the 'Integrations' section
  5. Click on the 'Add webhook' button
  6. Give your webhook a 'Title'
  7. In the 'URL', copy and paste the 'JIRA Webhook URL' found in your Raygun Jira Setup tab
  8. Mark the 'Status' as 'Active'
  9. Leave the 'SSL / TLS' unchecked
  10. Set the 'Triggers' to 'Choose from a full list of triggers'
  11. Check the 'Updated' checkbox under 'Issue'
  12. Your settings should look like this:
  13. Click 'Save'

Learn more about Bitbucket webhooks

BugHerd

BugHerd - Integrating Bugherd With Raygun

BugHerd is a hosted bug tracker. This integration lets you create new BugHerd issues directly from your Raygun error report, creating a new issue on BugHerd that links to your Raygun Report.

Setup instructions

  1. In Raygun, in the application sidebar, click on Integrations, then BugHerd:

  2. Click the Setup tab, then paste in your API token:


    This can be found by logging in to your BugHerd account, clicking the ‘Settings’ option in the top menu and then ‘General Settings’. Select a project and enable the BugHerd plugin.
  3. View an error group in Raygun Crash Reporting and you'll notice an 'Integrations' dropdown option. Click on 'Integrations' and pick BugHerd to create a new issue for the error, or link with an existing one:

  4. Once an error is linked in Raygun Crash Reporting to a BugHerd issue, you’ll be able to view it in the sidebar of your BugHerd account. Clicking the error link will take you straight back to the issue in your Raygun account.

CA Agile Central

CA Agile Central - Integrating CA Agile Central With Raygun

CA Agile Central is an enterprise-class platform that’s purpose-built for scaling agile development practices. Save time and get extra insight into CA Agile Central defects by connecting to Raygun error groups.

Setup instructions

  1. In Raygun, in the application sidebar, click on Integrations, then CA Agile Central:

  2. Click the Setup tab, and enter the Server and your CA Agile Central credentials:


    The URL is the domain where your CA Agile Central instance is running, for example: https://rally1.rallydev.com
  3. Click 'Save Changes' and you're done!
  4. View an error group in Raygun Crash Reporting and you'll notice an 'Integrations' dropdown option. Click on CA Agile Central to create a new issue for the error, or link with an existing one:

Campfire

Campfire - Integrating Campfire With Raygun

Campfire is a team chat product that integrates with Raygun to send error group alerts to the Campfire room of your choice. Respond faster than ever to software issues using our Campfire integration.

Setup instructions

  1. In Raygun, in the application sidebar, click on Integrations, then Campfire:

  2. Click the Setup tab and insert your Campfire account name:

  3. Enter the "Auth Token" for your user account. You can find this by logging into your Campfire account, clicking "My Info" link in the header and then copying the value underneath "API authentication token". It will be a long string of random characters, paste that into the Auth Token box in Raygun.
  4. Enter your Room ID. You can get this from the URL for the room you want to use (note the number on the end of the URL - 123456 in this example):
    Campfire URL settings
  5. Tick the 'Enabled' checkbox to enable the plugin.
  6. You're done! Notifications will now be sent to your Campfire room as they occur in Raygun!

Flowdock

Flowdock - Integrating Flowdock With Raygun

Flowdock is a team chat product. When errors are reported into Raygun, notifications will be pushed to your Flows and/or Team Inbox.

Setup instructions

  1. In Raygun, in the application sidebar, click on Integrations, then Flowdock:

  1. Click the Setup tab, then click on the 'Flowdock account tokens' link in the FAQ on that Setup page:


    From here, look for the 'Flow API tokens' section.
  2. Copy one, and paste it into the API Token textbox in Raygun.
  3. Select one or both of the checkboxes to specify where error notifications are sent:
  • 'Send Chat Messages' will deliver them to your flow
  • 'Send Inbox Messages' will deliver them to your Team Inbox
  1. Click Save Changes, and you're done! Error notifications from that application will then be delivered to your flow/inbox.

FogBugz

FogBugz - Integrating FogBugz With Raygun

FogBugz is an issue tracker and project management tool. You can easily connect Raygun error groups to issues in FogBugz. You can even create new issues in FogBugz directly from an error group in Raygun. FogBugz + Raygun saves you time and gives you essential context on issues.

Setup Instructions

  1. In Raygun, in the application sidebar, click on Integrations, then FogBugz:

  2. Click the Setup tab, then enter the URL of your FogBugz tracker (including the 'http://') and your credentials:

  3. Hit 'Save', select the FogBugz project you want to use, then click 'Enabled' and save again.
  4. View an error group in Raygun Crash Reporting and you'll notice an 'Integrations' dropdown option. Click on 'Integrations' and pick FogBugz to create a new issue for the error, or link with an existing one:

GitHub

GitHub - Integrating Github With Raygun

GitHub is a source code hosting and issue tracking service. You can easily connect Raygun error groups to GitHub issues. This integration is even smart enough to resolve a bug in Raygun when you mark an issue as resolved in GitHub AND link stacktraces in Raygun error groups back to GitHub.

Setup Instructions

  1. In Raygun, on the application sidebar, click Integrations, then GitHub:

  1. Click the Setup tab, then click the blue 'Github' button which will open a new window at github.com:


    Enter your login credentials, and grant it permission when it asks. See below for details.
  2. Once it is finished, return to Integrations, then click on 'GitHub' and select a repository from the new drop down menu.
  3. Hit the 'Save' button, and you're done! 
  4. View an error group in Raygun Crash Reporting and you'll notice an 'Integrations' dropdown option. Click on 'Integrations' and pick GitHub to create a new issue for the error, or link with an existing one:

Notes

Getting a 404 error after granting it permissions? Go to your GitHub account settings, click on 'Profile', and make sure you have a 'Name' entered.

GitHub Enterprise

GitHub Enterprise - Integrating Github Enterprise With Raygun

GitHub is a source code hosting and issue tracking service. You can easily connect Raygun error groups to GitHub issues. This integration is even smart enough to resolve a bug in Raygun when you mark an issue as resolved in GitHub AND link stacktraces in Raygun error groups back to GitHub.

Setup Instructions

In order to register your Github Enterprise account with Raygun you must
first register your application through Github Enterprise by following the steps below:

1. First you must browse to your Github Enterprise installation in a browser.
This should be found at an address like http://your-domain-name/login.

2. Once you are logged in, go to your account settings as shown:

3. From here, go to OAuth applications:

4. Next go to the Developer applications tab.

If you have already registered other applications then they will show up here, otherwise your page should appear as shown.

 

5. Next click on Register new application.

6. Next you should be presented with the registration form.

Fill out this form with your own applications details.

Name, Homepage and Description are up to you, and will have no affect on how Raygun integrates with Github.

The important part of this form is the Callback URL, which must be set to: https://app.raygun.com/oauth/githubenterprise/callback, as this is the URL we use when authenticating your account with Raygun.

7. Once the form is complete, click Register application.

Your should be presented with the page for the new application you've registered.

This page contains the two very important values we need to set up your Github Enterprise integration, the Client ID and Client Secret.

8. The last value you will need is your own Github Enterprise installations URL, which is found in the first part of your browsers address:

This value should be similar to http://your-domain-name
e.g. http://192.168.13.159 or https://git.buisness.com

9. Once you have your Client ID, Client Secret and your Github Enterprise installations URL you can come back to Raygun and browse to https://app.raygun.com/

 

10. From here, click on Integrations then Github.

11. Next click on the Setup tab.

12. You can now click the Github Enterprise button.

13. At this point you will be presented with a form with exactly the same values you found previously.

14. Fill out this form with your Client ID, Client Secret and your Github Enterprise installations URL.

15. Once the form is complete, click the blue Github Enterprise button.

After doing so you should be redirected over to Github Enterprise and asked to login.

Note: if you are already logged in, this step will simply be skipped.

16. Next you should be asked to confirm your apps permissions.

Click the Authorize Application button to continue. 

17. After confirming these permissions you will be asked to log in and confirm this new identity back with Raygun.

18. After doing so, click Confirm and you should be taken back to the Raygun dashboard if authentication was successfull.

Your Github Enterprise integration is now complete!

If you wish to use this integration now then tick both Mark linked errors as resolved when closed in GitHub and Enabled.
Then click Save Changes.

To link an error group with a Github Enterprise issue browse to any error group within Raygun and click on Integrations.
Then choose Github from the drop down list.

From here you can create a new issue, or link with an issue already on your repository.

 

Notes:

  • If Github does not show up under the Integrations dropdown then it may not be enabled.
    Make sure to tick the Enabled checkbox in the integrations setup settings.
  • If you are left on a 404 (or any incorrect page) after authentication is complete, then your callback URL may be incorrect.
    Make sure that your application's callback URL matches that in step 6.
  • Make sure to include http:// or https:// at the start of your enterprise URL, as this is required.
  • If you are left on a Github 404 page right after being re-directed to Github then your client ID and/or secret may be incorrect. make sure these match the values you created back in step 7.

GitLab

GitLab - Integrating GitLab With Raygun

GitLab is a self-hosted source code hosting and issue tracking service. Create new issues in GitLab, or attach Raygun error groups to an existing GitLab issue, all directly from within Raygun.

Setup instructions

  1. Login to your GitLab account, jump into 'Profile Settings' then choose 'Account' from the tabs at the top.
  2. Copy your 'Private Token'
  3. In Raygun, on the application sidebar, click Integrations, then GitLab
  4. Click the Setup tab, paste your 'Private Token'
  5. Enter your GitLab url (there's a high chance this will be https://gitlab.com/)
  6. Press 'Save Changes'
  7. Pick a repository to use
  8. Click enabled
  9. Press 'Save Changes' again

GitLab is now ready to use!

HipChat

HipChat - Integrating Atlassian Hipchat With Raygun

HipChat is a team chat product that integrates with Raygun to send error group alerts to the HipChat room of your choice. Respond faster than ever to software issues using our HipChat integration.

Setup Instructions

  1. In Raygun, on the application sidebar, click Integrations, then HipChat:

  1. Click the Setup tab, then insert your HipChat API key. You can create a HipChat API key from the HipChat administration site here: https://www.hipchat.com/admin/api

  1. Insert the 'Room ID' you wish to have the Raygun notifications sent to. Note, this is not the name of the room but a numeric identfier. You can obtain the ID for your rooms from the HipChat administration view here: https://www.hipchat.com/rooms/ids
  2. Tick the 'Enabled' checkbox to enable the plugin.
  3. You're done! Notifications will now be sent to your HipChat room as they occur in Raygun!

JIRA

JIRA - Integrating JIRA With Raygun

This integration will allow you to link a Raygun error group to a new or existing JIRA issue. If you're hosting your own Jira instance, please use the JIRA OAuth integration.

On this page:

Setup Instructions

  1. In Raygun, on the application sidebar, click Integrations, then JIRA:

  1. Click the Setup tab, then enter your project URL, username and password. Your username should be what you access JIRA with, not your email address. Even if JIRA lets you log in with an email address, you can't access the API with it. Hit Save Changes when you're ready.

  1. Choose a project and task type for Raygun to use when communication with JIRA

  1. Click 'Save Changes', and you're done!

Create a webhook in Jira

By using a webhook, resolving issues in JIRA will also resolve the linked Raygun error groups. Here's how to create a webhook in Jira so you can get those error groups resolved in no time!

Setup instructions:

  1. Login to JIRA and ensure you are a project administrator
  2. Click to the cog icon next to your avatar
  3. Click on 'System'
  4. Click on 'WebHooks', located on the left sidebar under the 'Advanced' section
  5. Click on the 'Create a WebHook' button
  6. Give your webhook a name
  7. Set the status to 'Enabled'
  8. In the 'URL', copy and paste the 'JIRA Webhook URL' found in your Raygun Jira Setup tab
  9. For the 'Events' checkboxes, check the 'updated' checkbox under 'Issue'

  10. Click 'Save'

Learn more about JIRA webhooks

JIRA OAuth

JIRA OAuth

This integration will allow you to link a Raygun error group to a new or existing JIRA issue. Use this JIRA integration if you're hosting your own JIRA instance.

On this page:

Setup Instructions

Raygun allows you to connect your JIRA instance via OAuth which removes the requirement of entering a username and password into Raygun.

  1. In Raygun, on the application sidebar, click Integrations, then JIRA OAuth:

  1. Click the Setup tab, then setup your JIRA instance as per the onscreen instructions - there's a bit involved here. When you enter the link into JIRA, a popup with a warning message will appear in JIRA, similar to the one in the image below:



    Just click 'Continue' in JIRA and carry on with the onscreen setup instructions in Raygun. Enter your JIRA URL in the last step and press 'Go'. You'll be forwarded onto JIRA to authenticate your account.

  2. Choose a project and task type for Raygun to use when communication with JIRA:

  1. Make sure 'Enabled' is ticked
  2. Click 'Save Changes', and you're done!

Notes

  • You need an Application Link per Raygun Application setup in JIRA
  • You can't use the standard JIRA integration and JIRA OAuth integrations at the same time - the one you're not using will be disabled.

Create a webhook in JIRA

By using a webhook, resolving issues in JIRA will also resolve the linked Raygun error groups. Here's how to create a webhook in Jira so you can get those error groups resolved in no time!

Setup instructions:

  1. Login to JIRA and ensure you are a project administrator
  2. Click to the cog icon next to your avatar
  3. Click on 'System'
  4. Click on 'WebHooks', located on the left sidebar under the 'Advanced' section
  5. Click on the 'Create a WebHook' button
  6. Give your webhook a name
  7. Set the status to 'Enabled'
  8. In the 'URL', copy and paste the 'JIRA Webhook URL' found in your Raygun Jira Setup tab
  9. For the 'Events' checkboxes, check the 'updated' checkbox under 'Issue'

  10. Click 'Save'

Learn more about JIRA webhooks

Lighthouse

Lighthouse

Lighthouse is a collaborative issue tracker with a simple workflow for teams of any size. You can connect error groups in Raygun to existing Lighthouse tickets, or create new ones - all from within Raygun.

Setup instructions

  1. In Raygun, on the application sidebar, click Integrations, then Lighthouse:

  2. Click the Setup tab, then enter your Lighthouse URL. This will look something like: "https://example.lighthouseapp.com".

  3. Enter a Lighthouse API token and hit 'Save Changes'. To get an API token, log in to Lighthouse, navigate to your profile page and locate the API token section on the sidebar. Select the project(s) you wish to use from the drop down and click create, you can give the key a label if you wish. The key should appear in the "Your API Tokens" list. You can read the article on lighthouse about retrieving your api key here.
  4. Pick a project that you want to link tickets with, click 'Enabled' then 'Save Changes'. Done!
  5. View an error group in Raygun Crash Reporting and you'll notice an 'Integrations' dropdown option. Click on 'Integrations' and pick Lighthouse to create a new issue for the error, or link with an existing one:

Moxtra

Moxtra

Using Moxtra, teams can make faster decisions, communicate better and be more productive. Raygun collects the errors as they occur and posts them in a Moxtra binder so that you can discover and resolve bugs before they become a problem.

Setup instructions

  1. In Raygun, on the application sidebar, click Integrations, then Moxtra:

  1. Click on the Setup tab. Raygun authenticates with Moxtra via OAuth. Press 'Connect Raygun to Moxtra' and, if required, login to Moxtra.

  1. Allow Raygun access to Moxtra
  2. Choose a binder and tick 'Enabled'

  1. Press 'Save changes'. Done! Errors will now flow into your binder as chat messages.

Notifications

Raygun will send notifications to your Moxtra binder when the follow happens:

  • New error occured
  • Error reoccured after being resolved or ignored
  • Error still occuring 1, 5, 10, 30, 60 minute/s later
  • User has comment on a error
  • User has resolved/ignored an error

 

PagerDuty

PagerDuty - Integrating PagerDuty With Raygun

PagerDuty integrates with monitoring systems to intelligently route actionable incidents to the right team for real-time response. Errors received by Raygun can then raise monitoring alerts to catch any issues early.

Setup instructions

  1. In the application sidebar, click on Integrations, then PagerDuty:

  2. Click the Setup tab, then enter your Service integration key:


    To get the 'Service integration key', log in to PagerDuty, go to 'Configuration' and click on 'Services'. Choose the service or application that you want to connect to Raygun. Copy the 'IntegrationKey' and paste it in the 'Service integration key' above. 
  3. Click the 'Enabled' checkbox and hit 'Save changes'. Done!
  4. This integration will raise alerts to PagerDuty based on configured thresholds for new errors or reoccurring errors (e.g. an error which was previously ignored occurring again). You can specify the number of errors over a given time which will raise an alert in each case.

PivotalTracker

PivotalTracker - Integrating PivotalTracker With Raygun

PivotalTracker is a work item manager from the people at Pivotal Labs. Create work items, or link existing work items in PivotalTracker directly from within Raygun. It could not be easier!

Setup Instructions

  1. In Raygun, on the application sidebar, click Integrations, then PivotalTracker:

  1. Click the Setup tab, then paste in your API token.


    Your API token is available from your PivotalTracker, by clicking on your account name in the top-right corner then clicking Profile. Your API token is at the bottom.
  2. View an error group in Raygun Crash Reporting and you'll notice an 'Integrations' dropdown option. Click on 'Integrations' and pick PivotalTracker to create a new issue for the error, or link with an existing one:

Slack

Slack - Integrating Slack With Raygun

Slack is a cloud-based set of team collaboration tools and services that integrates with Raygun to send error group alerts to the Slack channel of your choice. Respond faster than ever to software issues using our Slack integration.

How to Setup and Upgrade your Slack integration:

Step 1. Head to your integrations tab: 

Step 2. Click on the Slack logo: 

Step 3. Click 'Setup', then 'Upgrade/Set up Slack':

Step 4: Select features

From here, you will get a success message. Click on the options you would like to include and 'Save changes'. After authorizing the channel, you will need to select and enable any features you wish to use. Don’t what interactive buttons added to your error messages? Simply disable the 'Interactive Messages' option. Slack is now all set up and will send notifications to the selected the channel:

Step 5: Register usernames

Other team members that wish to use the new features will need to head over to the integration and sign in with Slack by clicking the 'Sign in with Slack' button in the 'Plugins & Integrations' tab:

Raygun will then request access to your Slack channel. Clicking 'Authorize' will allow Raygun to send error notifications to your designated Slack channel:

 

Do you need help setting up the Slack integration or have a suggestion as to how we can make it easier? Get in touch with a friendly team member here. 

Notifications

Raygun will send notifications to your Slack channel when the follow happens

  • New error occured
  • Error reoccured after being resolved or ignored
  • Error still occuring 1, 5, 10, 30, 60 minute/s later
  • User comments on an error
  • User has resolved/ignored an error

Sprintly

Sprintly - Integrating Sprintly With Raygun

Sprintly is a project management and tracking product. Create new issues in Sprintly, or attach Raygun error groups to an existing Sprintly issue, all directly from within Raygun.

Setup instructions

  1. In Raygun, on the application sidebar, click Integrations, then Sprintly:

  2. Click on the Setup tab, then enter your Project Name (available at the end of your Sprintly URL, for example: https://sprint.ly/product/<your project name>/

  3. Type your email address you use with Sprintly, and paste in your API key. This is available from your Sprintly account profile
  4. Click 'Enabled' then 'Save Changes'
  5. View an error group in Raygun Crash Reporting and you'll notice an 'Integrations' dropdown option. Click on 'Integrations' and pick Sprintly to create a new issue for the error, or link with an existing one:

Targetprocess

Targetprocess - Integrating Targetprocess With Raygun

Targetprocess is a software tool to visualize and manage Agile projects with full support for Scrum, Kanban or a customized Agile method. Create new bugs on Targetprocess projects, or link error groups to existing Targetprocess bugs, all directly from within Raygun. Easy!

Setup instructions

  1. In Raygun, on the application sidebar, click 'Integrations', then 'Targetprocess':

  2. Click the 'Setup' tab, then enter your Targetprocess URL, login name and password



    To find your login, log in to Targetprocess, click your avatar, then click on 'My Profile'
  3. Click 'Save Changes'
  4. Choose the Targetprocess Project you want Raygun to connect with and then check the 'Enabled' checkbox.

  5. Click 'Save Changes' and you're done!
  6. You can now create a new Targetprocess bug from a Raygun error group, or link an existing Targetprocess bug with a Raygun error group.

Trello

Trello - Integrating Trello With Raygun

Trello is a product for creating Kanban style boards. Create new items on Trello boards, or attach error groups to an existing Trello item, all directly from within Raygun. When working with the item in Trello you can jump back and see all the details about the crash so you can fix it faster.

Setup Instructions

  1. In Raygun, on the application sidebar, click Integrations, then Trello:

  1. Click on the Setup tab, then click on the 'click here' link and sign in to Trello:


    From here, grant Raygun permission to access your boards.
  2. Choose the board you want your app to post to, then hit 'Save'.
  3. View an error group in Raygun Crash Reporting and you'll notice an 'Integrations' dropdown option. Click on 'Integrations' and pick Trello to create a new issue for the error, or link with an existing one:

Note

If you want to create a new Trello card automatically when a new error occurs, you can enable the 'Automatically create a card when a new error is seen' checkbox. However, you must also enable the 'Share Trello permissions with all team members' checkbox:

VictorOps

VictorOps - Integrating VictorOps With Raygun

VictorOps is a hub for centralizing the flow of information throughout the incident lifecycle. The VictorOps integration with Raygun sends alerts to VictorOps when the error frequency parameters you've specified occur.

Setup Instructions

In VictorOps

  1. Navigate to Integrations
  2. Select REST Endpoint from the sidebar.
  3. Click the Enable Integration button and copy the generated Post URL. Note: This is your API URL for VictorOps.

VictorOps Integration view diagram

 

In Raygun

  1. In the application sidebar, click on Integrations, then VictorOps:

  2. Click on the Setup tab, then paste your API URL into the URL field. Make sure you delete the $routing_key part from the end.


     
  3. Set a routing key - this can be anything you want. 
  4. Set parameters for the frequency of new errors and re-occuring errors you want to alert for.
  5. Click the 'Test' button to send a test error to VictorOps to make sure it's set up correctly. This should show up in your VictorOps timeline if successful.
  6. Once you're happy with the configuration, check 'Enabled'.
  7. Click the 'Save Changes' button, and you're done!

Raygun will now send alerts to VictorOps when the error frequency parameters you've specified occur.

Visual Studio Team Services

Integrating Visual Team Services With Raygun

Visual Studio Team Services is a web interface for TFS, Git and a project management tool from Microsoft. Create new work items in Visual Studio Team Services, or attach Raygun error groups to an existing Visual Studio Team Services work item, all directly from within Raygun.

Setup instructions

  1. In Raygun, on the application sidebar, click Integrations, then Visual Studio Team Services:

  1. Click on the Setup tab, then click the blue 'Visual Studio Team Services integration' button.


    Log in if needed, then grant Raygun access - we only use the ability to add Work Items and modify descriptions of existing ones.
  2. Provide your Raygun credentials again, then back at the plugins setup page select your VSTS account, then click next.
  3. Select the VSTS project you wish to link Raygun Crash Reporting errors to.
  4. View an error group in Raygun Crash Reporting and you'll notice an 'Integrations' dropdown option. Click on 'Integrations' and pick Visual Studio Team Services to create a new issue for the error, or link with an existing one:

  5. Once an error is linked in Raygun Crash Reporting to a Visual Studio Team Services issue, you’ll be able to view it in the sidebar of your Visual Studio Team Services account. Clicking the error link will take you straight back to the issue in your Raygun Crash Reporting account.

YouTrack

YouTrack - Integrating YouTrack With Raygun

YouTrack is a commercial browser-based bug tracker, issue tracking system and project management product developed by the good people at JetBrains. Create new issues in YouTrack, or attach Raygun error groups to an existing YouTrack issue, all directly from within Raygun.

Setup Instructions

  1. In Raygun, on the application sidebar, click on Integrations, then YouTrack:

  2. Click on the Setup tab, then enter your YouTrack URL and credentials:

    Hit 'Save Changes' and enter your project name. Click 'Enabled', then click 'Save Changes' again.
  3. View an error group in Raygun Crash Reporting and you'll notice an 'Integrations' dropdown option. Click on 'Integrations' and pick YouTrack to create a new issue for the error, or link with an existing one:

Zendesk

Zendesk - Integrating Zendesk With Raygun

Zendesk builds software to help companies improve customer relationships through higher customer engagement and better customer insights. Create new issues in Zendesk, or attach Raygun error groups to an existing Zendesk issue, all directly from within Raygun.

Getting setup

In Zendesk

  1. Head over to the admin panel choose API under Channels.

  2. Enable Token Access if it's not already.
  3. Click 'add new token'.
  4. Provide a label - we suggest Raygun so you know what the token is for.
  5. Copy the token that was just generated for you.

 

In Raygun

  1. On the application sidebar, click Integrations, then Zendesk:

  1. Click on the Setup tab, then enter your subdomain, the email address you use to login to Zendesk and paste the token you got from Zendesk:

  1. Press 'Test Settings' to make sure Raygun can talk to Zendesk properly.
  2. Assuming the test worked, hit Save Changes.
  3. Tick the Enabled box and press Save Changes when you're ready to enable the plugin properly.

Documentation missing?

If we don't have documentation about your desired topic, send us a message and we'll create it for you.