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.
Os registros do MongoDB fornecem as informações de registro de diagnóstico para seus processos do
mongodemongos.Os registros do agente fornecem informações sobre o comportamento de seus agentes do Ops 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 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.
Visualizar registros em tempo real do MongoDB
Para acessar este recurso, você deve ter privilégios concedidos por um dos seguintes papéis:
Navegue até a Clusters caixa de visualização de seu sistema.
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 ainda não estiver exibido, clique em Deployment na barra lateral.
Clique na visualização Clusters.
(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
Navegue até a Clusters caixa de visualização do seu sistema.
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 ainda não estiver exibido, clique em Deployment na barra lateral.
Clique na visualização Clusters.
Ativar ou desativar a coleção de registros para o projeto
Registros em disco do MongoDB
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.
Ver registros em disco do MongoDB
Para acessar este recurso, você deve ter privilégios concedidos por um dos seguintes papéis:
Clique na sistema cujos registros você deseja baixar e clique em Request Logs
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.
Selecione os tipos de Ops Manager de log por processo a ser coletado e o tamanho cumulativo máximo desses registros.
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 |
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.
|
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:27017host2:27017host2:27018
Sua sistema executa os seguintes agentes:
Agente de automação |
|
Agente de backup |
|
Agente de monitoramento |
|
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
host1ehost2são coletados.host4ehost5nã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
(Opcional) Reduzir informações confidenciais dos registros.
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.
Veja o progresso na Log Request History página.
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.
Baixe o arquivo de registros coletados.
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 .
Configurar rotação de registros
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.
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.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.
Defina as configurações de rotação de registro.
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. |
|
Time Threshold (Hours) | Obrigatório | O Ops Manager gira registros 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 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 |
|
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 |
|
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 Ops Manager coleta registros para todos os seus MongoDB Agents.
Exibir registros do Agent
Para acessar este recurso, você deve ter privilégios concedidos por um dos seguintes papéis:
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 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.
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:
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.
Registros do Ops Manager
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.