アプリケーション トンネルのトラブルシューティング

アプリケーション トンネルのトラブルシューティング情報をいくつか示します。

オンプレミス インスタンスで追加のログ作成を有効にする

このページで解決策が見つからない場合は、com.atlassian.tunnel のログ レベルを TRACE に設定して、次のキー クラスの参照を探します。

  • TunnelConnectionService

  • InletsClientManager

  • TunnelClientProcessStateManager

  • InletsClientProcessFactory

各種製品のログ作成を有効にする方法の詳細については、次のトピックをご参照ください。

アプリケーション トンネルの接続を確認する

admin.atlassian.com で、アプリケーション トンネルの接続を確認できます。これは、トンネルが正しく機能していることを確認するためにトンネルに対して実行する一連のヘルス チェックです。問題がある場合は、適切なステータスが表示されます。

接続を確認するには、次の手順を実行します。

  1. admin.atlassian.com に移動します。

  2. [設定] > [アプリケーション トンネル] の順に選択します。

  3. 右上の [接続を確認] を選択します。

ステータスで示される一般的な問題を次に示します。一部のステータスは Cloud と Data Center で異なることに注意してください。

クラウドのステータス

ステータス

説明

未完了

admin.atlassian.com でトンネルが作成されましたが、そのセキュリティ キーがオンプレミス インスタンスに追加されていません。

この問題の解決方法

  1. admin.atlassian.com でトンネルを編集し、セキュリティキーをコピーします。

  2. キーをオンプレミス インスタンスに追加します。

利用不可

現在、トンネルは使用できません。この原因して考えられる問題は以下のとおりです。

  • Cloud のアプリケーション トンネルが一時的にダウンしていて、オンプレミス インスタンスがまだ再接続されていません。インスタンスがまだ接続を試みている可能性があるため、ステータスが変わるまで待機してください。

  • オンプレミス インスタンスのセキュリティ キーが間違っているか、無効になっています。キーが正しいことを確認するか、新しいキーを生成してください。

  • オンプレミス インスタンスがダウンしています。

設定ミス

トンネルに設定ミスがあります。これは通常、オンプレミス インスタンスで必要な接続とアップストリーム ポートを設定せずにトンネルを作成した場合に発生します。

この問題の解決方法

  • オンプレミス インスタンスでトンネルを設定します。アプリケーション トンネルの設定方法についてはこちらをご確認ください。

エラー

トンネルが機能していませんが、正確な原因を特定することはできません。これは通常、オンプレミス インスタンスの問題が原因であるため、次の対応を試してください。

  • オンプレミス インスタンスの状態を確認します。

  • オンプレミス インスタンスのログ ファイルを確認します。

  • セキュリティ キーを再生成して、オンプレミス インスタンスで更新します。

  • トンネルを再作成します。

タイムアウト

ステータスを確認しようとしましたが、トンネルから応答がありませんでした。

この問題の解決方法

  • オンプレミス インスタンスの負荷が高くなっている可能性があり、このチェックを実行できません。このインスタンスの負荷を軽減して、正常な状態に戻してください。

  • ネットワークの問題により、チェックがタイムアウトになっている可能性があります。オンプレミス インスタンスのネットワーク接続状態を確認してください。

オンプレミス インスタンスのステータス

ステータス

説明

利用不可

オンプレミス インスタンスで Cloud のトンネル サーバーに対して認証できません。

この問題の解決方法

  1. セキュリティ キーを再生成し、最新の状態であることを確認します。

  2. 新しいセキュリティ キーをオンプレミス インスタンスに追加します。

制限

一部の Data Center ノードがトンネルに接続されていません。接続パフォーマンスが低下しています。

この問題の解決方法

  1. [管理] > [クラスタリング] に移動します。

  2. Data Center ノードのステータスをチェックし、稼働していることを確認してください。

エラー

Cloud のアプリケーション トンネルが再起動中か、機能していません。

この問題の解決方法

  1. しばらく待機してステータスが変わるかどうかを確認します。これは、当社側の他の問題による一時的な再起動の可能性があります。

  2. Data Center ログ ファイルを確認して原因を特定します。

  3. これらの解決策で問題が解決されない場合は、トンネルを再作成します。

接続中 (長期間)

少なくとも 1 つのノードがトンネルに接続されていません。次の解決策をお試しいただけます。

  • オンプレミス インスタンスで [管理] > [クラスタリング] の順に移動してノードのステータスをチェックし、ノードが稼働中であることをご確認ください。

  • ログ作成を有効にして詳細を入手する

接続済み (アプリケーション リンクの作成後に応答なし)

次のアクションをお試しください。

  • アプリケーション リンクに正しいアプリケーション トンネルを使用していることをご確認ください

  • HTTP コネクターとアップストリーム ポートの追加を含む、必要な設定ステップを完了していることを確認します。アプリケーション トンネルの設定方法についてはこちらをご確認ください。

  • オンプレミス インスタンスのベース URL が正しいことをご確認ください。

その他の問題

ステータス

説明

アプリケーション リンクに両方のインスタンスの設定エラーが表示される

この問題は、オンプレミス インスタンスの相互リンクが別の管理者によって作成された場合に多く発生します。このような場合、Cloud 製品のアプリケーション リンクは、ローカル認証を無効にして作成されている可能性がありますが、ここでは OAuth を設定する必要があります。

これを修正するには:

  1. Cloud 製品でアプリケーション リンクを編集します。

  2. 送信通信および受信通信の両方のローカル認証を [OAuth] に設定します。

両方向で [ローカル認証] が [OAuth] に設定されているアプリケーション リンクの詳細。

その他のヘルプ