Visualizar, recuperar e gerenciar logs
Nesta página
- Registros em tempo real do MongoDB
- Visualizar registros em tempo real do MongoDB
- Ativar ou desativar a coleção de registros para um sistema
- Ativar ou desativar a coleção de registros para o projeto
- Registros em disco do MongoDB
- Configurar rotação de registros
- Registros de agentes
- Exibir registros do Agent
- Configurar rotação de registros do Agent
- A autenticação OAuth 2.0 para acesso programático ao Cloud Manager está disponível como um recurso de visualização.
- O recurso e a documentação correspondente podem mudar a qualquer momento durante o período de Pré-visualização. Para usar a 2.0 autenticação OAuth, crie uma conta de serviço para usar em suas solicitações para a API pública do Cloud Manager .
Importante
The real-time log viewer is deprecated. To download MongoDB logs through the UI and API, see Download Logs from a Log Collection 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, acesse aGo Deployment página do seu projeto.
Se ainda não estiver exibido, selecione a organização que contém o projeto desejado 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.
Se a página Deployment ainda não estiver exibida, clique em Deployment na barra lateral.
A página Sistema é exibida.
Acesse a página Processes.
Clique na aba Processes para sua implantação.
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 aGo Deployment página do seu projeto.
Se ainda não estiver exibido, selecione a organização que contém o projeto desejado 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.
Se a página Deployment ainda não estiver exibida, clique em Deployment na barra lateral.
A página Sistema é exibida.
Acesse a página Processes.
Clique na aba Processes para sua implantação.
A página Processos é exibida.
Ativar ou desativar a coleção de registros para o projeto
No MongoDB Cloud Manager, váGo para 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.
Ao lado do menu Projects, expanda o menu Options e 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 aGo Deployment página do seu projeto.
Se ainda não estiver exibido, selecione a organização que contém o projeto desejado 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.
Se a página Deployment ainda não estiver exibida, clique em Deployment na barra lateral.
A página Sistema é 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 aGo Deployment página do seu projeto.
Se ainda não estiver exibido, selecione a organização que contém o projeto desejado 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.
Se a página Deployment ainda não estiver exibida, clique em Deployment na barra lateral.
A página Sistema é exibida.
Acesse a página Agents.
Clique na aba Agents para sua implantação.
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 Deployment do seu projeto.
Se ainda não estiver exibido, selecione a organização que contém o projeto desejado 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.
Se a página Deployment ainda não estiver exibida, clique em Deployment na barra lateral.
A página Sistema é exibida.
Clique na aba Agents para sua implantação.
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ê 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:
No MongoDB Cloud Manager, acesse aGo Deployment página do seu projeto.
Se ainda não estiver exibido, selecione a organização que contém o projeto desejado 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.
Se a página Deployment ainda não estiver exibida, clique em Deployment na barra lateral.
A página Sistema é exibida.
Acesse a página Agents.
Clique na aba Agents para sua implantação.
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.