Importante
O visualizador de registro em tempo real está obsoleto. Para fazer download de registros MongoDB por meio da interface do usuário eda API , consulte download-logs-from-job.
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.
Os registros do MongoDB fornecem as informações de registro de diagnóstico para seus processos do
mongodemongos.Os registros do Agent fornecem insights sobre o comportamento de seus agentes do Cloud Manager.
Registros em tempo real do MongoDB
O MongoDB Agent emite o comando getLog com cada ping de monitoramento. Este comando coleta entradas de registro do cache de RAM de cada processo MongoDB.
O Cloud Manager permite a coleta de registros em tempo real por padrão. Você pode desativar a coleta de registros para todas as deployments do MongoDB em um projeto do Cloud Manager ou para deployments individuais do MongoDB. Se você desabilitar a coleta de registros, o Cloud Manager continuará exibindo entradas de registros coletadas anteriormente.
Visualizar registros em tempo real do MongoDB
No MongoDB Cloud Manager, vá Processes para a página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Na barra lateral, clique em Processes sob o título Database.
A página Processos é exibida.
(Opcional) Para clusters fragmentados, filtre o tipo de processo listado.
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 | processos mongod que são executados como servidores de configuração para armazenar os metadados de um cluster fragmentado. |
Mongos | processos mongos que roteiam dados em um cluster fragmentado. |
BIs | Processos de BI que acessam dados em um cluster fragmentado. |
Ativar ou desativar a coleção de registros para um sistema
No MongoDB Cloud Manager, acesse a Processes página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Na barra lateral, clique em Processes sob o título Database.
A página Processos é exibida.
Ativar ou desativar a coleção de registros para o projeto
No MongoDB Cloud Manager, acesse a Project Settings página.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Na barra lateral, clique em Project Settings.
A página Configurações do projeto é exibida.
Registros em disco do MongoDB
O Cloud Manager coleta registros em disco, mesmo que a instância do MongoDB não esteja em execução. O MongoDB Agent coleção os registros do local que você especificou na opção de configuração do MongoDB systemLog.path . Os registros em disco do MongoDB são um subconjunto dos registros em tempo real e, portanto, menos detalhados.
Observação
Esta opção não está disponível para processos MongoDB implementados se a propriedade systemLog.destination estiver configurada para syslog.
Você pode configurar a rotação de logs para os logs em disco. O Cloud Manager gira logs por padrão.
Este procedimento rotaciona os registros do sistema e de auditoria para o Cloud Manager.
Configurar rotação de registros
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.
No MongoDB Cloud Manager, acesse a Processes página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Na barra lateral, clique em Processes sob o título Database.
A página Processos é exibida.
Ativar a rotação de registros.
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.
Defina as configurações de rotação de registro.
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. |
|
Time Threshold (Hours) | Obrigatório | O Cloud Manager gira logs que excedem essa duração. |
|
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 |
|
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 |
|
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 |
|
Quando terminar, clique em Save para revisar suas alterações.
Registros de agentes
O Cloud Manager coleta logs para todos os seus agentes MongoDB.
Exibir registros do Agent
No MongoDB Cloud Manager, acesse a Agents página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Na barra lateral, clique em Agents sob o título Database.
A página Agentes é exibida.
Filtre as entradas de registro.
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:
No MongoDB Cloud Manager, Go a página Agents do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Na barra lateral, clique em Agents sob o título Database.
A página Agentes é exibida.
Clique em All Agents.
Clique em view logs para o agente.
Configurar rotação de registros do Agent
Se você usar o Automation para gerenciar seu cluster, siga este procedimento para configurar a rotação dos arquivos de logs 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:
No MongoDB Cloud Manager, acesse a Agents página do seu projeto.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Na barra lateral, clique em Agents sob o título Database.
A página Agentes é exibida.
Edite as configurações de registros.
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 é: | |
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 é: | |
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 é | |
Time Threshold (Hours) | inteiro | A duração do tempo em que os registros rotacionam automaticamente. O valor padrão é | |
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 é | |
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 é | |
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 |
Quando terminar, clique em Save.