プライベートエンドポイント接続の問題のトラブルシューティング

クロスリージョン プライベートエンドポイントの問題

次のセクションでは、クロスリージョンのプライベートエンドポイント接続に関する一般的な問題とその解決方法について説明します。

DNS ルックアップによるプライベート IP の取得

お使いの VPC 内のクライアントが、これらのプライベート エンドポイント対応の接続文字列のいずれかを使用して Atlas クラスターに接続する際、クライアントは VPC 内の Atlas のロード バランサーに対して、インターフェース エンドポイントのいずれかを通じて接続を試みます。ホスト名は、お使いのクライアントで使用される DNS 解決メカニズムに従って、インターフェイス エンドポイントに変換されます。あるインターフェイスエンドポイントが使用できない場合は、その次のものが使用されます。ドライバーなどの接続メカニズムではこの処理が不透明になります。ドライバーが認識するのは、SRV レコード形式または接続文字列形式のホスト名のみです。

DNS シードリストのプライベートエンドポイント対応接続文字列の SRV レコード

次の例は、AWS PrivateLink が有効化されている単一リージョン クラスターの SRV レコードで、pl-0-us-east-1.k45tj.mongodb.net 3 つの一意なポートが定義されています。

$ nslookup -type=SRV _mongodb._tcp.cluster0-pl-0.k45tj.mongodb.net
Server: 127.0.0.53Address: 127.0.0.53#53
Non-authoritative answer:_mongodb._tcp.cluster0-pl-0.k45tj.mongodb.net service = 0 0 1026 pl-0-us-east-1.k45tj.mongodb.net._mongodb._tcp.cluster0-pl-0.k45tj.mongodb.net service = 0 0 1024 pl-0-us-east-1.k45tj.mongodb.net._mongodb._tcp.cluster0-pl-0.k45tj.mongodb.net service = 0 0 1025 pl-0-us-east-1.k45tj.mongodb.net.

前の例では、次のようになります。

• _mongodb._tcp.cluster0-pl-0.k45tj.mongodb.net は、mongodb+srv://cluster0-pl-0.k45tj.mongodb.net 接続文字列が参照する SRV レコードです。

• pl-0-us-east-1.k45tj.mongodb.net は、AWS PrivateLink を構成済みのあるリージョンに属する 1 つの Atlas クラスター内の各ノードのホスト名です。

• 1024、1025 、1026 は、Atlas で AWS PrivateLink を有効化したリージョンに属する各 Atlas レプリカセット ノードのロード バランサーに割り当てられる固有のポートです。Atlas レプリカセット内のどのノードにも同じホスト名でアクセスでき、個々のノードはロード バランサーによって固有のポート別に解決されます。

プライベートエンドポイント対応接続文字列と SRV レコードでのホスト名 DNS 解決

SRV レコードと標準接続文字列のホスト名は、DNS 正規名（CNAME）レコードとして AWS でインターフェイス エンドポイント向けに生成されるエンドポイント固有のリージョン別 DNS 名です。インターフェイス エンドポイントを配置した VPC の各サブネットには DNS ALIAS レコードがあり、各 ALIAS レコードには、そのサブネットのインターフェイス エンドポイントのプライベート IP アドレスが含まれています。

以下に例示されているのは、SRV レコードと標準接続文字列のホスト名向けの DNS ルックアップであり、インターフェイスエンドポイントとその DNS ALIAS レコード向けのエンドポイント固有のリージョン別 DNS 名が含まれています。

$ nslookup pl-0-us-east-1.k45tj.mongodb.netServer: 127.0.0.53Address: 127.0.0.53#53
Non-authoritative answer:pl-0-us-east-1.k45tj.mongodb.netcanonical name = vpce-024f5b57108c8d3ed-ypwbxwll.vpce-svc-02863655456245e5c.us-east-1.vpce.amazonaws.com.
Name: vpce-024f5b57108c8d3ed-ypwbxwll.vpce-svc-02863655456245e5c.us-east-1.vpce.amazonaws.comAddress: 10.0.30.194Name: vpce-024f5b57108c8d3ed-ypwbxwll.vpce-svc-02863655456245e5c.us-east-1.vpce.amazonaws.comAddress: 10.0.20.54

オープンな接続が多すぎるため、接続を拒否

• 接続が クラスター サービスの制限 を超える場合は、クラスター層を増やす 必要があります。

• 接続数が予想される接続数よりも大幅に高い場合は、以下の「 ほとんどの接続を行うクライアントに関する詳細情報の収集 」セクションを参照してください。

• 負荷分散された最適化された接続文字列を使用して、シャーディングされたクラスターv7.0.22 に を適用する例。

$ mongosh "mongodb+srv://aws-replica-set-7-pl-0-lb.22qdu.mongodb-dev.net/" --apiVersion 1 --username sarah  Enter password: *****  Current Mongosh Log ID:    68910f1754be6d9adc74e399  Connecting to:             mongodb+srv://<credentials>@aws-replica-set-7-pl-0-lb.22qdu.mongodb-dev.net/?appName=mongosh+2.5.6  MongoNetworkError: Client network socket disconnected before secure TLS connection was established

{"t":{"$date":"2025-08-04T19:48:17.649+00:00"},"s":"I", "c":"NETWORK","id":22942, "ctx":"listener","msg":"Connection refused because there aretoo many open connections","attr":{"remote":"54.172.143.8:33205","isLoadBalanced":false,"uuid":{"uuid":{"$uuid":"e52e9c14-7648-430a-bc2e-95292347b7e0"}},"connectionId":380,"connectionCount":58}}

クライアントソースIPの表示

• クライアントソースIP は、プライベートエンドポイント経由で接続しているシャーディングされたクラスターの mongos ログ で表示できます。

• クライアントソースIP は、プライベート エンドポイント経由で接続しているレプリカセットのmongodログで表示できます。

• クライアントソースIP は、プライベートエンドポイント経由で接続しているレプリカセットとシャーディングされたクラスターの両方の監査するログで表示できます。

• この機能は、次のバージョンのAmazon Web Servicesでサポートされています。

  • 8.1 および v8.1.0+

  • 8.0 および v8.0.10+

  • 7.0 および v7.0.22+

• オリジンクライアントのIPアドレスとポートは sourceClientフィールドによって示されます。その値は、上記の例では 10.50.4.23 です。

  {"t":{"$date":"2025-07-21T12:15:42.123+00:00"},"s":"I","c":"NETWORK","id":22943,"ctx":"listener","msg":"Connection accepted","attr":{"remote":"192.168.100.55:31245","isLoadBalanced":true,"sourceClient":"10.50.4.23:50123","uuid":{"uuid":{"$uuid":"12345678-abcd-4321-abcd-87654321abcd"}},"connectionId":345,"connectionCount":19}}

ほとんどの接続を行うクライアントに関する詳細情報を収集する

これらの詳細を収集するには、 jqウェブサイトからダウンロードできる jq ツール を使用する必要があります。

grep 'Connection accepted' mongod.log | jq -r '(.attr.sourceClient // .attr.remote)' | awk -F: '{print $1}' | sort | uniq -c | sort -rn

25957 192.168.254.15525957 192.168.253.16125957 192.168.248.23614420 10.70.2.25414420 10.70.2.116

more mongodb.log| grep 'NETWORK' | jq -r '.attr.doc.driver.name' | grep -v null | sort | uniq -c | sort -rn

56447    mongo-go-driver21633    mongo-java-driver|sync   75    mongo-java-driver|sync|Airbyte    4    nodejs|Mongoose

