db.serverStatus() (método mongosh)

db.serverStatus()

Retorna um documento que fornece uma visão geral do estado do processo do banco de dados.

Este comando fornece um wrapper em torno do comando do banco de dados serverStatus.

Compatibilidade

Esse método está disponível em implantações hospedadas nos seguintes ambientes:

MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

Importante

This command is not supported in M0 and Flex clusters. For more information, see Unsupported Commands.

MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Comportamento

By default, db.serverStatus() excludes in its output:

algum conteúdo no documento repl .
Documento mirroredReads.

Para incluir campos que são excluídos por padrão, especifique o campo de nível superior e defina-o para 1 no comando. Para excluir campos incluídos por padrão, especifique o campo e defina como 0. Você pode especificar campos incorporados ou de nível superior.

Por exemplo, a seguinte operação suprime as informações repl, metrics e locks na saída.

db.serverStatus( { repl: 0,  metrics: 0, locks: 0 } )

O exemplo a seguir inclui todas as informações de resposta na saída:

db.serverStatus( { repl: 1 } )

Excluir todos os campos opcionais

A partir do MongoDB 8.3, você pode excluir todos os campos opcionais da saída db.serverStatus() especificando none: 1. Depois de excluir todos os campos opcionais, você pode especificar os campos que deseja incluir.

Este exemplo usa none para excluir inicialmente todos os campos opcionais da saída e, em seguida, inclui o documento locks.

db.serverStatus({ none: 1, locks: 1 })

Inicialização

The statistics reported by db.serverStatus() are reset when the mongod server is restarted. The db.serverStatus() command does not report some statistics until they have been initialized by server events.

For example, after restarting the mongod server, db.serverStatus() won't return any values for findAndModify.

db.serverStatus().metrics.commands.findAndModify
// No results returned

After you run an update query, subsequent calls to db.serverStatus() display the expected metrics.

{
   "arrayFilters" : Long(0),
   "failed" : Long(0),
   "pipeline" : Long(0),
   "total" : Long(1)
}

Observação

O método db.serverStatus() retorna um erro se for feita uma consulta de um objeto específico antes que os contadores tenham começado a incrementar.

Se ainda não houve nenhuma atualização do documento:

db.serverStatus().metrics.commands.update.pipeline

Retorna:

TypeError: db.serverStatus(...).metrics.commands.update is undefined :
@(shell):1:1

Incluir `mirroredReads`

Por padrão, as informações de mirroredReads não são incluídas na saída. Para retornar informações de mirroredReads, é necessário especificar explicitamente a inclusão: