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.
Menu Docs

logRotate (comando de banco de dados)

logRotate

O comando é um comando administrativo que permite a você girar o registro do servidor MongoDB e/ou registro de auditar para evitar que um único arquivo de log consuma muito espaço em logRotate disco.

Você deve enviar o comando logRotate no banco de dados admin.

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

  • 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

Importante

Este comando não é aceito em clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas a todos os comandos, consulte Comandos não suportados.

O comando tem a seguinte sintaxe:

db.adminCommand(
{
logRotate: <integer or string>,
comment: <string>
}
)

O comando utiliza os seguintes campos:

Campo
Tipo
Descrição

logRotate

inteiro ou string

A tora ou toras a serem rotacionadas, de acordo com o seguinte:

  • 1 -- Rotaciona o servidor e os logs de auditoria

  • "server" -- Gira somente o log do servidor

  • "audit" -- Gira apenas o registro de auditoria

comment

string

Opcional. Uma mensagem registrada pelo servidor no arquivo de registro e no arquivo de auditoria no momento da rotação do registro.

Você também pode girar os registros enviando um sinal do SIGUSR1 para o processo do mongod.

Por exemplo, se uma instância mongod em execução tiver um ID de processo (PID) de 2200, o comando a seguir rotacionará o arquivo de log dessa instância no Linux:

kill -SIGUSR1 2200
  • Sua instânciamongodprecisa estar em execução com a opção--logpath [file]para usarlogRotate

  • Auditoria deve ser habilitada para girar o registro de auditoria.

A systemLog.logRotate configuração ou --logRotate logRotate opção especifica o comportamento de.

Quando systemLog.logRotate ou são --logRotate definidos rename como, renomeia o arquivo de log existente anexando o carimbo de data/hora atual ao nome do arquivo. O carimbo de data/hora anexado tem o seguintelogRotate formato:

<YYYY>-<mm>-<DD>T<HH>-<MM>-<SS>

Em seguida, logRotatecria um novo arquivo de log com o mesmo nome originalmente especificado pela configuraçãosystemLog.pathcomomongodoumongos.

Quando systemLog.logRotate ou são --logRotate definidos reopen como, segue o comportamento típico do Linux/Unix e simplesmente fecha o arquivo de log e reabre um arquivo de log com o mesmologRotate nome.reopen Com, espera que outro processo renomeie o arquivo antes da rotação e que a reabertura resulte na criação de um novomongod arquivo.

O exemplo a seguir alterna o log do servidor e o log de auditoria:

db.adminCommand( { logRotate: 1 } )

O exemplo a seguir alterna apenas o log de auditoria e fornece uma mensagem personalizada para o arquivo de log no momento da rotação:

db.adminCommand( { logRotate: "audit", comment: "Rotating audit log" } )