Solucionar problemas de conexión de los nodos privados

Problemas con los nodos privados entre regiones

Las siguientes secciones describen los problemas comunes de conectividad entre nodos privados de diferentes regiones y cómo resolverlos.

Obtén direcciones IP privadas con búsqueda DNS

Cuando un cliente en la VPC se conecta a un clúster de Atlas utilizando una de estas cadenas de conexión con reconocimiento de nodo privado, el cliente intenta establecer una conexión con el balanceador de carga en la VPC de Atlas a través de uno de los endpoints de la interfaz. El mecanismo de resolución de DNS del cliente gestiona a qué endpoint de la interfaz se resuelve el nombre de host. Si un endpoint de la interfaz no está disponible, se utiliza el siguiente. Esto es opaco para el driver o cualquier otro mecanismo de conexión. El driver solo es consciente del nombre de host en el registro SRV o en la cadena de conexión.

Registro SRV para cadenas de conexión con reconocimiento de nodos de la lista de semillas DNS

El siguiente ejemplo muestra el registro SRV para un clúster de una sola región habilitado para AWS PrivateLink, mostrando tres puertos únicos definidos para 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.

En el ejemplo precedente:

• _mongodb._tcp.cluster0-pl-0.k45tj.mongodb.net es el registro SRV al que hace referencia la cadena de conexión de mongodb+srv://cluster0-pl-0.k45tj.mongodb.net.

• pl-0-us-east-1.k45tj.mongodb.net es el nombre de host de cada nodo en un clúster de Atlas en una región para la cual has configurado AWS PrivateLink.

• 1024, 1025 y 1026 son puertos únicos que Atlas asigna en el balanceador de carga para cada nodo del set de réplicas de Atlas en la región para la que has habilitado AWS PrivateLink. Todos los nodos en un set de réplicas de Atlas son accesibles a través del mismo nombre de host, donde el balanceador de carga resuelve los nodos individuales por su puerto único.

Resolución de DNS del nombre de host en cadenas de conexión y registros SRV con reconocimiento de nodos privados

El nombre de host en el registro SRV y la cadena de conexión estándar es un registro DNS Canonical Name (CNAME) que se resuelve al nombre DNS regional específico del punto final que AWS genera para el punto final de la interfaz. Existe un registro DNS ALIAS para cada subred de su VPC en la que implementó el punto final de la interfaz. Cada registro ALIAS contiene la dirección IP privada del punto final de la interfaz para esa subred.

El siguiente ejemplo muestra la búsqueda DNS del nombre de host en el registro SRV y en la cadena de conexión estándar, incluyendo el nombre DNS regional específico del punto final para el punto final de la interfaz y sus registros 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

Conexión rechazada porque hay demasiadas conexiones abiertas

• Si tus conexiones superan los límites de conexión para tu límite del servicio del clúster, debes aumentar el nivel de clúster.

• Si tu recuento de conexiones es significativamente superior al recuento previsto, consulta la sección a continuación Obtener más información sobre el cliente que realiza la mayoría de las conexiones.

• Por ejemplo, aplicación en un clúster sharded v7.0.22 utilizando una cadena de conexión optimizada con balanceo de carga.

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

Visualización de la IP de origen del cliente

• Puedes ver la IP de origen del cliente en los registros mongos de los clústeres particionados que se conectan a través de nodos privados.

• Puedes ver la IP de origen del cliente en los registros de mongod para los sets de réplicas que se conectan a través de nodos privados.

• Puedes ver la IP de origen del cliente en los registros de auditoría para ambos set de réplicas y clústeres fragmentados que se conectan a través de Endpoints Privados.

• Esta funcionalidad es compatible con AWS para las siguientes versiones:

  • 8.1 y v8.1.0+

  • 8.0 y v8.0.10+

  • 7.0 y v7.0.22+

