9 November 2015

We've deprecated this Diagnostics Plugin guide, because the Diagnostics Plugin has been removed from the Atlassian Marketplace and is no longer being actively developed.

But there's good news! We've released a whole better diagnostics experience for application links. You get the new application links diagnostics with the recent version of Atlassian products.

Some teasers...

Built-in

The new diagnostics experience is built in to the Application Links plugin, so is available right out of the box.
You don't have to install or maintain a separate plugin.

Full product support

The new diagnostics experience supports all Atlassian products that use application links, including Jira 7 and Bamboo
(neither of which are supported by the old Diagnostics Plugin).

If you're having trouble with application links, see our Application Links troubleshooting guide.

 

 

Overview

This test verifies that the diagnostic tool is able to resolve the link to the manifest on the application that is running the diagnostic tasks. This manifest is used to generate application links between different apps.

If this URL cannot be resolved, the application link will fail. It often fails to resolve due to a misconfigured proxy or network.

Understanding the Results

IconText resultWhat this means
SUCCESSThe test was successful.
WARNINGSome of the component tests failed and needs troubleshooting.
FAILThe test was not successful and needs troubleshooting.

Troubleshooting

Manifest Test

  • URL path tested: <URL>/rest/applinks/1.0/manifest
Error(s)Steps to Resolve
  • Manifest URL is invalid
  • Is the URL valid?
  • Can you access the URL with a browser?
  • Can you access that URL through a browser?
  • Is there anything between the applications, for example proxy / firewall and/or load-balancer? If so, verify the configuration is correct.
  • Disabling the proxy and/or SSO can effectively isolate whether or not it is at fault.
  • It may be that the manifest was located however the JSON is malformed. This may be caused by compression on both a proxy and the application.

Basic Checks

Error(s)Steps to Resolve
  • Application Link is NULL
  • The Application Link has been corrupted, please recreate it.
  • Application URL is NULL
  • This means the application URL is empty. Try to edit the link and see if this can be fixed.
  • This shouldn't happen, the Application Link will probably need to be recreated.

HTTP Connectivity

  • URL path tested: <URL>/rest/applinks/1.0/applicationlink
  • Valid HTTP success codes: 200, 401
Error(s)Steps to Resolve
  • Invalid URI
  • Is the URL valid?
  • Is the display URL same as the base URL configured in the target application?
  • Can you connect to the target application URL from the server running the diagnostics?
  • Unknown Host
  • java.net.ConnectException: Connection refused
  • Is the server running the target application reachable?

  • Check if you can ping the target server from the server that is running the AppLinks diagnostics plugin.

  • For example, when trying to verify if Confluence can access JIRA, execute the following on the Confluence server:

    ping jira.atlassian.com

    (info) Replace jira.atlassian.com with the display URL of the target instance.

  • Redirect count from <URL> exceeded maximum of <maximum>.
  • Received HTTP <status code> redirect...
  • Got HTTP <status code> redirect from <URL> but no redirect location was specified.
  • Failed to ping <Application>.
  • Received unexpected HTTP <status code> response from <URL> using...
  • Is the target application accessible at the display/application URL?
  • Try connecting to the application using the display URL and verify if the application is available and you are able to log in.

Providing Information to Support

Atlassian applications allow the use of reverse-proxies within our products, however Atlassian Support does not provide assistance for configuring them. Consequently, Atlassian can not guarantee providing any support for them.

If assistance with configuration is required, please raise a question on Atlassian Community.

In case you are unable to troubleshoot and fix the problem by yourself, please create a support ticket at support.atlassian.com and attach the following information to the ticket:

  1. Copy and save the contents of the 'Diagnostics' tab as a text file.

  2. Screenshots of the Application Links configuration.

  3. A Support ZIP.

Unknown macro: {dynamiccontentbylabel}

 




 

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.