Menu Docs
Página inicial do Docs
/
MongoDB Ops Manager
/

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
  • Ver registros em disco do MongoDB
  • Configurar rotação de registros
  • Registros de agentes
  • Exibir registros do Agent
  • Configurar rotação de registros do Agent
  • Registros do Ops Manager

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

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 MongoDB Ops Manager permite a coleção de registros em tempo real por padrão. Você pode desabilitar a coleção de registros para todas as sistemas do MongoDB em um projeto MongoDB Ops Manager ou para sistemas individuais do MongoDB . Se você desabilitar a coleção de registro, o MongoDB Ops Manager continuará a exibir entradas de registro coletadas anteriormente.

Para acessar este recurso, você deve ter privilégios concedidos por um dos seguintes papéis:

  • Project Automation Admin

  • Project Backup Admin

  • Project Monitoring Admin

  • Project Owner

1
  1. Se ainda não estiver exibido, selecione a organização que contém o projeto desejado 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. Se ainda não estiver exibido, clique em Deployment na barra lateral.

  1. Clique na visualização Clusters.

2

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.
3
4

A guia exibe informações de registro.

5
1
  1. Se ainda não estiver exibido, selecione a organização que contém o projeto desejado 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. Se ainda não estiver exibido, clique em Deployment na barra lateral.

  1. Clique na visualização Clusters.

2
3
  1. Clique na aba Logs.

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

4

Se você desativar a coleção de registro, as entradas de log existentes permanecerão na guia Logs, mas o Ops Manager não coletará novas entradas.

1
2

O MongoDB Ops 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.

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

Este procedimento alterna os registros do sistema e de auditoria do Ops Manager.

Para acessar este recurso, você deve ter privilégios concedidos por um dos seguintes papéis:

1

Clique no ícone de reticências ... na linha para qualquer processo, conjunto de réplicas ou aglomerado compartilhado no projeto e clique em Request Logs.

2

Para escolher registros para baixar, execute as seguintes ações:

em ação
Propósito
Clique em MongoDB Logs

Reúna registros de processos MongoDB implementados.

Esta opção não está disponível para processos MongoDB implementados se a propriedade systemLog.destination estiver configurada para syslog.

Clique em FTDC Data
Reúna os arquivos de dados de diagnóstico a partir do mecanismo de coleção (FTDC), como estatísticas do servidor e mensagens de status.
Clique em Automation Agent Logs
Reúna registros dos agentes de automação implementados.
Clique em Backup Agent Logs

Reúna registros de todos os agentes de backup implementados.

Isso difere de outros registros. Os registros coletados não estão limitados aos hosts selecionados, mas incluem todos os registros do Backup Agent na sistema.

Clique em Monitoring Agent Logs

Reúna registros de todos os agentes de monitoramento implementados.

Isso difere de outros registros. Os registros coletados não estão limitados aos hosts selecionados, mas incluem todos os registros do Monitoring Agent na sistema.

Configurar Size per Log Type em MB

Insira o tamanho máximo cumulativo descompactado em megabytes de todos os arquivos de registro selecionados.

  • Este limite é cumulativo.

    • Para registros MongoDB ou FTDC, isso limita o tamanho dos registros coletados por processo.

    • Para os agentes, isso limita o tamanho dos registros relacionados por agente.

  • Esses arquivos de registro são arquivados e compactados.

    Por exemplo, se você definir esse valor como 50 MB, o MongoDB Ops Manager reunirá um total de 50 MB de arquivo de log descompactado de cada processo mongod e mongos e de cada Agente para todos os registros que você escolheu baixar.

  • Se o arquivo de registro atual for menor que o tamanho especificado, o Ops Manager reunirá o arquivo girado mais recente também.

  • Se o tamanho total dos arquivos de registro atingir o tamanho especificado no meio de um arquivo de registro, esse último arquivo de registro será truncado na linha mais recente que estiver dentro do tamanho especificado.

  • A quantidade máxima de arquivos de registro que podem ser coletados é de 20 GB. Esse máximo inclui todos os arquivos de registro coletados que não expiraram. Se você solicitar registros adicionais e coletar esses resultados de registros em mais de 20 GB de registros coletados, o Ops Manager gerará um erro. A quantidade total de registros coletados em comparação ao limite é exibida como Estimated Total Size.

Exemplo

Você escolhe coletar 20 MB de registros de todos os processos em um conjunto de réplicas. Esse conjunto de réplicas tem três processos mongod em dois hosts:

  • host1:27017

  • host2:27017

  • host2:27018

Sua sistema executa os seguintes agentes:

Agente de automação
host1, host2, host4, host5
Agente de backup
host4
Agente de monitoramento
host4, host5

Quando você escolhe todos os tipos de log para este conjunto de réplicas e limita para 20 MB por processo, o Gerente de Operações mostra que o Estimated Total Size é de 220 MB (11 processos * 20 MB) de 20 GB.

Quando a coleção de registros começa, o Ops Manager verifica os diretórios de log em busca dos processos mongod e seu FTDC associado, da entrada de registro mais atual até que 20 MB de arquivos de registro ou o final do último log sejam coletados. Todos os agentes de monitoração e backup na implementação também são verificados.

  • O Backup Agent tem 60 MB de registros.

  • Cada processo MongoDB (3) tem 7 MB de registros e 15 MB de dados FTDC por processo.

  • Cada agente de monitoramento (2) tem 30 MB de registros.

  • Cada agente de automação (2) tem 12 MB de registros.

O tamanho total dos registros coletados é de 150 MB:

