排除私有端点连接问题

通过 DNS 查找获取私有 IP

当 VPC 中的客户端使用这些私有终结点感知连接字符串之一连接到 Atlas 集群时，客户端会尝试通过其中一个接口终结点与 Atlas VPC 中的负载均衡器建立连接。客户端的 DNS 解析机制会处理主机名解析到哪个接口终结点的问题。如果一个接口终结点不可用，则将使用下一个接口终结点。这个过程对驱动程序或其他连接机制是不透明的。驱动程序只知道 SRV 记录或连接字符串中的主机名。

DNS 种子列表私有端点感知连接字符串的 SRV 记录

以下示例显示了启用AWS PrivateLink的单区域集群的 SRV记录，以及为 pl-0-us-east-1.k45tj.mongodb.net 定义的三个唯一端口：

$ 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.

在前面的示例中：

• _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 的一个区域中一个 Atlas 集群的每个节点的主机名。

• 1024、1025 和1026 是 Atlas 在负载均衡器上为启用 AWS PrivateLink 的区域中每个 Atlas 副本集节点分配的唯一端口。Atlas 副本集中的所有节点都可通过相同的主机名访问，负载均衡器通过唯一端口解析各个节点。

私有端点感知连接字符串和 SRV 记录中的主机名 DNS 解析

SRV 记录和标准连接字符串中的主机名是 DNS 规范名称 (CNAME) 记录，解析为 AWS 为接口终结点生成的特定终结点的区域 DNS 名称。您将接口终结点部署到的 VPC 中的每个子网都有 DNS ALIAS 记录。每个 ALIAS 记录都包含该子网的接口终结点的私有 IP 地址。

以下示例显示了 SRV 记录和标准连接字符串中主机名的 DNS 查询，包括接口端点的特定端点区域 DNS 名称及其 DNS ALIAS 记录：

$ nslookup pl-0-us-east-1.k45tj.mongodb.net
Server: 127.0.0.53
Address: 127.0.0.53#53
Non-authoritative answer:
pl-0-us-east-1.k45tj.mongodb.net
canonical 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.com
Address: 10.0.30.194
Name: vpce-024f5b57108c8d3ed-ypwbxwll.vpce-svc-02863655456245e5c.us-east-1.vpce.amazonaws.com
Address: 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 are
too 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

• 您可以在mongos日志中查看通过私有端点连接的分片的片集群的客户端端源IP 。

• 您可以在mongod日志中查看通过私有端点连接的副本集的客户端端源IP 。

• 您可以在Atlas 审核日志中查看通过私有端点连接的副本集和分片的集群的客户端端源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 '"c":"NETWORK"' mongod.log | jq -c '.attr.sourceClient' | grep -v null | sort | uniq -c

1 "172.31.36.2:32958"
1 "172.31.36.2:52904"
1 "172.31.36.2:52908"
1 "172.31.36.2:52910"
1 "172.31.36.2:52918"

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

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

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

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

10809   niyo-*******-api
8616    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索引。

示例，您可以为一个地区配置两个私有端点。如果删除第一个私有端点，则连接字符串将使用索引1 并类似于以下内容：

mongodb+srv://abc-pl-1.xxxxx.mongodb.net/

然后，假设您为集群中的新地区配置私有端点，并随后将集群节点添加到该地区。您的集群现在包括多个区域，并且您的连接字符串会更新为使用 0 的索引：

mongodb+srv://abc-pl-0.xxxxx.mongodb.net/

为了避免在客户端下次重新启动后出现潜在的连接问题，请确认您正在使用零索引的私有端点连接字符串来连接到集群。 集群更改完成后，您可以从Atlas用户界面或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 1024
telnet pl-0-<xyz>.mongodb.net 1025
telnet pl-0-<xyz>.mongodb.net 1026

通过 DNS 查找获取私有 IP

当 VNet 中的客户端使用这些私有终结点感知的连接字符串之一连接到 Atlas 集群时，该客户端会尝试通过私有终结点的网络接口与 Atlas VNet 中的私有链接服务建立连接。 Private Link 服务通过 Azure 标准负载均衡器将流量发送到你在该区域部署的 Atlas 集群节点。您的客户端的 DNS 解析机制负责将主机名解析为网络接口的私有 IP 地址。驱动程序只知道连接字符串中的主机名，并在集群副本集的每个节点上监听一个端口

DNS 种子列表私有端点感知连接字符串的 SRV 记录

以下示例展示启用 Azure Private Link 的单区域集群的 SRV 记录，同时显示为 pl-0-eastus2.uzgh6.mongodb.net 定义的三个唯一端口：

$ nslookup -type=SRV _mongodb._tcp.cluster0-pl-0.uzgh6.mongodb.net
Server:  127.0.0.53
Address:  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的一个地区中一个Atlas 集群中每个节点的主机名。

• 1024、1025 和 1026 是Atlas在负载负载均衡器上为启用了Azure Private Link的地区中的每个Atlas副本集节点分配的唯一端口。 Atlas副本集集中的所有节点都可以通过相同的主机名访问，负载负载均衡器通过唯一端口解析各个节点。

