Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Leia o status de replicação através das APIs Get Host.

Você pode usar a API do Ops Manager para determinar se um membro do conjunto de réplicas ficou muito atrasado para se recuperar. Você também pode ler o último erro de replicação do membro.

Ops Manager adds two fields to the host document, tooStale and lastReplError, and returns them from new v2.0 versions of the three Get Host endpoints. The v1.0 endpoints are unchanged and never return the new fields.

To call these endpoints, you must have the Project Read Only role.

Item
Detalhes

Novos pontos finais

v2.0 versions of Get One Host by ID, Get One Host by Hostname and Port, and Get All Hosts. Same paths as v1.0 under /api/public/v2.0.

Novos campos

tooStale and lastReplError on the host document.

Pontos finais existentes

v1.0 is unchanged, including the hosts endpoints in the Admin API.

  • Your deployment must run Ops Manager 8.0.28 or 9.0.2 or later.

  • O monitoramento deve estar ativado para o projeto. Se o monitoramento estiver desativado, o Ops Manager omite os novos campos.

  • Change the base path of your requests from /api/public/v1.0 to /api/public/v2.0. The rest of each request is unchanged.

1

Use v2.0 Get All Hosts to list hosts, or use the hostname:port you already know.

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

O documento foi truncado para maior brevidade. O Ops Manager retorna o documento completo do host.

Nome
Tipo
Descrição

muito antigo

booleano

O membro ficou atrasado em relação à janela do oplog e não conseguiu se recuperar do conjunto de réplicas. O membro requer uma sincronização inicial.

último erro de repetição

string

The member's last replication error, from rs.status().

A tabela a seguir descreve como o Ops Manager preenche os novos campos em cenários específicos.

Cenário
Comportamento

O anfitrião é um membro saudável do conjunto de réplicas.

tooStale is false. lastReplError is omitted.

O membro está atrás da janela do oplog.

tooStale is true. lastReplError carries the mongod's message.

O anfitrião não é um membro do conjunto de réplicas.

Ambos os campos foram omitidos.

Request uses a v1.0 endpoint

Ambos os campos foram omitidos.

Obter todos os hosts

Cada host reporta os valores de seus próprios membros, e não os do conjunto de réplicas.

Ambos os campos descrevem o host individual na resposta, não o conjunto de réplicas completo.

The following table describes common errors and symptoms when you use the v2.0 Get Host endpoints.

Problema
Provável Causa
de conflitos

404 from a v2.0 endpoint

The base path is /api/public/v1.0, or the host isn't in the project.

Use /api/public/v2.0 and confirm the host with v2.0 Get All Hosts.

tooStale and lastReplError are missing

The host isn't a replica set member, monitoring is disabled, or you called a v1.0 endpoint.

Confirm the host belongs to a replica set, monitoring is enabled, and the path uses v2.0.

lastReplError is missing but tooStale is present

O membro não reporta nenhum erro de replicação.

Nenhuma ação necessária.

404 HOST_NOT_FOUND

HOST-ID or HOSTNAME-PORT doesn't match a host in the project.

Confirm the value with v2.0 Get All Hosts.

Para ler o status de replicação programaticamente, consulte Obter hosts com status de replicação.