import jsonimport sys
def process_log_file(json_file_path):    # Dictionary to store the filtered data    filtered_data = {}
    with open(json_file_path, "r") as json_file:        # Read the file line by line        for line in json_file:            # Parse each line as a separate JSON object            data = json.loads(line)
            if 'msg' in data and data['msg'] == 'client metadata':                # Extract the relevant data from the JSON object                drivername = data['attr']['doc']['driver']['name']                driverversion = data['attr']['doc']['driver']['version']                connectionid = data['ctx']
                # Create a unique key for the driver based on name and version                driver_key = (drivername, driverversion)
                # Add the connection ID to the driver's set of connections                if driver_key not in filtered_data:                    filtered_data[driver_key] = {'connections': set(), 'opencount': 0, 'closedcount': 0}
                filtered_data[driver_key]['connections'].add(connectionid)                filtered_data[driver_key]['opencount'] += 1
            if 'msg' in data and data['msg'] == 'Connection ended':                connectionid = data['ctx']
                # Check if the connection ID exists in any driver's connections                for driver_data in filtered_data.values():                    if connectionid in driver_data['connections']:                        driver_data['closedcount'] += 1                        driver_data['connections'].remove(connectionid)
    # Print the filtered data for each driver    for driver_key, driver_data in filtered_data.items():        print('Driver:', driver_key)        print('Connection Opened:', driver_data['opencount'])        print('Connection Closed:', driver_data['closedcount'])
if __name__ == '__main__':    # Check if a JSON file argument is provided    if len(sys.argv) < 2:        print("Please provide the path to a JSON file as an argument.")        sys.exit(1)
    # Extract the JSON file path from the command-line arguments    json_file_path = sys.argv[1]
    # Process the log file    process_log_file(json_file_path)

Driver: ('mongo-go-driver', 'v1.12.0-cloud')Connection Opened: 14368Connection Closed: 14362
Driver: ('mongo-go-driver', 'v1.12.1')Connection Opened: 42056Connection Closed: 41958
Driver: ('mongo-java-driver|sync', '4.11.1')Connection Opened: 18012Connection Closed: 17987
Driver: ('mongo-java-driver|sync', '4.8.2')Connection Opened: 3621Connection Closed: 3610
Driver: ('nodejs|Mongoose', '4.17.1|6.12.0')Connection Opened: 3Connection Closed: 1
Driver: ('mongo-go-driver', 'v1.13.0')Connection Opened: 23Connection Closed: 20
Driver: ('mongo-java-driver|sync|Airbyte', '4.11.0')Connection Opened: 75Connection Closed: 75
Driver: ('nodejs|Mongoose', '4.17.2|6.13.0')Connection Opened: 1Connection Closed: 0

more mongodb.log| grep 'NETWORK' | jq -r '.attr.doc.application.name' | grep -v null | sort | uniq -c | sort -rn

10809   niyo-*******-api8616    MongoDB CPS Module v13.17.2.8878 (git: 70c0b932f47f4f0b3e82a75e223f39ed9635b47f)7203    niyo-ns*****5752    MongoDB Automation Agent v13.17.2.8878 (git: 70c0b932f47f4f0b3e82a75e223f39ed9635b47f)3601    *****-auth-service

マルチリージョン プライベートエンドポイント

プライベートエンドポイントは、クラスターがまたがる各リージョン内にプライベートエンドポイントが設定されているノードがある場合にのみ、 マルチリージョンクラスター で 使用できます 。 マルチリージョンプライベートエンドポイントの構成の詳細については、「 マルチリージョンのシャーディングされたクラスターのリージョン別プライベートエンドポイント 」を参照してください。

マルチリージョンクラスターの接続文字列のインデックス作成

新しいリージョンのプライベートエンドポイントを構成し、そのリージョンにクラスター ノードを配置した後、プライベートエンドポイントを使用してクラスターに接続すると、次のエラーが表示される場合があります。

DNSHostNotFound: Failed to look up service "<MongoDB service name>"

このエラーは、接続文字列のインデックスが自動的に変更され、その後クライアントが再起動された場合に発生し、SRV DNS ルックアップが発生します。 マルチリージョンクラスターのプライベートエンドポイント接続文字列は 0 のインデックスを使用します。 接続文字列で別のインデックスが使用されている場合、 MongoDB は接続文字列を自動的に更新し、 0インデックスを使用します。

例、リージョンに 2 つのプライベートエンドポイントを構成できます。最初のプライベートエンドポイントを削除すると、接続文字列は1 のインデックスを使用し、次のようになります。

mongodb+srv://cluster1-psc-0.4uyx2d.mongodb.net

次に、クラスター内の新しいリージョンにプライベートエンドポイントを構成し、その後そのリージョンにクラスター ノードを追加するとします。クラスターに複数のリージョンが含まれ、接続文字列が0 のインデックスを使用するように更新されます。

mongodb+srv://cluster1-psc-1.4uyx2d.mongodb.net

クライアントの次回の再起動後に接続の問題が発生しないようにするには、 0 からインデックス作成された プライベートエンドポイント接続文字列を使用してクラスターに接続していることを確認してください。 クラスターの変更が完了すると、Atlas UIまたはAPIから更新されたプライベートエンドポイント接続文字列にアクセスできます。

配置したアプリケーションからの接続をテストする

ツール nslookup と telnet を使用して、アプリケーションから Atlas のプライベートエンドポイントへの接続をテストできます。

 nslookup -type=SRV _mongodb._tcp.cluster0-pl-0.k45tj.mongodb.net

 Server: 127.0.0.53 Address: 127.0.0.53#53 Non-authoritative answer: _mongodb._tcp.cluster0-pl-0.k45tj.mongodb.net service = 0 0 1026 pl-0-us-east-1.k45tj.mongodb.net. _mongodb._tcp.cluster0-pl-0.k45tj.mongodb.net service = 0 0 1024 pl-0-us-east-1.k45tj.mongodb.net. _mongodb._tcp.cluster0-pl-0.k45tj.mongodb.net service = 0 0 1025 pl-0-us-east-1.k45tj.mongodb.net.

telnet pl-0-<xyz>.mongodb.net 1024telnet pl-0-<xyz>.mongodb.net 1025telnet pl-0-<xyz>.mongodb.net 1026

DNS ルックアップによるプライベート IP の取得

VNet 内のクライアントは、これらのプライベートエンドポイントを認識する接続文字列を使用して Atlas クラスターに接続する際、プライベートエンドポイントのネットワーク インターフェイス経由で Atlas VNet 内の Private Link Service への接続を確立しようとします。Private Link Service では、Azure Standard Load Balancer から、該当リージョンに配置した Atlas クラスター ノードへトラフィックが送信されます。クライアントで使用される DNS 解決メカニズムでは、ホスト名はネットワーク インターフェイスのプライベート IP アドレスに変換されます。ドライバーは接続文字列形式のホスト名のみを認識し、クラスターのレプリカセット内の各ノードにつき 1 つのポートでリッスンします。

DNS シードリストのプライベートエンドポイント対応接続文字列の SRV レコード

次の例では、Azure Private Link が有効化されている単一リージョン クラスターの SRV レコードで、pl-0-eastus2.uzgh6.mongodb.net に 3 つの一意なポートが定義されています。

$ nslookup -type=SRV _mongodb._tcp.cluster0-pl-0.uzgh6.mongodb.net
Server:  127.0.0.53Address:  127.0.0.53#53
Non-authoritative answer:_mongodb._tcp.cluster0-pl-0.uzgh6.mongodb.net service = 0 0 1024 pl-0-eastus2.uzgh6.mongodb.net._mongodb._tcp.cluster0-pl-0.uzgh6.mongodb.net service = 0 0 1025 pl-0-eastus2.uzgh6.mongodb.net._mongodb._tcp.cluster0-pl-0.uzgh6.mongodb.net service = 0 0 1026 pl-0-eastus2.uzgh6.mongodb.net.

前の例では、次のようになります。

• _mongodb._tcp.cluster0-pl-0.uzgh6.mongodb.net は、接続文字列が参照する SRV レコードです。

• pl-0-eastus2.uzgh6.mongodb.net は、 Azure Private Link を構成済みのあるリージョンに属する 1 つの Atlas クラスター内の各ノードのホスト名です。

