Mantis Bug Tracker Integration

Integrate TestMonitor with Mantis Bug Tracker!

Mantis Bug Tracker is a free, open-source, web-based bug tracking system. It is often used to track software defects, but is also used as a generic issue tracking system and project management tool.

Functionality overview

Mantis integration lets you create bugs from TestMonitor issues. Each bug contains the TestMonitor issue name, description, status, impact, category, impact, and assignee. Bugs also include attachments. 

When TestMonitor sends an issue to Mantis, a link to the bug is included. That link lets you check issue progress. 

Setup requirements

  • You must have a TestMonitor administrator account.
  • You must have a Mantis account (with permissions to create bugs).

Installation and configuration

Obtaining the Mantis credentials

Before you can run the integration, you need a Mantis API key. Create an API key in your Mantis user profile settings.

Configuring the integration

Once you have the Mantis credentials, start the TestMonitor integration set up. There are two Mantis integration options.

From the TestMonitor dashboard header:

  • In the top right corner of the dashboard, click the project selector next to the bell.

  • Select a project on the drop-down menu.

  • Click the project selector again and then click Project settings.

  • On the project Details page, click Integrations on the left menu.

  • Click the Connect button on the Mantis panel.

From the TestMonitor Settings page:

  • Click the Cog in the header. The Settings page displays.

  • On the left menu, click Projects.

  • Click the project you want to connect to Mantis. 

  • On the project Details page, click Integrations on the left menu.

  • Click the Connect button on the Mantis panel.

integrations

 
When you click the Connect button, the Mantis configuration displays. Fill in the following fields:
  • URL: The web address to your Mantis instance (e.g. https://mantis.company.com).
  • Token: Your Mantis API token.
  • Project: The name of the Mantis project that you want to connect to.
  • Automatic / manual: Automatic sends every issue to Mantis. Manual allows you to pick issues individually. 

connect-mantis

 
Click Save. When successful, the Mantis panel refers to your Mantis instance as connected.

Using the integration

If you choose automatic, TestMonitor sends all new issues to Mantis. You can view them in the Mantis bug overview. Each bug contains the TestMonitor issue name, description, status, impact, category, impact, assignee, and attachments. 
If you choose manual, you must go to the Details page of an issue and then click Send to Mantis button. The issue is now in the Mantis bug overview. 

issue-to-mantis

 

When TestMonitor sends an issue to Mantis, the Mantis bug description contains a link to the issue in TestMonitor.

To view the issue in Mantis, go to the Issue Details page in TestMonitor and then select Open in Mantis.


Uninstalling the integration

There are two ways to uninstall Mantis integration.

From the TestMonitor dashboard header:

  • In the top right corner of the dashboard, click the project selector next to the bell.

  • On the drop-down menu, select the project with the integration.

  • Click the project selector again and then click Project settings.

  • On the project Details page, click Integrations on the left menu.

  • Click the Disconnect button on the Mantis panel and then Delete to confirm.

From the TestMonitor Settings page:

  • Click the Cog in the header. The Settings page displays.

  • On the left menu, click Projects.

  • Click the project with the integration you want to disconnect. 

  • On the project Details page, click Integrations on the left menu.

  • Click the Disconnect button on the Mantis panel and then Delete to confirm.

disconnect-mantis

When uninstalling the integration, links between the TestMonitor issues and Mantis bugs are removed as well. This cannot be undone.

Frequently asked questions

When I update the Mantis bug status, is the TestMonitor issue status updated as well?

Right now, TestMonitor doesn’t poll Mantis for any changes. This avoids status conflicts between the two systems. We’re planning to upgrade integrations to a 2-way setup in the future.
 

I am unable to connect to my Mantis installation. What should I do?

If you are unable to connect to Mantis please check the following:
  • Is your URL similar to https://mantis.company.com?
  • Did you generate and use a Mantis API token?
  • Did you set up a project in Mantis to connect with?

Can I set up different Mantis instances for each project?

Yes, you can use a different Mantis environment or project for each TestMonitor project.