Troubleshoot application tunnels
Who can do this? |
Here’s some troubleshooting information for application tunnels.
Enable extra logging in your Data Center instance
If you can’t find the solution on this page, set the log level for the com.atlassian.tunnel
to TRACE
and look for references for the key classes:
TunnelConnectionService
InletsClientManager
TunnelClientProcessStateManager
InletsClientProcessFactory
For more info on how to enable logging for different Data Center products, see:
Jira: Logging and profiling
Confluence: Configure logging
Bitbucket: Enable debug logging
Bamboo: Logging in Bamboo
Check connections of application tunnels
In admin.atlassian.com, you can check the connection of application tunnels. It’s a set of health checks that we run against the tunnels to make sure they’re working correctly. If there’s a problem, an appropriate status will be displayed.
To check the connections:
Go to admin.atlassian.com.
Select Settings > Application tunnels.
In the top-right, select Check connections.
Common problems related to statuses
Here are some common problems indicated by the statuses. Note that some statuses are different between Cloud and Data Center.
Status in cloud
Status | Description |
---|---|
Incomplete | The tunnel has been created in admin.atlassian.com, but its security key hasn’t beed added to your Data Center instance. To solve this issue:
|
Unavailable | The tunnel is unavailable right now. There are a few issues that might cause this:
|
Misconfigured | The tunnel is misconfigured. This usually happens when you create a tunnel without configuring the required connections and upstream ports in your Data Center instance. To solve this issue:
|
Error | The tunnel isn’t working, but we’re unable to determine an exact cause. This is usually caused by problems with your Data Center instance, so try the following actions:
|
Timed out | We tried checking the status, but didn’t get any response from the tunnel. To solve this issue:
|
Status in your Data Center instance
Status | Description |
---|---|
Unavailable | Your Data Center instance can’t authenticate to the tunnel server in Cloud. To solve this issue:
|
Limited | Some Data Center nodes aren’t connected to the tunnel. The connection performance is degraded. To solve this issue:
|
Error | Application tunnels in Cloud are either being restarted or not working. To solve this issue:
|
Connecting (for a long period of time) | At least one of the nodes hasn’t connected to the tunnel. You can try the following solutions:
|
Connected (and no response after creating application links) | Try the following actions:
|
Other problems
Status | Description |
---|---|
Application links show Config error on both instances | This issue often appears when the reciprocal link on the Data Center instance is created by a different admin. In such a case, the application link in your cloud app might be created with the local authentication disabled, while it should be set to OAuth. To fix this:
|
Was this helpful?