• La dirección IP de origen del cliente y el puerto se indican en el campo sourceClient. Ese valor es 10.50.4.23 en el ejemplo anterior.

  {"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}}

Obtener más información sobre el cliente que realiza la mayor cantidad de conexiones

Reunir estos detalles requiere usar la herramienta jq, que se puede descargar del sitio web 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.155
25957 192.168.253.161
25957 192.168.248.236
14420 10.70.2.254
14420 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-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

Nodos privados multiregión

Los puntos finales privados solo están disponibles en clústeres de varias regiones si hay un nodo dentro de cada región que cubre el clúster que tenga configurado un punto final privado. Para obtener más información sobre la configuración de nodos privados multirregionales, consulta Nodos privados regionalizados para clústeres particionados multirregionales.

indexación de cadena de conexión para clústeres multiregionales

Después de configurar un nodo privado para una nueva región e implementar nodos de clúster en esa región, puede que se encuentre con el siguiente error cuando utilice su nodo privado para conectarse al clúster:

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

Este error ocurre cuando el índice de tu cadena de conexión cambia automáticamente y tu cliente se reinicia, lo que provoca una búsqueda SRV DNS. La cadena de conexión del endpoint privado para un clúster multirregional utiliza un índice de 0. Si tu cadena de conexión utiliza un índice diferente, MongoDB actualiza automáticamente la cadena de conexión para usar el índice 0.

Por ejemplo, puedes configurar dos nodos privados para una región. Si remueves el primer punto final privado, tu cadena de conexión utiliza un índice de 1 y se parece a lo siguiente:

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

Luego, supón que configuras unos nodos privados para una nueva región en tu clúster y posteriormente añades nodos de clúster a esa región. Ahora tu clúster incluye varias regiones, y tu cadena de conexión se actualizará para usar un índice de 0:

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

Para evitar posibles problemas de conectividad después del próximo reinicio de su cliente, confirme que está utilizando la cadena de conexión del endpoint privado indexado en cero para conectarse a su clúster. Puedes acceder a la cadena de conexión actualizada del endpoint privado desde la UI o la API de Atlas después de que se completen los cambios en tu clúster.

Probar la conectividad de tu aplicación implementada

Puedes utilizar las herramientas nslookup y telnet para probar la conectividad desde tu aplicación a tus nodos privados en 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

Obtén direcciones IP privadas con búsqueda DNS

Cuando un cliente en el VNet se conecta a un clúster de Atlas usando una de estas cadenas de conexión compatibles con el nodo privado, el cliente intenta establecer una conexión con el servicio Private Link en el VNet de Atlas a través de la interfaz de red del nodo privado. El servicio Private Link envía tráfico a través de un balanceador de carga estándar de Azure a los nodos de clúster de Atlas que implementaste en esa región. El mecanismo de resolución de DNS del cliente gestiona la conversión del nombre de host a la dirección IP privada de la interfaz de red. El driver solo es reconoce el nombre de host en la cadena de conexión y escucha en un puerto por cada nodo del set de réplicas del clúster.

Registro SRV para cadenas de conexión con reconocimiento de nodos de la lista de semillas DNS

El siguiente ejemplo muestra el registro SRV de un clúster de una sola región habilitado para Azure Private Link, mostrando tres puertos únicos definidos para 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.

En el ejemplo precedente:

• _mongodb._tcp.cluster0-pl-0.uzgh6.mongodb.net es el registro SRV al que hace referencia la cadena de conexión.

• pl-0-eastus2.uzgh6.mongodb.net es el nombre del host de cada nodo en un clúster de Atlas en una región para la que ha configurado Azure Private Link.

• 10241025 y 1026 son puertos exclusivos que Atlas asigna en el balanceador de carga para cada nodo de set de réplicas de Atlas en la región para la que habilitó Azure Private Link. Todos los nodos en un Atlas set de réplicas son accesibles mediante el mismo nombre de host, con el balanceador de carga resolviendo cada nodo por su puerto individual.

Resolución de DNS del nombre de host en cadenas de conexión y registros SRV con reconocimiento de nodos privados

El nombre de host en el registro SRV y la cadena de conexión estándar es un registro DNS A que se resuelve en la dirección IP privada de la interfaz de red del punto final privado.

El siguiente ejemplo muestra la consulta de DNS para el nombre de host en el registro SRV y en la cadena de conexión estándar:

$ 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

Nodos privados multiregión

Los puntos finales privados solo están disponibles en clústeres de varias regiones si hay un nodo dentro de cada región que cubre el clúster que tenga configurado un punto final privado. Para obtener más información sobre la configuración de nodos privados multirregionales, consulta Nodos privados regionalizados para clústeres particionados multirregionales.

indexación de cadena de conexión para clústeres multiregionales

Después de configurar un nodo privado para una nueva región e implementar nodos de clúster en esa región, puede que se encuentre con el siguiente error cuando utilice su nodo privado para conectarse al clúster:

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

Este error ocurre cuando el índice de tu cadena de conexión cambia automáticamente y tu cliente se reinicia, lo que provoca una búsqueda SRV DNS. La cadena de conexión del endpoint privado para un clúster multirregional utiliza un índice de 0. Si tu cadena de conexión utiliza un índice diferente, MongoDB actualiza automáticamente la cadena de conexión para usar el índice 0.

Por ejemplo, puedes configurar dos nodos privados para una región. Si remueves el primer punto final privado, tu cadena de conexión utiliza un índice de 1 y se parece a lo siguiente:

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

Luego, supón que configuras unos nodos privados para una nueva región en tu clúster y posteriormente añades nodos de clúster a esa región. Ahora tu clúster incluye varias regiones, y tu cadena de conexión se actualizará para usar un índice de 0:

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

Para evitar posibles problemas de conectividad después del próximo reinicio de su cliente, confirme que está utilizando la cadena de conexión del endpoint privado indexado en cero para conectarse a su clúster. Puedes acceder a la cadena de conexión actualizada del endpoint privado desde la UI o la API de Atlas después de que se completen los cambios en tu clúster.

Probar la conectividad de tu aplicación implementada

Puedes utilizar las herramientas nslookup y telnet para probar la conectividad desde tu aplicación a tus nodos privados en 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

Nodos privados multiregión

Los puntos finales privados solo están disponibles en clústeres de varias regiones si hay un nodo dentro de cada región que cubre el clúster que tenga configurado un punto final privado. Para obtener más información sobre la configuración de nodos privados multirregionales, consulta Nodos privados regionalizados para clústeres particionados multirregionales.

indexación de cadena de conexión para clústeres multiregionales

Después de configurar un nodo privado para una nueva región e implementar nodos de clúster en esa región, puede que se encuentre con el siguiente error cuando utilice su nodo privado para conectarse al clúster:

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

Este error ocurre cuando el índice de tu cadena de conexión cambia automáticamente y tu cliente se reinicia, lo que provoca una búsqueda SRV DNS. La cadena de conexión del endpoint privado para un clúster multirregional utiliza un índice de 0. Si tu cadena de conexión utiliza un índice diferente, MongoDB actualiza automáticamente la cadena de conexión para usar el índice 0.

Por ejemplo, puedes configurar dos nodos privados para una región. Si remueves el primer punto final privado, tu cadena de conexión utiliza un índice de 1 y se parece a lo siguiente:

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

Luego, supón que configuras unos nodos privados para una nueva región en tu clúster y posteriormente añades nodos de clúster a esa región. Ahora tu clúster incluye varias regiones, y tu cadena de conexión se actualizará para usar un índice de 0:

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

Para evitar posibles problemas de conectividad después del próximo reinicio de su cliente, confirme que está utilizando la cadena de conexión del endpoint privado indexado en cero para conectarse a su clúster. Puedes acceder a la cadena de conexión actualizada del endpoint privado desde la UI o la API de Atlas después de que se completen los cambios en tu clúster.

Probar la conectividad de tu aplicación implementada

Puedes utilizar las herramientas nslookup y telnet para probar la conectividad desde tu aplicación a tus nodos privados en Atlas.

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

Server:               127.0.2.2
Address:      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