ApsaraDB for MongoDB:接続およびネットワークの問題のトラブルシューティング

エラーメッセージ

原因と解決策

network error while attempting to run command 'isMaster' on host 'dds-xxxx.mongodb.rds.aliyuncs.com:3717' :exception: connect failed

• 原因 1：インスタンスが接続上限に達しました。

  解決策：

  1. 接続数が枯渇していないか確認します。詳細については、「接続数の照会方法」をご参照ください。

  2. 接続の使用を最適化します。詳細については、「インスタンスへの接続数が上限に達した場合の対処方法」をご参照ください。

• 原因 2：ホワイトリストが正しく設定されていません。

  解決策：ApsaraDB for MongoDB インスタンスのホワイトリストに正しい IP アドレスを追加してください。

• Timed out after 3000ms while waiting for a server that matches ReadPreferenceServerSelector{readPreference=primary}. exception=(com.mongodb.MongoSocketReadException: Prematurely reached end of stream)

• Socket recv() errno:54 Connection reset by peer x.x.x.x:27017

インスタンスが接続上限に達した可能性があります。

解決策：

1. 接続数が枯渇していないか確認します。詳細については、「接続数の照会方法」をご参照ください。

2. 接続の使用を最適化します。詳細については、「インスタンスへの接続数が上限に達した場合の対処方法」をご参照ください。

MongoDB.Driver.MongoWaitQueueFullException: The wait queue for acquiring a connection to server xxx is full.

MongoDB ドライバーの待機キューが満杯です。これは、接続プールのサイズが小さいか、高い同時実行性が原因である可能性があります。

解決策：

1. アプリケーションの接続プール設定を確認します。プールが適切なサイズであることを確認します。詳細については、「クライアント接続数を制限する方法」をご参照ください。

2. 問題が解決しない場合は、ApsaraDB for MongoDB インスタンスへの接続数が枯渇していないか確認します。

   1. 「接続数の照会方法」

   2. 「インスタンスへの接続数が上限に達した場合の対処方法」

(TooManyLogicalSessions) Unable to add session into the cache because the number of active sessions is too high.

過剰な同時接続により、利用可能なセッションが枯渇する可能性があります。

解決策：

1. 接続枯渇による接続障害のトラブルシューティングを行います。

   1. 「接続数の照会方法」

   2. 「インスタンスへの接続数が上限に達した場合の対処方法」

2. 接続数が正常な場合は、インスタンスの他のパフォーマンスメトリックがビジネス要件を満たしているかどうかを確認します。

   1. 「ノード監視」を使用して、CPU やメモリなどのリソース使用量を確認し、インスタンスタイプがビジネス要件を満たしているかどうかを判断します。

   2. インスタンスタイプがワークロードに対して小さすぎる場合は、オフピーク時に「インスタンス設定の変更」を行います。

• getaddrinfo failed.

• No suitable servers found (`serverSelectionTryOnce` set).

インスタンスのエンドポイントが正しいことを確認します：

• レプリカセットインスタンスへの接続

• シャードクラスターインスタンスへの接続

• Failed to connect to 10.*.*.8:3717 after 5000 milliseconds, giving up.Error: couldn't connect to server 10.*.*.8:3717 (10.*.*.8), connection attempt failed

• pymongo.errors.ServerSelectionTimeoutError: dds-xxxx.mongodb.rds.aliyuncs.com:3717: [Errno 113] No route to host,dds-xxxx.mongodb.rds.aliyuncs.com:3717

• InvalidInstanceId.NotFound: The instance not in current vpc.

ECS インスタンスがプライベートネットワーク経由で ApsaraDB for MongoDB インスタンスに接続できません。

解決策：

1. ホワイトリストの設定を確認します。ECS インスタンスのプライベート IP アドレスが ApsaraDB for MongoDB インスタンスのホワイトリストに追加されていることを確認します。

2. ECS インスタンスと ApsaraDB for MongoDB インスタンスがネットワーク経由で相互に通信できることを確認します。

   ECS インスタンスと ApsaraDB for MongoDB インスタンスが同じ VPC にある場合、プライベートネットワーク経由で直接接続できます。異なる VPC にある場合は、次のいずれかの方法を使用します：

   • インスタンスを同じ VPC に移行します：「異なるリージョンの ECS インスタンスを内部ネットワーク経由で MongoDB インスタンスに接続する」および「異なるアカウントに属する ECS インスタンスを内部ネットワーク経由で MongoDB インスタンスに接続する」

   • VPC を接続します (CIDR ブロックが重複してはなりません)：「方法 3：Cloud Enterprise Network を使用して ECS インスタンスを MongoDB インスタンスに接続する」

org.springframework.data.mongodb.UncategorizedMongoDbException: Timeout while receiving message; nested exception is com.mongodb.MongoSocketReadTimeoutException: Timeout while receiving message

• 原因 1：スロークエリがインスタンスリソースを消費し、CPU 使用率が急上昇する可能性があります。

  解決策：スロークエリを確認し、インデックスを追加してパフォーマンスを最適化します。詳細については、「ApsaraDB for MongoDB インスタンスの高い CPU 使用率」をご参照ください。

• 原因 2：アプリケーションの接続プールが正しく設定されていません (例：不適切なタイムアウト)。

  解決策：

  1. 「接続数の照会方法」

  2. 「インスタンスへの接続数が上限に達した場合の対処方法」

• "errmsg": "not master", "code": 10107, "codeName": "NotMaster"

• "errmsg": "not master", "code": 10107, "codeName": "NotWritablePrimary"

• Time out after 30000ms while waiting for a server that matches writableServerSelector.

• Command failed with error 10107 (NotWritablePrimary): 'not primary' on server xxx.

• Explain's child command cannot run on this node. Are you explaining a write command on a secondary?

• not master and slaveOk=false.

• MongoNotPrimaryException: Command failed with error 10107 (NotMaster): 'not master' on server xxx.

• reason: TopologyDescription { type: 'ReplicaSetNoPrimary',...}

データが書き込まれているノードがプライマリーノードではありません。

原因：書き込み操作はプライマリーノードでのみ実行できます。アプリケーションが以前にプライマリーノードのエンドポイントを使用して接続していた場合、フェイルオーバーによって接続先ノードがセカンダリーノードに変わり、書き込み操作が失敗する可能性があります。

解決策：

• 本番環境では、アプリケーションが接続文字列 URI を使用してデータベースに接続することを推奨します。この方法により、ノードに障害が発生した場合でも、フェイルオーバーによる読み取りおよび書き込み操作への影響を防ぐことができます。エンドポイントの詳細については、次のトピックをご参照ください：

  • レプリカセットインスタンスへの接続

  • シャードクラスターインスタンスへの接続

• 手動でノードロールを切り替えます。単一ノードのエンドポイントに対応するノードをプライマリーノードに昇格させます。

アプリケーションに再接続メカニズムと例外処理を実装し、一時的な切断から自動的に回復できるようにしてください。

[Unauthorized] cloud instance error, disk locked, plz check and upgrade your disk quota,

ディスク領域が枯渇したため、インスタンスがロックされています。

解決策：「ディスク領域の枯渇によるインスタンスのロックまたは書き込みの失敗の解決」をご参照ください。

(AuthenticationFailed) Authentication failed.

• 原因 1：データベースアカウントのパスワードに、!@#$%^&*()_+= などの特殊文字が含まれています。

  解決策：「ユーザー名またはパスワードの特殊文字が原因で発生する接続障害を解決する方法」をご参照ください。

• 原因 2：データベースアカウントのパスワードが正しくありません。

  解決策：アカウント情報とパスワードを確認するか、パスワードをリセットしてから再度接続を試みてください。

• 原因 3：インスタンスエンドポイントで指定された認証データベースが正しくありません。

  解決策：接続文字列で正しい認証データベースを指定します。詳細については、「接続で認証データベースを指定する方法」をご参照ください。

• 原因 4：クライアントのバージョンが古いです。

  解決策：MongoDB Shell 3.0 以降を使用する必要があります。インストール手順については、MongoDB の公式ドキュメント「MongoDB のインストール」をご参照ください。他の言語のクライアントのバージョン要件については、「ドライバーの互換性」ドキュメントをご参照ください。

• !xxx@dds-xxx.mongodb.rds.aliyuncs.com: event not found

データベースアカウントのパスワードに、!@#$%^&*()_+= などの特殊文字が含まれています。

解決策：「ユーザー名またはパスワードの特殊文字が原因で発生する接続障害を解決する方法」をご参照ください。

error getting cluster ID: (CommandNotFound) replSetGetConfig is forbidden by cloud provider for security reason

ApsaraDB for MongoDB は replSetGetConfig をサポートしていません (ApsaraDB for MongoDB におけるコマンドの制限)。