• 1024、1025、1026 は、 Azure Private Link を有効化したリージョンに属する各 Atlasレプリカセットのノードのロードバランサーに Atlas が割り当てる一意のポートです。 Atlasレプリカセット内のどのノードにも同じホスト名でアクセスでき、個々のノードはロードバランサーによって固有のポート別に解決されます。

プライベートエンドポイント対応接続文字列と SRV レコードでのホスト名 DNS 解決

SRV レコードと標準接続文字列内のホスト名は DNS A レコードであり、プライベートエンドポイントのネットワーク インターフェースのプライベート IP アドレスに変換されます。

以下に例示されているのは、SRV レコードと標準接続文字列のホスト名向けの DNS ルックアップです。

$ nslookup pl-0-eastus2.uzgh6.mongodb.netServer:  127.0.0.53Address:  127.0.0.53#53
Non-authoritative answer:Name:  pl-0-eastus2.uzgh6.mongodb.netAddress: 10.0.0.4

マルチリージョン プライベートエンドポイント

プライベートエンドポイントは、クラスターがまたがる各リージョン内にプライベートエンドポイントが設定されているノードがある場合にのみ、 マルチリージョンクラスター で 使用できます 。 マルチリージョンプライベートエンドポイントの構成の詳細については、「 マルチリージョンのシャーディングされたクラスターのリージョン別プライベートエンドポイント 」を参照してください。

マルチリージョンクラスターの接続文字列のインデックス作成

新しいリージョンのプライベートエンドポイントを構成し、そのリージョンにクラスター ノードを配置した後、プライベートエンドポイントを使用してクラスターに接続すると、次のエラーが表示される場合があります。

DNSHostNotFound: Failed to look up service "<MongoDB service name>"

このエラーは、接続文字列のインデックスが自動的に変更され、その後クライアントが再起動された場合に発生し、SRV DNS ルックアップが発生します。 マルチリージョンクラスターのプライベートエンドポイント接続文字列は 0 のインデックスを使用します。 接続文字列で別のインデックスが使用されている場合、 MongoDB は接続文字列を自動的に更新し、 0インデックスを使用します。

例、リージョンに 2 つのプライベートエンドポイントを構成できます。最初のプライベートエンドポイントを削除すると、接続文字列は1 のインデックスを使用し、次のようになります。

mongodb+srv://cluster1-psc-0.4uyx2d.mongodb.net

次に、クラスター内の新しいリージョンにプライベートエンドポイントを構成し、その後そのリージョンにクラスター ノードを追加するとします。クラスターに複数のリージョンが含まれ、接続文字列が0 のインデックスを使用するように更新されます。

mongodb+srv://cluster1-psc-1.4uyx2d.mongodb.net

クライアントの次回の再起動後に接続の問題が発生しないようにするには、 0 からインデックス作成された プライベートエンドポイント接続文字列を使用してクラスターに接続していることを確認してください。 クラスターの変更が完了すると、Atlas UIまたはAPIから更新されたプライベートエンドポイント接続文字列にアクセスできます。

配置したアプリケーションからの接続をテストする

ツール nslookup と telnet を使用して、アプリケーションから Atlas のプライベートエンドポイントへの接続をテストできます。

 nslookup -type=SRV _mongodb._tcp.cluster0-pl-0.k45tj.mongodb.net

 Server: 127.0.0.53 Address: 127.0.0.53#53 Non-authoritative answer: _mongodb._tcp.cluster0-pl-0.k45tj.mongodb.net service = 0 0 1026 pl-0-us-east-1.k45tj.mongodb.net. _mongodb._tcp.cluster0-pl-0.k45tj.mongodb.net service = 0 0 1024 pl-0-us-east-1.k45tj.mongodb.net. _mongodb._tcp.cluster0-pl-0.k45tj.mongodb.net service = 0 0 1025 pl-0-us-east-1.k45tj.mongodb.net.

