Aha! Roadmaps provides integrations with a number of external systems, including Jira, Rally, Azure DevOps, Slack, and many more. When something is not behaving as expected with an integration, your first step for correcting the issue is to view the integration logs. To help you troubleshoot and maintain your integrations, Aha! Roadmaps provides a tool for monitoring integration log messages.
The log messages can be used to verify that the expected communication is occurring between Aha! Roadmaps and the integrated system. They are also used for troubleshooting issues.
Click any of the following links to skip ahead:
View integration log messages
You can view integration logs in four places:
User menu -> Settings → Integration updates for all integration updates in your Aha! Roadmaps account.
User menu -> Settings → Account → Integrations for account-level integrations.
User menu -> Settings → Workspace → Integrations for workspace-level integrations.
Users → SSO in your ideas portal settings for portal single sign-on (SSO) integrations.
Log message types
Red | Error: Red error logs indicate that something in the integration failed. They are often preceded by an amber warning that offers a more technical description of the issue, which can be helpful for understanding the reason for the failure. For example, a red error log may be logged if you do not allow list the Aha! Roadmaps IP addresses and Aha! Roadmaps cannot contact your server.
Amber | Warning: Amber warning logs indicate something happened that may be unexpected but is not necessarily a problem. Warnings can provide reasons for an error or offer additional background to help you troubleshoot an issue.
Blue | Information: Info logs indicate that something interesting happened. For example, this might include something like, "Received a webhook."
Configure integration alerts
For the Jira, Azure DevOps (ADO), and Salesforce integrations, you can configure integration alerts to automatically notify your team by email when errors occur. Integration alerts let you choose which error categories trigger notifications and who receives them.
Navigate to User menu -> Settings → Workspace → Integrations, select your integration, and open the Enable step to find the Integration alerts section.
Resolve integration errors
Most errors are caused by problems with the integration configuration and can be resolved by changing the integration settings. When you understand the error logs, you can search for solutions on our knowledge base.
If you get stuck, please reach out to our Customer Success team. Our team is made up entirely of product experts and responds fast.