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

Visualizar, recuperar e gerenciar logs

Importante

O visualizador de registro em tempo real está obsoleto. Para baixar logs do MongoDB por meio da IU e da API, consulte Visualizar, recuperar e gerenciar logs.

O Cloud Manager coleta informações de registro dos processos do MongoDB e de seus agentes. Para processos do MongoDB, você pode acessar registros em tempo real e registros em disco.

  • The MongoDB logs provide the diagnostic logging information for your mongod and mongos processes.

  • Os registros do Agent fornecem insights sobre o comportamento de seus agentes do Cloud Manager.

The MongoDB Agent issues the getLog command with every monitoring ping. This command collects log entries from RAM cache of each MongoDB process.

O Cloud Manager permite a coleta de logs em tempo real por padrão. Você pode desativar a coleta de logs para todas as implantações do MongoDB em um projeto do Cloud Manager ou para implantações individuais do MongoDB. Se você desabilitar a coleta de logs, o Cloud Manager continuará exibindo entradas de logs coletadas anteriormente.

1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

  3. Na barra lateral, clique em Processes sob o título Database.

The Processes page displays.

2
3

Os quatro botões estão listados na seguinte ordem, da esquerda para a direita: Shards, Configs, Mongose BIs.

Processo
Displays

Shards

mongod processa que hospedam seus dados.

Configs

mongod processes that run as config servers to store a sharded cluster's metadata.

Mongos

mongos processos que roteiam dados em um cluster fragmentado.

BIs

Processos de BI que acessam dados em um cluster fragmentado.

4
5

A guia exibe informações de registro.

6
1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

  3. Na barra lateral, clique em Processes sob o título Database.

The Processes page displays.

2
3
4
  1. Clique na aba Logs.

  2. Alterne Collect Logs For Host para Off ou On, conforme desejado.

5

Se você desativar a coleta de registros, as entradas de registros existentes permanecerão na aba Logs, mas o Cloud Manager não coletará novas entradas.

1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

  3. Na barra lateral, clique em Project Settings.

    A página Configurações do projeto é exibida.

2

Cloud Manager collects on-disk logs even if the MongoDB instance is not running. The MongoDB Agent collects the logs from the location you specified in the MongoDB systemLog.path configuration option. The MongoDB on-disk logs are a subset of the real-time logs and therefore less verbose.

Observação

This option isn't available for deployed MongoDB processes if the systemLog.destination property is set to syslog.

Você pode configurar a rotação de registros para os registros em disco. O Cloud Manager gira registros por padrão.

Este procedimento rotaciona os registros do sistema e de auditoria para o Cloud Manager.

O Cloud Manager pode girar e comprimir logs para clusters que o MongoDB Agent gerencia. Se o Agente MongoDB monitorar apenas um cluster, ele ignorará os logs desse cluster.

Importante

Se estiver executando o MongoDB Enterprise versão 5,0 ou posterior e o MongoDB Agent 11,11,0,7355 ou posterior, você pode:

  • Defina regras separadas para girar registros de servidor e registros de auditoria.

  • Use o Cloud Manager para comprimir e excluir os registros de auditoria. Por motivos de segurança, recomendamos gerenciar a compressão e a exclusão do log de auditoria fora do Cloud Manager.

Se você estiver executando versões anteriores do MongoDB Enterprise ou do MongoDB Agent, Cloud Manager:

  • Utiliza suas configurações do System Log Rotation para girar os registros do servidor e os registros de auditoria.

  • Não compacta nem exclui registros de auditoria. Se você configurar compressão e exclusão, o Cloud Manager aplicará essas configurações somente aos registros do servidor.

Os usuários do MongoDB Community podem rotacionar, comprimir e excluir somente os registros do servidor.

Observação

Ao usar esta funcionalidade, desabilite serviços de rotação de registros baseados em plataforma, como logrotate. Remova os sinalizadores reopen e rename dos arquivos de configuração do processo. Se o MongoDB Agent monitorar somente o cluster, este cluster poderá usar serviços baseados em plataforma.

1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

  3. Na barra lateral, clique em Processes sob o título Database.

The Processes page displays.

2

Na lista suspensa More, clique em MongoDB Log Settings.

3

Alterne System Log Rotation para ON para alternar os registros do servidor.

Os usuários do MongoDB Enterprise que executam o MongoDB Enterprise versão 5,0 ou posterior e o MongoDB Agent 11,11,0,7355 ou posterior também podem alternar de Audit Log Rotation para ON para girar os logs de auditoria e configurar a rotação dos logs de auditoria separadamente.

Se você estiver executando versões anteriores do MongoDB Enterprise ou do MongoDB Agent, a configuração de System Log Rotation para ON também rotaciona os registros de auditoria.

Configure a rotação de registros para OFF se você não deseja que o Cloud Manager rotacione seus registros. A rotação de registros é OFF por padrão.

Depois de ativar a rotação de log, o Cloud Manager exibe configurações adicionais de rotação de log.

4

O Cloud Manager rotaciona os registros em seus hosts do MongoDB seguindo as seguintes configurações:

Campo
necessidade
em ação
Default

Size Threshold (MB)

Obrigatório

O Cloud Manager gira os arquivos de log que excedem esse tamanho máximo de arquivo de log.

1000

Time Threshold (Hours)

Obrigatório

O Cloud Manager gira logs que excedem essa duração.

24

Max Uncompressed Files

Opcional

Os arquivos de registro podem permanecer descompactados até que excedam esse número de arquivos. O Cloud Manager comprime primeiro os arquivos de registro mais antigos.

Se você deixar esta configuração vazia, o Cloud Manager utilizará o padrão de 5.

5

Max Percent of Disk

Opcional

Os arquivos de registros podem ocupar este percentual de espaço em disco no volume de registro do seu host do MongoDB. O Cloud Manager exclui os arquivos de registros mais antigos quando excedem o limite do disco.

Se você deixar esta configuração vazia, o Cloud Manager utilizará o padrão de 2%.

2%

Total Number of Files

Opcional

Número total de arquivos de registro. Se um número não for especificado, o número total de arquivos de registro terá como padrão 0 e será determinado por outras configurações Rotate Logs.

0

Quando terminar, clique em Save para revisar suas alterações.

5

Caso contrário, clique em Cancel e você poderá fazer alterações adicionais.

O Cloud Manager coleta logs para todos os seus agentes MongoDB.

1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

  3. Na barra lateral, clique em Agents sob o título Database.

A página Agentes é exibida.

2

A página exibe registros do tipo de agente selecionado na lista suspensa View. A página filtra os registros de acordo com quaisquer filtros selecionados por meio do ícone de engrenagem.

3

Para exibir registros de um tipo diferente de agente, use a lista suspensa View.

Para exibir registros de hosts específicos ou processos do MongoDB, clique no ícone de engrenagem e selecione conforme desejado.

Para limpar os filtros, clique no ícone de engrenagem e clique em Remove Filters.

Para baixar os registros selecionados, clique no ícone de engrenagem e clique em Download as CSV File.

Observação

Para visualizar os registros de um agente específico, você pode alternativamente:

  1. No MongoDB Cloud Manager, Go a página Agents do seu projeto.

    1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

    2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

    3. Na barra lateral, clique em Agents sob o título Database.

    A página Agentes é exibida.

  2. Clique em All Agents.

  3. Clique em view logs para o agente.

Se você usa o Automation para gerenciar o cluster, siga este procedimento para configurar a rotação dos arquivos de registros do Agent.

Observação

Se você não tiver habilitado a automação, consulte a documentação a seguir para obter informações sobre como definir manualmente as configurações de registro nos arquivos de configuração do agente:

1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

  3. Na barra lateral, clique em Agents sob o título Database.

A página Agentes é exibida.

2
3
4

Clique no ícone pencil para editar as configurações de registros do agente de monitoramento ou do Agente de backup:

Nome
Tipo
Descrição

Linux Log File Path

string

Condicional: faz registro em um host Linux. O caminho para o qual o agente grava seus registros em um host Linux.

O valor sugerido é:

/var/log/mongodb-mms-automation/monitoring-agent.log

Windows Log File Path

string

Condicional: faz registro em um host Windows. O caminho para o qual o agente grava seus registros em um host Windows.

O valor sugerido é:

%SystemDrive%\MMSAutomation\log\mongodb-mms-automation\monitoring-agent.log

Rotate Logs

Alternar

Um botão para selecionar se os registros devem ser girados.

Size Threshold (MB)

inteiro

O tamanho em que os registros giram automaticamente. O valor padrão é 1000.

Time Threshold (Hours)

inteiro

A duração do tempo em que os registros rotacionam automaticamente. O valor padrão é 24.

Max Uncompressed Files

inteiro

Opcional. O maior número de arquivos de registro, incluindo o arquivo de registro atual, que deve permanecer descompactado. O valor sugerido é 5.

Max Percent of Disk

inteiro

Opcional. A maior porcentagem de espaço em disco em seus hosts MongoDB que os registros devem consumir. O valor sugerido é 2%.

Total Number of Files

inteiro

Opcional. O número total de arquivos de registro. Se um número não for especificado, o número total de arquivos de registro terá como padrão 0 e será determinado por outras configurações Rotate Logs.

Quando terminar, clique em Save.

5
6

Caso contrário, clique em Cancel e você poderá fazer alterações adicionais.