Amazon Q Business を使用する際に発生する、「Server stopped responding」というエラーのトラブルシューティング方法を教えてください。

解決策

Amazon Q Business が必要なネットワーク接続を確立できない場合、「Server stopped responding」というエラーが発生します。Amazon Q Business は、ポート 8443 経由で WebSocket テクノロジを使用してエンドポイントとの安全な接続を維持します (例: wss://qbusiness.{region}.api.aws:8443/chat)。ウェブエクスペリエンスを機能させるには、ポート 8443 が開いていて、お使いのネットワークにアクセスできる必要があります。

ポートへのアクセスが問題の原因であるかどうかを確認するには、接続を体系的にテストします。

注: ネットワークで VPN またはファイアウォールを使用している場合は、その VPN またはファイアウォールが有効な状態および無効な状態で接続をテストしてください。

WebSocket 接続のテスト

macOS または Linux では、ターミナルを使用して次のコマンドを実行します。

nc -v qbusiness.us-east-1.api.aws 8443

正常な接続の例

Connection to qbusiness.us-east-1.api.aws port 8443 [tcp/pcsync-https] succeeded

Windows では、Windows PowerShell を使用して次のコマンドを実行します。

Test-NetConnection -ComputerName qbusiness.us-east-1.api.aws -Port 8443

正常な接続の例

ComputerName     : qbusiness.us-east-1.api.aws
RemoteAddress    : 34.192.X.X
RemotePort       : 8443
InterfaceAlias   : Wi-Fi
SourceAddress    : 10.0.X.X
TcpTestSucceeded : True

または、

Pie.host のウェブサイトにある WebSocket テスターを使用して接続をテストします。該当するエンドポイントを入力し、[接続] を選択します。

ネットワークテストが成功すると、出力に Connection Established と表示されます。クライアントコンピューターがポート 8443 でエンドポイントに正常に接続できることを示す、Connection closed というメッセージも表示される場合があります。

テストが失敗した場合は、ポート 8443 が開いていてアクセス可能であることを確認します。ネットワークの VPN、仮想プライベートクラウド (VPC)、またはファイアウォールポリシーの設定を更新します。必要な設定にアクセスできない場合は、ネットワーク管理者に協力を依頼してください。

ポートテストが成功したにもかかわらず、エラーメッセージが表示される場合は、WebSocket 接続がブロックされている可能性があります。

エラーの原因を判断するには、次の手順を実行します。

1. F12 を押してブラウザのネットワークコンソールを開きます。
2. Amazon Q Business アプリケーションでリクエストを行います。
3. コンソールログで WebSocket の接続エラーを確認します。

WebSocket 接続がブロックされている場合は、次のようなエラーメッセージが表示されます。

「WebSocket connection to 'wss://qbusiness.us-east-1.api.aws:8443/chat?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=XXXXXXXXXC2MH5KBVFMS%2F20241231%2Fus-east-1%2Fqbusiness%2Faws4_request&X-Amz-Date=20241231T151549Z&X-Amz-Expires=900&X-Amz-failed'」

上記のメッセージが表示された場合は、ネットワーク管理者に依頼してネットワーク接続のブロックを解除してください。

関連情報

Amazon Q Business のウェブエクスペリエンスを使用する