Link Agentを起動できない場合や、mabl Link経由でのテストの実行に問題がある場合は、この記事の手順を利用して、問題のトラブルシューティングと特定を行うことができます。
最初に、発生している問題を選択してください。
Link Agentの起動
Link Agentを起動できない場合、次のいずれかの原因が考えられます。
起動コマンドが無効
Link Agentの起動コマンドに適切なAPIキーと有効な名前が使用されていることを確認します。
- APIキーは "Link Agent" APIキーである必要があります
- 名前は、英小文字、数字、ダッシュから成る1~24文字である必要があります
ディレクトリが正しくない
Bad command or file name
(コマンドまたはファイル名が違います) というメッセージが表示される場合は、起動コマンドを実行するときにlink-agent/bin
ディレクトリにいることを確認します。
Javaバージョンがサポートされていない
Link Agentの起動時にunrecognized option: --add-opens
というエラーが表示される場合は、実行中のJavaバージョンがサポートされていないバージョンです。Link AgentでサポートされているJavaバージョンにアップグレードするか、Docker Link Agentコンテナーを使用します。
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
に接続できない場合は、なぜこれが起こっているのかを理解するために、ネットワークチームに相談してください。
- 会社のファイアウォールが送信トラフィックをブロックする設定になっている場合は、mabl Linkトラフィックがmablクラウドに接続できるように、
*.link.mabl.com
とapi.mabl.com
を許可リストに追加するようネットワークチームに依頼してください。 - 会社のネットワークでポート443に対する送信接続がブロックされている場合は、Link Agent用にブロックの適用解除が可能かどうかをネットワークチームに確認してください。
- 会社のネットワークでフォワードプロキシを使用している場合は、Link Agentの起動コマンドに適切なフォワードプロキシオプションを追加する必要があります。
テスト対象アプリケーションへの接続
mabl Link経由で実行するようにテストを設定しているにもかかわらず、テストがテスト対象アプリケーションに接続できない場合や、テスト対象アプリケーションとの接続が切れる場合は、次のチェックリストを使って、考えられる原因を特定してください。
環境の設定が適切であることを確認する
テストを実行する環境がmabl Linkを使用するように設定されていることを確認します。環境用に選択したLink Agentは、ワークスペース内のアクティブなLink Agentの1つと一致している必要があります。
mabl Linkを使用するように設定された環境
Link Agentのステータスを確認する
Link Agentが [ネットワーク] ページでアクティブになっていることを確認します ([ワークスペース] > [ネットワーク])。
Link Agentのログを確認する
Link Agentがアクティブでないか、テストの実行時にアクティブでなかった場合は、Link Agentの管理担当者から、Link Agentのログのコピーを入手します。Link Agentのログは、Link Agentが切断状態になった理由を特定するのに役立ちます。Link Agentのログは、Link Agentがインストールされているマシンの次の場所にあります: logs/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テストを作成してアプリケーションへの接続をテストしてください。リンク対応の環境でクラウド上で実行し、テスト出力ログのエラーを確認して詳細情報を取得してください。