mabl リンクを使用すると、mablクラウドとプライベート環境の間にセキュアな接続を確立できます。リンクエージェントが正しく設定されていない場合、テストがローカルでは成功するのにクラウドでは失敗するといった問題が発生することがあります。また、テスト実行中に「ERR_TUNNEL_CONNECTION_FAILED」や「Unable to find active mabl link tunnel」などのエラーメッセージが表示される場合もあります。
この記事では、mablリンクエージェントの起動および実行に関する課題のトラブルシューティングと切り分けのステップを紹介します。まず、発生している課題を選択してください。
Link Agentの起動
リンクエージェントを起動できない場合、以下のいずれかの原因が考えられます。
起動コマンドが無効
Link Agentの起動コマンドに適切なAPIキーと有効な名前が使用されていることを確認します。
- APIキーは「リンクエージェント」用のAPIキーである必要があります
- 名前は小文字、数字、ダッシュで構成された1〜24文字である必要があります。大文字やアンダースコアなどのサポートされていない文字が名前に含まれている場合、リンクエージェントは起動できません。
ディレクトリが正しくない
Bad command or file name (コマンドまたはファイル名が違います) というメッセージが表示される場合は、起動コマンドを実行するときにlink-agent/binディレクトリにいることを確認します。
Javaバージョンがサポートされていない
リンクエージェントの起動時にunrecognized option: --add-opensというエラーが表示される場合、サポートされていないJavaバージョンを使用しています。リンクエージェントがサポートするJavaバージョンにアップグレードするか、DockerリンクエージェントコンテナIを使用してください。
mablに接続
リンクエージェントのホストは、ポート443を介してapi.mabl.comおよび*.link.mabl.comに接続できる必要があります。
リンクエージェントを開始すると、mablアプリのネットワークページ（ワークスペース > ネットワーク）に「Connected」ステータスのリンクエージェントが表示されます。
-
リンクエージェントテーブルにエージェントが表示されない場合、リンクエージェントは
api.mabl.comに接続できていません。 -
リンクエージェントテーブルにエージェントが表示されているにもかかわらず、ステータスが「Connected」でない場合、リンクエージェントは
api.mabl.comには接続できていますが、*.link.mabl.comには接続できていません。この場合、ネットワークチームに確認して、社内ネットワークがアウトバウンドトラフィックに制限を適用していないかどうかを確認してください。リンクエージェントに転送プロキシを適用する必要がある場合があります。
接続テスト
接続をテストするには、リンクエージェントが実行中のマシンにSSHまたはログインし、curlまたは別のツールを使用して、次のエンドポイントへの接続をテストしてください：api.mabl.comおよび*.link.mabl.com。
チームとフォローアップする
api.mabl.comおよび/または*.link.mabl.comに接続できない場合は、なぜこれが起こっているのかを理解するために、ネットワークチームに相談してください。
- 会社のネットワークでフォワードプロキシを使用している場合は、Link Agentの起動コマンドに適切なフォワードプロキシオプションを追加する必要があります。
- 会社のファイアウォールが送信トラフィックをブロックする設定になっている場合は、mabl Linkトラフィックがmablクラウドに接続できるように、
*.link.mabl.comとapi.mabl.comを許可リストに追加するようネットワークチームに依頼してください。 - 会社のネットワークでポート443に対する送信接続がブロックされている場合は、Link Agent用にブロックの適用解除が可能かどうかをネットワークチームに確認してください。
テスト対象アプリケーションへの接続
mabl Link経由で実行するようにテストを設定しているにもかかわらず、テストがテスト対象アプリケーションに接続できない場合や、テスト対象アプリケーションとの接続が切れる場合は、次のチェックリストを使って、考えられる原因を特定してください。
環境の設定が適切であることを確認する
テストを実行している環境がmabl リンクを使用するように設定されていることを確認してください。環境に選択されているリンクエージェントは、ワークスペース内のアクティブなリンクエージェントのいずれかと一致している必要があります。
mabl Linkを使用するように設定された環境
Link Agentのステータスを確認する
Link Agentが [ネットワーク] ページでアクティブになっていることを確認します ([ワークスペース] > [ネットワーク])。
Link Agentのログを確認する
リンクエージェントがアクティブでない場合、またはテスト実行中にアクティブでなかった場合は、チームのリンクエージェントを管理している担当者を見つけ、リンクエージェントのログのコピーを依頼してください。リンクエージェントのログは、リンクエージェントが切断された理由を特定するのに役立ちます。ログはリンクエージェントがインストールされたマシンの次の場所にあります：logs/agent.log。
チームのリンクエージェントを管理している担当者に連絡する際は、次の情報を提供してください。
- エージェント名
- 失敗した実行の時間帯
- エージェントホストから取得した最新の
agent.log。
Link Agentのシャットダウンが起きる原因には、次のようなものがあります。
- テストが実行されるようにスケジュールされていたときにLink Agentホストが再起動された。
- 非アクティブな状態が続いたためにLink Agentホストがログアウトし、Link Agentプロセスがシャットダウンされた。
- リンクエージェントのテストトラフィックの量が多すぎます。これをテストするには、プラン実行中に同時実行数を減らすことで、成功率が向上するかどうかを確認してください。必要に応じて、同じ名前のリンクエージェントインスタンスを複数作成し、ロードバランサーとして機能させることができます。詳細については、リンクエージェント要件の記事の高可用性構成に関するセクションを参照してください。
中断を最小限に抑えるため、できるだけ中断の少ないマシンまたはVMでLink Agentを実行します。詳細については、Link Agentの要件に関する記事を参照してください。
リンクエージェントのホストがあなたのアプリにアクセスできることを確認してください
テストがmabl Linkを介して実行されると、DNS解決はLink Agentをホストしているマシンで行われます。リンクエージェントのホストがテスト対象のアプリケーションにアクセスできる限り、mablクラウドで実行中のテストは環境に接続できます。
リンクエージェントホストがアプリにアクセスできるかどうかを確認するには、エージェントが実行中のマシンにログインし、 curlまたは同様のツールを使用してアプリケーションへの接続を確認してください。curlの呼び出しが失敗する場合、リンクエージェントホストに対してネットワークが適切に設定されていません。
または、リンクエージェントホストにアクセスできない場合は、mabl APIテストを作成してアプリケーションへの接続をテストしてください。リンクが有効な環境でクラウド上で実行し、テスト出力ログのエラーを確認して詳細情報を取得してください。