telnet pl-0-<xyz>.mongodb.net 1024telnet pl-0-<xyz>.mongodb.net 1025telnet pl-0-<xyz>.mongodb.net 1026

マルチリージョン プライベートエンドポイント

プライベートエンドポイントは、クラスターがまたがる各リージョン内にプライベートエンドポイントが設定されているノードがある場合にのみ、 マルチリージョンクラスター で 使用できます 。 マルチリージョンプライベートエンドポイントの構成の詳細については、「 マルチリージョンのシャーディングされたクラスターのリージョン別プライベートエンドポイント 」を参照してください。

マルチリージョンクラスターの接続文字列のインデックス作成

新しいリージョンのプライベートエンドポイントを構成し、そのリージョンにクラスター ノードを配置した後、プライベートエンドポイントを使用してクラスターに接続すると、次のエラーが表示される場合があります。

DNSHostNotFound: Failed to look up service "<MongoDB service name>"

このエラーは、接続文字列のインデックスが自動的に変更され、その後クライアントが再起動された場合に発生し、SRV DNS ルックアップが発生します。 マルチリージョンクラスターのプライベートエンドポイント接続文字列は 0 のインデックスを使用します。 接続文字列で別のインデックスが使用されている場合、 MongoDB は接続文字列を自動的に更新し、 0インデックスを使用します。

例、リージョンに 2 つのプライベートエンドポイントを構成できます。最初のプライベートエンドポイントを削除すると、接続文字列は1 のインデックスを使用し、次のようになります。

mongodb+srv://cluster1-psc-0.4uyx2d.mongodb.net

次に、クラスター内の新しいリージョンにプライベートエンドポイントを構成し、その後そのリージョンにクラスター ノードを追加するとします。クラスターに複数のリージョンが含まれ、接続文字列が0 のインデックスを使用するように更新されます。

mongodb+srv://cluster1-psc-1.4uyx2d.mongodb.net

クライアントの次回の再起動後に接続の問題が発生しないようにするには、 0 からインデックス作成された プライベートエンドポイント接続文字列を使用してクラスターに接続していることを確認してください。 クラスターの変更が完了すると、Atlas UIまたはAPIから更新されたプライベートエンドポイント接続文字列にアクセスできます。

配置したアプリケーションからの接続をテストする

ツール nslookup と telnet を使用して、アプリケーションから Atlas のプライベートエンドポイントへの接続をテストできます。

 nslookup -debug -type=SRV _mongodb._tcp.cluster1-psc-0.j735c.mongodb.net

Server:               127.0.2.2Address:      127.0.2.2#53
------------   QUESTIONS:   _mongodb._tcp.cluster1-psc-0.j735c.mongodb.net, type = SRV, class = IN   ANSWERS:   ->  _mongodb._tcp.cluster1-psc-0.j735c.mongodb.net   service = 0 0 1024 pl-0-us-central1-gcp.j735c.mongodb.net.   ttl = 60   ->  _mongodb._tcp.cluster1-psc-0.j735c.mongodb.net   service = 0 0 1025 pl-0-us-central1-gcp.j735c.mongodb.net.   ttl = 60   ->  _mongodb._tcp.cluster1-psc-0.j735c.mongodb.net   service = 0 0 1026 pl-0-us-central1-gcp.j735c.mongodb.net.   ttl = 60   AUTHORITY RECORDS:   ADDITIONAL RECORDS:------------Non-authoritative answer:_mongodb._tcp.cluster1-psc-0.j735c.mongodb.net        service = 0 0 1024 pl-0-us-central1-gcp.j735c.mongodb.net._mongodb._tcp.cluster1-psc-0.j735c.mongodb.net        service = 0 0 1025 pl-0-us-central1-gcp.j735c.mongodb.net._mongodb._tcp.cluster1-psc-0.j735c.mongodb.net        service = 0 0 1026 pl-0-us-central1-gcp.j735c.mongodb.net.
Authoritative answers can be found from:telnet pl-0-us-central1-gcp.j735c.mongodb.net 1024

telnet pl-0-<xyz>.mongodb.net 27017