Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Leer la salud de la replicación a través de las API Get Host

Puedes usar la API de Ops Manager para determinar si un miembro del conjunto de réplicas se ha retrasado demasiado para ponerse al día. También puedes leer el último error de replicación del miembro.

Ops Manager añade dos campos al documento host, tooStale y lastReplError, y los devuelve desde las nuevas versiones de v2.0 de los tres endpoints Get Host. El v1.0 endpoints permanecen sin cambios y nunca devuelven los nuevos campos.

Para llamar a estos puntos finales, debes tener el rol Project Read Only.

Item
Detalle

Nuevos puntos finales

v2.0 versiones de Get One Host by ID, Get One Host by Host and Port, y Get All Hosts. Mismas rutas que v1.0 bajo /api/public/v2.0.

Nuevos campos

tooStale y lastReplError en el documento del anfitrión.

Endpoints existentes

v1.0 permanece sin cambios, incluidos los endpoints hosts en la API de administrador.

  • Tu despliegue debe ejecutar el gestor de operaciones 8.0.28 o 9.0.2 o posterior.

  • La monitorización debe estar habilitada para el proyecto. Si la monitorización está desactivada, Ops Manager omite los nuevos campos.

  • Cambia la ruta base de tus solicitudes de /api/public/v1.0 a /api/public/v2.0. El resto de cada solicitud permanece sin cambios.

1

Usa v2.0 Haz que All Hosts liste hosts, o usa el hostname:port que ya conoces.

2
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request GET "https://<OpsManagerHost>:<Port>/api/public/v2.0/groups/{GROUP-ID}/hosts/byName/{HOSTNAME-PORT}?pretty=true"
3
{ "hostname": "node1.example.com", "port": 27017, "replicaSetName": "rs0", "replicaStateName": "RECOVERING", "tooStale": true, "lastReplError": "error RS102 too stale to catch up"}

El documento se recorta para mayor concidencia. Ops Manager devuelve el documento host completo.

Nombre
Tipo
Descripción

tooStale

booleano

El miembro quedó atrás de la ventana del oplog y no pudo ponerse al día con el set de réplica. El miembro requiere una sincronización inicial.

lastReplError

string

El último error de replicación del miembro, de rs.status().

La siguiente tabla describe cómo Ops Manager rellena los nuevos campos en escenarios específicos.

Scenario
Comportamiento

El anfitrión es un miembro saludable del conjunto de réplicas

tooStale es false. lastReplError se omite.

El miembro está detrás de la ventana de oplog

tooStale es true. lastReplError lleva el mensaje del mongod.

El host no es miembro del conjunto de réplicas

Ambos campos están omitidos.

La solicitud utiliza un1v .0 endpoint

Ambos campos están omitidos.

Obtener todos los hosts

Cada host informa de los valores de su propio miembro, no de los del conjunto de réplicas.

Ambos campos describen el único host en la respuesta, no el conjunto completo de réplicas.

La siguiente tabla describe errores y síntomas comunes cuando usas el2v .0 Obtener endpoints de host.

Síntoma
Causa probable
Resolución

404 de un2V .0 punto final

La ruta base es /api/public/v1.0, o el host no está en el proyecto.

Usa /api/public/v2.0 y confirma el host con v2.0 Get All Hosts.

tooStale y lastReplError faltan

El host no es miembro de un conjunto de réplica, la monitorización está desactivada o has llamado a un1v.0 endpoint.

Confirme que el host pertenece a un conjunto de réplicas, la monitorización está habilitada y la ruta usa v2.0.

lastReplError falta pero tooStale está presente

El miembro no informa de error de replicación.

No hace falta ninguna acción.

404 HOST_NOT_FOUND

HOST-ID o HOSTNAME-PORT no coincide con un host en el proyecto.

Confirma el valor con v2.0 Get All Hosts.

Para leer el estado de la replicación programáticamente, consulte Obtener hosts con estado de replicación.