Aha! Roadmaps | How to diagnose development tool integration log messages
The integration between Aha! Roadmaps and your development tool manages a massive amount of details and realtime updates. Most of the time, it keeps everything in sync between the two tools perfectly. If you run into trouble, your first step should be to check the integration log messages.
In this article, we will walk through common log messages you might see, with brief explanations and recommended actions for you to take.
Click any of the following links to skip ahead:
Access integration logs
You can view integration logs in three places:
Settings ⚙️ Integration updates for all integration updates in your Aha! Roadmaps account.
Settings ⚙️ Account Integrations for account-level integrations.
Settings ⚙️ Workspace Integrations for workspace-level integrations.
Since development tools are workspace-level integrations, head to Settings ⚙️ Workspace Integrations and click on the integration whose logs you want to access. Then click View log messages at the bottom of the page.
Log messages come in three 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 display a record of integration activity, such as receiving a webhook.
In the following sections, we will discuss example messages you might see in your logs for each of these types.
Skip creating candidate for XXXX as feature due to service restriction
The record has been created in your Aha! account, and therefore will not be imported from your development tool.
If you wanted to import the record from your development tool, search for the record in your Aha! account to make sure it does not already exist there. If it does not, you can create a record in Aha! and use the Link to existing option to connect it to that development tool record.
Skip creating candidate for XXXX due to parent being in other product
Requirements in Aha! Roadmaps cannot be imported as standalone records. They need to be linked to a parent feature.
When a requirement comes in from a development tool, the integration checks to see if the parent feature exists. In this case, the feature exists in another Aha! Roadmaps workspace linked to another development tool integration.
Since requirements have to exist in the same Aha! Roadmaps workspace as their parent feature, the integration has skipped creating the requirement in this workspace.
Skipping update updated XXXX YYYY [aggregate_timeestimate, aggregate_work_done, aggregate_timeoriginalestimate, progress_children, display_short, display_summary, display_display, display_link], used by another integration
The development tool record you are trying to update is already integrated with Aha! Roadmaps through another active integration configuration.
Since that other integration is responsible for updating this record, no changes have been made through your current integration update.
Applying inverse update to [Record type] [Mapped fields]
When you map fields between Aha! Roadmaps and a development tool, you can choose one of several mapping directions. If you import records from a development tool into Aha! Roadmaps, Aha! Roadmaps will then send to the development tool any fields that have a One way (set once) mapping direction from Aha! Roadmaps to a development tool.
The purpose of the
Received change updated XXXX YYYY [status, customfield_#####, display_short, display_summary, display_display, display_link] but found no mappings
Updates were made in the development tool to a record that is linked to an Aha! Roadmaps record. But since the development tool fields that were updated are not mapped to any Aha! Roadmaps field, no changes were made to the linked Aha! Roadmaps record.
[Record] cannot be imported as a requirement because there is no valid relationship link to an Aha! feature
Requirements in Aha! Roadmaps cannot be imported as standalone records. They need to be linked to a parent feature. When you link Aha! and development tool types together, you need to include a parent link between the analog to Aha! requirements and the analog to Aha! features.
No valid transition to status ### for issue XXXX
Workflows in your development tool often need transitions between workflow statuses.
This error occurs when an integration is attempting to move a record in your development tool into a status that would require skipping a step in the workflow.