Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Exportar logs para o Google Cloud armazenamento

Você pode configurar seus clusters do Atlas M10+ para exportar registros do sistema a cada minuto para um bucket do Google Cloud Storage.

Essa integração permite:

  • Especifique quais arquivos de log do MongoDB você deseja exportar para o bucket do Google Cloud Storage. O Atlas suporta a exportação dos seguintes tipos de log:

    • mongod

    • mongos

    • mongod-audit

    • mongos-audit

  • Configure até 10 caminhos de exportação, permitindo exportar logs para vários armazenamentos do Google Cloud simultaneamente.

Importante

Os registros podem conter informações confidenciais (incluindo PII). Você é responsável pelo armazenamento e tratamento de seus registros em seu bucket de armazenamento do Google Cloud. Para que o Atlas elimine determinadas informações antes de exportar registros, entre em contato com o Suporte do MongoDB.

Para exportar registros para um bucket do Google Cloud Storage, você deve ter acesso de Project Owner ou Organization Owner ao Atlas.

  • Cada host Atlas normalmente produz 1 GB de registros por dia. A exportação de logs gera um custo de transferência de dados. O custo exato da transferência de dados varia dependendo do destino, da região e do provedor de nuvem.

  • Problemas ou tentativas de rede podem causar entradas de log duplicadas em seu bucket do Google Cloud armazenamento.

Você precisará de:

  • Um bucket de armazenamento do Google Cloud existente.

  • Uma conta do Google Cloud armazenamento autorizada para acesso do Atlas.

  • Um Atlas cluster M10+ executando o MongoDB 7.0 ou posterior.

Para exportar registros para um bucket do Google Cloud Storage, complete as etapas a seguir.

1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto 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. Na barra lateral, clique no ícone ao lado de Project Overview.

A página Configurações do projeto é exibida.

2

Clique na aba Integrations.

A página Integrações de projeto é exibida.

3
4
  1. Na lista suspensa Service Account, selecione a conta de serviço do Google Cloud para o Atlas gravar registros em seu bucket do Google Cloud armazenamento.

    Para adicionar uma conta de serviço, consulte Configurar e gerenciar o acesso à conta de serviço do Google Cloud.

  2. Clique em Next.

5
  1. No campo Bucket Name, insira o nome do seu contêiner de armazenamento do Google Cloud Storage como ele aparece em sua conta do Google Cloud.

  2. No campo Prefix path, insira um nome de diretório para organizar o conteúdo do seu contêiner de armazenamento do Google Cloud Storage. Por exemplo, inserir logs/ cria um diretório logs no seu contêiner de armazenamento do Google Cloud Storage para armazenar os registros exportados.

  3. Em Log Type, selecione os tipos de logs que deseja exportar.

    • MongoDB Logs Registros de diagnóstico escritos por cada processo do servidor mongod. Eles registram a inicialização e o desligamento do servidor , a configuração, as conexões, queries lentas, replicação, atividade de fragmentação e outros eventos operacionais.

    • MongoDB Audit Logs Registros de auditoria emitidos pelo mongod que acompanham as ações de evento do sistema, como tentativas de autenticação, verificações de autorização, alterações de função e outras operações relevantes para a segurança. Esses logs são separados do log principal do MongoDB.

    • MongoDB Router Logs Registros de diagnóstico escritos por cada processo de roteador domongos em um cluster fragmentado. Elas capturam o comportamento específico do roteador, como roteamento de queries para fragmentos, atualizações de metadados de fragmentação e diagnóstico geral de processos.

    • MongoDB Router Audit Logs Logs de auditoria emitidos por processos do roteador mongos, registrando os mesmos tipos de eventos do sistema auditados, mas da perspectiva do roteador em uma implantação fragmentada.

    • Events Eventos do Project Activity Feed, como eventos do ciclo de vida da integração e alterações de status de exportação de log. Para saber mais, consulte Exportar eventos do feed de atividades para FERRAMENTAS externas.

    Para saber mais sobre os logs do MongoDB, consulte Exibir e baixar registros do MongoDB.

    Para saber mais, consulte Exibir e baixar logs do MongoDB.

  4. Clique em Next.

6
  1. Siga as etapas do Console do Google Cloud ou do Atlas CLI descritas na IU do Atlas.

  2. Clique em Validate para confirmar que suas configurações e credenciais estão corretas antes de habilitar a exportação.

7

O Atlas notifica você automaticamente quando as exportações de log falham ou são recuperadas por meio de alertas padrão que estão habilitados para todos os projetos.

Os seguintes alertas estão habilitados por padrão para todos os projetos com External Log Sinks:

Esses alertas são informativos, o que significa que, quando a condição de alerta é atendida, o Atlas envia imediatamente notificações por e-mail para todos os usuários com a função Project Owner e log o alerta no Project Activity Feed. Esses alertas não aparecem nas abas Open Alerts ou Closed Alerts da página Project Alerts. Você pode personalizar os destinatários das notificações e os métodos nas configurações do Project Alerts. Para aprender mais sobre o ciclo de vida do alerta informativo, consulte Fluxo de trabalho de alertas.

Além dos alertas, o Atlas log os seguintes eventos informativos para o Project Activity Feed:

  • Log export has recovered. Queued logs are ready to resume sending.

  • Log export has recovered. Queued logs are now being sent.

  • All queued logs have been delivered to sink.

Para visualizar esses evento, consulte Visualizar feed de atividades.

Para obter mais informações sobre como configurar notificações de alerta, consulte Configurar um alerta.