(20 + (3 * (7 + 15)) + (2 * 20) + (2 * 12)) = 150

  • O máximo de 20 MB de registros do Backup Agent é coletado.

  • Todos os registros de cada processo MongoDB são coletados: 7 MB de MongoDB + 15 MB de dados FTDC.

  • O máximo de 20 MB de registros de cada agente de monitoramento é coletado.

  • Todos os registros do Agente de automação de host1 e host2 são coletados. host4 e host5 não hospedam nenhum processo no conjunto de réplicas.

A estrutura de arquivo resultante dentro do arquivo baixado é:

host1/27017/mongodb
host1/27017/ftdc
host1/automation_agent
host2/27017/mongodb
host2/27017/ftdc
host2/27018/mongodb
host2/27018/ftdc
host2/automation_agent
host4/backup_agent
host4/monitoring_agent
host5/monitoring_agent
3

Para tornar seus registros anônimos, selecione Replace IP addresses, hostnames, namespaces, strings with randomized values.

Esta opção substitui os endereços IP por um intervalo privado (192.168.x.x). Para nomes de host, esta opção substitui apenas FQDN. Outros nomes de host permanecem inalterados. As substituições seguem um padrão previsível. Por exemplo, se o blue.strawberry substituir uma instância do FQDN test.internal, o blue.strawberry também substituirá todas as outras instâncias do test.internal.

Observação

Isso não usa o pipeline de agregação $redact. Essa é uma capacidade separada com um conjunto de recursos mais amplo.

4
5

O status da entrada mostra Collecting Logs... e atualiza automaticamente seu status à medida que a coleção de registros continua.

  • Se o Ops Manager não conseguir recuperar os arquivos de registro, clique em Retry para recuperar os arquivos de registro com falha novamente.

  • Se ocorrer uma falha, você ainda poderá baixar o arquivo. Alguns dos arquivos de registro solicitados estarão ausentes.

6

Clique em Download icon.

O tamanho listado para o arquivo na página Log Request History é o tamanho descompactado. O arquivo consome essa quantidade de espaço em disco no host de destino após ser extraído.

Este download só pode ser reiniciado e não retomado. Se o download falhar, você deverá baixar os registros novamente.

O arquivo é denominado mongodb-logfiles_<instance_or_process>_<ISO8601_Format_Date>.tar.gz.

Os arquivos extraídos utilizam a seguinte estrutura de diretório:

<host>
automation_agent
automation-agent-verbose.log
automation-agent-verbose.log.<ISO8601_Format_Date>
backup_agent
backup-agent-verbose.log
backup-agent-verbose.log.<ISO8601_Format_Date>
monitoring_agent
monitoring-agent-verbose.log
monitoring-agent-verbose.log.<ISO8601_Format_Date>
<replica_set> // Sharded Cluster Only
<port>
ftdc
metrics.<ISO8601_Format_Date>
metrics.interim
mongodb
mongodb.log
mongodb.log.<ISO8601_Format_Date>
<port> // Replica Set or Standalone
ftdc
metrics.<ISO8601_Format_Date>
metrics.interim
mongodb
mongodb.log
mongodb.log.<ISO8601_Format_Date>

Observação

Ao extrair o tar arquivo em um host Microsoft Windows, use um utilitário de extração de arquivos que ofereça suporte a cabeçalhos estendidos PAX. Alguns utilitários de arquivo Windows têm problemas com cabeçalhos estendidos PAX para tar.

Os registros coletados expiram e são removidos após 7 dias. Para estender o tempo de vida de um arquivo de registro específico, clique no link extend desse arquivo na página Log Request History .

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

Importante

Se você estiver executando o MongoDB Enterprise versão 5.0 ou posterior e o MongoDB Agent 11.0.13.7055 ou posterior, poderá:

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

  • Comprima e exclua registros de auditoria usando o Ops Manager. Por motivos de segurança, recomendamos gerenciar a compactação e a exclusão do log de auditoria fora do Ops Manager.

Se você estiver executando versões anteriores do MongoDB Enterprise ou do MongoDB Agent, Ops 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 Ops 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. Clique em Deployment.

  2. Na lista suspensa More, clique em MongoDB Log Settings.

2

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.0.13.7055 ou posterior também podem alternar de Audit Log Rotation para ON para girar os registros de auditoria e configurar a rotação dos registros 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 log para OFF se você não desejar que o Ops Manager gire seus registros. A rotação do log é OFF por padrão.

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

3

O Ops Manager gira os registros em seus hosts MongoDB de acordo com as seguintes configurações:

Campo
necessidade
em ação
Default
Size Threshold (MB)
Obrigatório
O Ops Manager gira os arquivos de registro que excedem esse tamanho máximo de arquivo de registro.
1000
Time Threshold (Hours)
Obrigatório
O Ops Manager gira registros 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 Ops Manager compacta primeiro os arquivos de registro mais antigos.

Se você deixar esta configuração vazia, o Gerente de Operações utilizará o padrão de 5.

5
Max Percent of Disk
Opcional

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

Se você deixar esta configuração vazia, o Gerente de Operações 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.

4

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

O Ops Manager coleta registros para todos os seus MongoDB Agents.

Para acessar este recurso, você deve ter privilégios concedidos por um dos seguintes papéis:

1

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.

2

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 ver os registros de um agente específico, clique na lista All Agents da aba Agents e, em seguida, 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
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.

Você pode usar o Ops Manager para analisar uma variedade de arquivos de registro:

Você pode alterar quanto tempo você mantém alguns registros do Ops Manager. Talvez sua empresa precise manter os dados de registro para atender aos requisitos legais. Você pode alterar sua política de retenção de registros para aderir a esses requisitos.

Voltar

Integrar com o Slack