Integration with AirBrake
Overview
IT teams such as Information Security, Site Reliability, and NOC must always have access to critical system alerts. The MangoApps integration ecosystem provides out-of-the-box capabilities to integrate with Airbrake, which can be configured to capture errors and exceptions from various systems and notify them in MangoApps.
When an error occurs in your application, Airbrake can automatically create a new issue or notification in MangoApps, alerting the relevant team members. This centralizes communication around critical alerts, enhancing collaboration across teams. As a result, teams can work together more effectively to diagnose, prioritize, and promptly resolve issues. Supported Airbrake plans are Basic, Pro, and Dev.
Role Prerequisites
To enable and configure the Airbrake integration in MangoApps, several roles need to be involved. MangoApps Domain Administrators are required to enable the integration in the admin portal. MangoApps Team Administrators configure the integration within specific teams. An Airbrake Administrator is needed to configure the Webhook in Airbrake and set up the metrics to be monitored in MangoApps.
Setup in MangoApps
For MangoApps Domain Administrator
In the admin portal, navigate to the Integrations configuration menu and enable Airbrake by toggling the switch to ON. This allows team admins to add it to their workspaces and will populate the Airbrake widget in the Widget Library.
Set up the Airbrake widget on the Home module by adding it from the gallery. Configure the widget by specifying the user segment.
The MangoApps admin can set up the Airbrake widget for Home and make it conditional so that only the selected user segment can view this widget on their home and follow their SOP within the dedicated teams.
For MangoApps Team Administrator
Navigate to the desired team on your MangoApps domain where the integration needs to be enabled. From the team, click on Admin Tools > Configure Integrations > Airbrake.
Setup in Airbrake
With the Webhook URL copied, navigate to the Integrations tab within Airbrake. Paste the Webhook URL copied from MangoApps into the Webhook Integration URL field.
Once the connection has been successfully tested, the Airbrake Administrator can configure the metrics in Airbrake. These metrics will then be sent as team notifications to your MangoApps domain.
Congratualtions, you have completed the integration!
End User Experience
Once the Airbrake configuration is completed and the URL monitoring receives a host down alert, it will generate a news feed in MangoApps.
For best practice, we recommend critical alerts related to system and infrastructure to be directed to your IT, DevOps, or SRE teams.
Testing Considerations
After adding the MangoApps webhook URL in Airbrake, click on Test Integration to ensure the setup is functioning properly.
Security Considerations
Airbrake captures key system and infrastructure-related information, which should only be shared with the right user segments and permission levels. System information like configuration and stack trace should not be shared outside the teams where the integration is set.
Rollout Recommendations
Identify the workspace in MangoApps where this integration needs to be implemented. Communicate with the team members, letting them know about this and assign ownership of who is responsible for which alerts (if it happens to be a team with multiple SMEs). Teams' admin should complete the configuration as per the business requirements.
Last updated