私有端点感知连接字符串和 SRV 记录中的主机名 DNS 解析

SRV记录和标准连接字符串中的主机名是 DNSA 记录，可解析为私有端点网络接口的私有IP解决。

以下示例显示了在 SRV 记录和标准连接字符串中对主机名的 DNS 查询：

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

多区域私有端点

仅当集群跨越的每个地区内都有一个节点配置了私有端点时，私有端点才在多区域集群中可用。 要学习；了解有关配置多区域私有端点的更多信息，请参阅多区域分片集群的区域化私有端点。

多区域集群的连接字符串索引

为新地区配置私有端点并将集群节点部署到该地区后，当您使用私有端点连接到集群时，可能会看到以下错误：

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

当连接字符串的索引自动更改并且客户端随后重新启动时，会出现此错误，从而导致 SRV DNS 查找。 多区域集群的私有端点连接字符串使用索引0。 如果连接字符串使用不同的索引， MongoDB会自动更新连接字符串以使用 0索引。

示例，您可以为一个地区配置两个私有端点。如果删除第一个私有端点，则连接字符串将使用索引1 并类似于以下内容：

mongodb+srv://abc-pl-1.xxxxx.mongodb.net/

然后，假设您为集群中的新地区配置私有端点，并随后将集群节点添加到该地区。您的集群现在包括多个区域，并且您的连接字符串会更新为使用 0 的索引：

mongodb+srv://abc-pl-0.xxxxx.mongodb.net/

为了避免在客户端下次重新启动后出现潜在的连接问题，请确认您正在使用零索引的私有端点连接字符串来连接到集群。 集群更改完成后，您可以从Atlas用户界面或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 1024
telnet pl-0-<xyz>.mongodb.net 1025
telnet pl-0-<xyz>.mongodb.net 1026

多区域私有端点

仅当集群跨越的每个地区内都有一个节点配置了私有端点时，私有端点才在多区域集群中可用。 要学习；了解有关配置多区域私有端点的更多信息，请参阅多区域分片集群的区域化私有端点。

多区域集群的连接字符串索引

为新地区配置私有端点并将集群节点部署到该地区后，当您使用私有端点连接到集群时，可能会看到以下错误：

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

当连接字符串的索引自动更改并且客户端随后重新启动时，会出现此错误，从而导致 SRV DNS 查找。 多区域集群的私有端点连接字符串使用索引0。 如果连接字符串使用不同的索引， MongoDB会自动更新连接字符串以使用 0索引。

示例，您可以为一个地区配置两个私有端点。如果删除第一个私有端点，则连接字符串将使用索引1 并类似于以下内容：

mongodb+srv://abc-pl-1.xxxxx.mongodb.net/

然后，假设您为集群中的新地区配置私有端点，并随后将集群节点添加到该地区。您的集群现在包括多个区域，并且您的连接字符串会更新为使用 0 的索引：

mongodb+srv://abc-pl-0.xxxxx.mongodb.net/

为了避免在客户端下次重新启动后出现潜在的连接问题，请确认您正在使用零索引的私有端点连接字符串来连接到集群。 集群更改完成后，您可以从Atlas用户界面或API访问权限更新的私有端点连接字符串。

从已部署的应用程序测试连接

您可以使用 nslookup 和 telnet 工具测试从应用程序到Atlas私有端点的连接。

 nslookup -debug -type=SRV _mongodb._tcp.gpc-mongo-pl-0-us-central1.test.mongodb.net

Server:               8.8.8.8
Address:      8.8.8.8#53
------------
    QUESTIONS:
          _mongodb._tcp.gpc-mongo-pl-0-us-central1.test.mongodb.net, type = SRV, class = IN
    ANSWERS:
    ->  _mongodb._tcp.gpc-mongo-pl-0-us-central1.test.mongodb.net
    service = 0 0 27017 pl-00-000-us-central1-gcp.test.mongodb.net.
    ttl = 60
    ->  _mongodb._tcp.gpc-mongo-pl-0-us-central1.test.mongodb.net
          service = 0 0 27017 pl-00-001-us-central1-gcp.test.mongodb.net.
          ttl = 60
    ->  _mongodb._tcp.gpc-mongo-pl-0-us-central1.test.mongodb.net
          service = 0 0 27017 pl-00-002-us-central1-gcp.test.mongodb.net.
          ttl = 60
    AUTHORITY RECORDS:
    ADDITIONAL RECORDS:
------------
Non-authoritative answer:
_mongodb._tcp.gpc-mongo-pl-0-us-central1.test.mongodb.net     service = 0 0 27017 pl-00-000-us-central1-gcp.test.mongodb.net.
_mongodb._tcp.gpc-mongo-pl-0-us-central1.test.mongodb.net     service = 0 0 27017 pl-00-001-us-central1-gcp.test.mongodb.net.
_mongodb._tcp.gpc-mongo-pl-0-us-central1.test.mongodb.net     service = 0 0 27017 pl-00-002-us-central1-gcp.test.mongodb.net.

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