Introdução
Toda tela de monitoramento do NoSqlStudio — mongostat, mongotop, Current Op, Replica Set Status, o Realtime dashboard — faz polling no servidor enquanto a aba está aberta. Feche a aba e o polling para. O gravador em segundo plano muda isso: transforma a gravação em um job que continua rodando por conta própria, independente de qualquer aba.
Para que serve
Você inicia uma gravação na tela que já está olhando, e em seguida pode fechar aquela aba, abrir outras abas ou simplesmente deixar o NoSqlStudio rodando em segundo plano. A gravação continua. Quando você voltar, a visão Histórico da tela mostra tudo o que foi capturado enquanto você esteve fora.
Conceito
O que o gravador é
Uma gravação é um pequeno job em segundo plano. Faz polling em uma conexão, em um intervalo fixo, e escreve cada amostra no mesmo histórico que a visão Histórico da tela já lê. Ele é gerenciado pelo motor do gravador — não pela aba — então fechar a aba não o para.
Atenção
Isto é uma ferramenta de workstation, não observabilidade 24/7
O gravador roda na sua máquina, dentro do NoSqlStudio. Se você fechar o app, fizer logoff, ou a máquina entrar em suspensão ou perder energia, a captura para — não há agente no servidor. Use para janelas de investigação focadas (um incidente, um teste de carga, um job noturno suspeito), não como substituto de monitoramento server-side.
Como ler este guia
Cada passo tem:
- Faça — a ação exata.
- Veja — o que deve acontecer na tela. É o seu check de aprovado / reprovado.
- Por quê — contexto, quando ajuda. Pule se estiver com pressa.
Você vai precisar de uma conexão MongoDB conectada e uma aba de monitoramento aberta nela.
Iniciar uma gravação
Uma gravação sempre começa em uma tela de monitoramento — a que você quer capturar.
Abra uma tela de monitoramento
Abra qualquer uma das telas graváveis — mongostat, mongotop, Current Op, Replica Set Status ou o Realtime dashboard — em uma conexão conectada.
A tela ao vivo, fazendo polling normalmente. Na barra de ferramentas há um botão 🔴 Record.
Clique em 🔴 Record
Clique no botão 🔴 Record na barra de ferramentas.
O botão muda para ⏹ Stop recording e ganha um contorno vermelho. Uma gravação em segundo plano está ativa para esta conexão.
O botão lê o estado real do gravador. Se a gravação parar por outro motivo — você parou o job pelo Job Manager, ou a conexão caiu — o botão volta sozinho para 🔴 Record.
Conceito
Atalho pela sidebar (escopo de database)
Clique com o botão direito em qualquer database na barra lateral esquerda e escolha 🔴 Start recording (Profiler). Mesmo resultado de abrir o Profiler manualmente e clicar em Record: a aba do Profiler abre com aquele database já selecionado, e uma gravação com escopo de database começa em segundo plano — em um único clique.
Escolha a cadência (opcional)
Antes de gravar, ajuste o refresh interval da tela para a cadência que você quer capturar. O gravador faz polling no intervalo exibido quando você apertar Record.
Conceito
Um intervalo rápido (250 ms) é ótimo para uma tela ao vivo, mas pesado para uma gravação longa. Para uma gravação que você vai revisar depois, uma cadência mais lenta — alguns segundos — mantém o histórico compacto sem perder a tendência.
Veja no Job Manager
Uma gravação é um job, então aparece em todos os lugares em que jobs aparecem — visível e controlável.
Abra o Job Manager
Abra a aba Job Manager. O dropdown de filtro no canto superior direito tem uma opção Monitoring (N) que restringe a lista apenas aos jobs de gravação.
Um job Monitoring para a conexão em que você acabou de iniciar a gravação. Mostra a conexão, o tipo de monitoramento e o escopo sendo gravado.
O Job Manager é o único lugar que lista todas as gravações em andamento. Um DBA que abriu várias abas de monitoramento consegue ver de relance exatamente o que está — e o que não está — sendo gravado.
Conceito
Watch (Change Watcher) também conta como job de Monitoring
Um Watch ao vivo com o toggle de gravação ligado se registra no Job Manager sob o mesmo filtro Monitoring — não há botão Record separado na tela do Watch porque o change-watcher já é dono do stream + do mirror de histórico. O gravador só o expõe aqui para que o DBA veja todas as gravações ativas em um só lugar.
Olhe a sidebar — pontos de gravação
Olhe a conexão na barra lateral esquerda.
Uma conexão com gravação ativa carrega um pequeno ponto vermelho que pulsa ao lado do nome. O ponto aparece em todos os níveis cobertos pela gravação: na conexão para qualquer gravação ativa, em um database quando uma gravação com escopo de database (ex. Profiler) está rodando, em uma collection quando o escopo é de collection.
Conceito
O que a cor do ponto significa
Vermelho (pulsa a cada ~1,6 s) — gravação saudável, amostras chegando no management database. Âmbar — o management database está temporariamente inacessível, então as amostras estão sendo bufferizadas em arquivo local (interrupção curta; serão reconciliadas quando o database voltar). Vermelho, pulso rápido — a gravação precisa da sua atenção (conexão perdida, reautenticação necessária).
Conceito
Filtrar a sidebar para mostrar só conexões gravando
Clique no ícone de funil no topo da sidebar para abrir o popover de filtros. Um grupo Background recording permite restringir a lista a All connections (padrão), Only recording ou Only not recording. Útil quando você tem muitas conexões abertas e quer focar nas que têm captura ativa — ou nas que não têm.
Feche a aba — a captura continua
É todo o ponto do gravador: a gravação está desacoplada da aba.
Feche a aba de monitoramento
Feche a aba de monitoramento de onde você iniciou a gravação. Abra outras abas, ou simplesmente continue trabalhando.
O Job Manager continua mostrando o job Monitoring, ainda rodando. O ponto na sidebar continua vermelho. Nada foi interrompido.
O motor do gravador é um serviço único, no nível do app. Ele é dono do loop de polling. A aba sempre foi apenas um visualizador — fechar a aba remove o visualizador, não a gravação.
Reabra a tela e revise
Reabra a mesma tela de monitoramento e mude para a visão Histórico.
O histórico cobre toda a janela — incluindo o tempo em que a aba esteve fechada. O buraco que você normalmente veria não está mais lá.
Onde os dados gravados vão parar
O gravador reaproveita o histórico existente de cada tela, então as amostras gravadas ficam exatamente onde a visão Histórico da própria tela já procura.
Management database, primário
Configure um management database em Settings ▸ Database se ainda não fez.
As amostras gravadas são escritas naquele database. Ele é o armazenamento primário — durável e compartilhável entre máquinas.
Disco local, só contingência
Conceito
Se o management database ficar momentaneamente inacessível, as amostras são bufferizadas em arquivo local para que nada se perca. Quando o database volta, as amostras bufferizadas são reconciliadas para dentro dele. O disco é o fallback, não uma cópia paralela — quando o database está saudável, o gravador escreve apenas nele.
Limites honestos
Saber o que o gravador não faz é tão importante quanto saber o que ele faz.
A máquina precisa estar ligada
Conceito
Em um reinício do app, as gravações retomam automaticamente
O que o gravador devolve é continuidade em torno do reinício. Todo Record que você apertou e não parou fica lembrado. Quando você reabre o NoSqlStudio, cada gravação retoma automaticamente assim que sua conexão se reconectar — sob uma nova entrada no Job Manager. Você não precisa apertar nada de novo. A gravação anterior ao encerramento é fechada como Done (interrupted) com um timestamp, e uma nova continua a partir dali.
Reconexão e reautenticação
Se uma conexão cair, o job de gravação se reconecta sozinho, desde que as credenciais possam ser renovadas sem prompt (SCRAM, X.509, AWS-IAM).
A gravação é por conexão e por escopo
Apertar Record em uma tela grava aquela conexão, no escopo mostrado no job. Abrir outras abas de monitoramento não as grava — cada gravação é explícita. O que o Job Manager lista é exatamente o que está sendo capturado: nem mais, nem menos.
Parar uma gravação
Uma gravação roda até você parar. Há duas formas equivalentes:
- Na tela de monitoramento, clique em ⏹ Stop recording na barra de ferramentas.
- No Job Manager, pare o job Monitoring.
De qualquer jeito o loop de polling termina, o job é marcado como done, e o ponto na sidebar some. Desconectar a conexão também para toda gravação nela — um job não consegue fazer polling em um servidor ao qual não está mais conectado.
Conceito
Gravações são deliberadamente explícitas para iniciar e explícitas para parar. Não há captura oculta — se você não vê um job Monitoring, nada está sendo gravado.
Resumo
| Pergunta | Resposta |
|---|---|
| Como inicio uma gravação? | Clique em 🔴 Record na barra de ferramentas de qualquer tela de monitoramento gravável. |
| Continua rodando se eu fechar a aba? | Sim. A gravação é um job em segundo plano, independente da aba. |
| Onde vejo as gravações ativas? | No Job Manager (jobs Monitoring) e no ponto de gravação da sidebar. |
| Onde os dados ficam armazenados? | No management database configurado (primário); no disco local como fallback durante indisponibilidades. |
| O que acontece se eu fechar o app? | A captura pausa enquanto o app está fechado. Quando você reabre, toda gravação retoma automaticamente assim que sua conexão se reconectar — sem precisar apertar de novo. |
| O que significa o ponto na sidebar? | Uma gravação ativa: vermelho = saudável, âmbar = mirror brevemente inacessível (bufferizando para disco), vermelho com pulso rápido = precisa de atenção. O ponto aparece no nível que está sendo gravado — conexão, database ou collection. |
| Como paro? | ⏹ Stop recording na tela, ou pare o job no Job Manager. |