Learn the "why" behind slow queries and how to fix them in our 2-Part Webinar.
Register now >
Menu Docs
Página inicial do Docs
/ /

Exportar logs para AWS S3 blocos

Você pode configurar seus clusters do M10+ Atlas para exportar logs do sistema a cada minuto para um bucket do AWS S3.

Essa integração permite:

  • Especifique quais arquivos de log do MongoDB você deseja exportar para o bucket S3. 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 a você exportar logs para vários blocos AWS S3 simultaneamente.

  • Envie logs para um ponto de acesso multirregional (MAP) S3 configurando a integração com o ARN do RMAP. Atualmente, você só pode configurar ARNs IRA usando a Atlas Administration API. Os aliases de MAP não são aceitos.

Importante

Logs podem conter informações confidenciais (incluindo PII). Você é responsável pelo armazenamento e tratamento de seus logs em seu bucket do AWS S3. Para que o Atlas edite determinadas informações antes de exportar os logs, entre em contato com osuporte do MongoDB .

Para exportar logs para um AWS S3 bucket, você deve ter acesso 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 novas tentativas de rede podem causar entradas de logs duplicadas em seu bucket AWS S3.

  • The AWS IAM role and the S3 bucket must belong to the same AWS account.

Você precisará de:

  • Uma função do AWS IAM com sts:AssumeRole que concede ao Atlas acesso ao seu recurso do AWS com uma duração máxima de sessão definida como 12 horas.

  • Um bucket AWS S3 existente.

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

Para exportar logs para um bucket do AWS S3, 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 em Project Settings.

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 Authorize an AWS IAM Role, selecione seu ARN. Para adicionar um ARN, consulte Configurar o Acesso AWS Unificado.

  2. Clique em Next.

5
  1. No campo Bucket Name, insira o nome do seu bucket S3 como ele aparece em sua conta AWS.

  2. No campo Prefix, insira um nome de diretório para organizar o conteúdo do seu bucket S3. Por exemplo, inserir logs/ cria um diretório logs no seu bucket S3 para armazenar os logs 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.

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

  4. (Opcional) Se você deseja criptografar os registros em seu contêiner S3, insira sua chave ARN do AWS Key Management Service (KMS) no campo KMS Key. Para saber mais, consulte Gerenciar chaves de cliente com o AWS KMS.

  5. Clique em Next.

6
  1. Clique em para copiar a política de acesso gerada pelo Atlas e salvá-la localmente com o nome do arquivo: AtlasS3LogExportPolicy.

  2. Clique em para copiar o comando CLI gerado pelo Atlas e, em seguida, execute o comando em seu terminal para anexar a política de acesso à sua função AWS IAM.

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

7

Para garantir que você seja notificado se o Atlas parar de exportar logs para seu coletor externo, configure um alerta em nível de projeto:

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. Clique no ícone Alerts na barra de navegação.

  4. Clique em Alerts sob o cabeçalho Project.

A página Alertas do projeto é exibida.

2
3

No menu suspenso Condition/Metric , selecione Log export is unable to export logs on this host.

4
  1. Na seção Add Notification Method, selecione na lista de funções.

  2. No menu suspenso Add Notifier, selecione a partir das opções descritas na tabela a seguir.

    Opção de notificação
    Descrição

    Projeto Atlas

    Envia o alerta por e-mail ou mensagem de texto aos usuários com funções específicas no Projeto.

    O Projeto Atlas é o destinatário de alerta padrão. Você pode configurar os roles para os quais o alerta é enviado e como ele é entregue. Você não pode adicionar um segundo projeto Atlas como destinatário.

    O Projeto Atlas está disponível como uma opção na lista Add apenas se não estiver atualmente na lista de destinatários.

    1. Marque as funções do Projeto que devem receber os alertas das caixas de seleção Select Role(s) ou marque All Roles para que todos os usuários do Projeto recebam o alerta.

    2. Selecione SMS para enviar esses alertas para o número de celular configurado para cada usuário do Atlas Project na página Conta.

    3. Selecione Email para enviar estes alertas para o endereço de e-mail configurado para cada usuário do Atlas Project em sua página Conta. Email está marcado por padrão.

    Organização Atlas

    Envia o alerta por e-mail ou mensagem de texto aos usuários com funções específicas na organização.

    1. Marque os roles da organização que devem receber os alertas nas caixas de seleção Select Role(s) ou selecione All Roles para que todos os usuários da organização recebam o alerta.

    2. Selecione SMS para enviar estes alertas para o número de celular configurado para cada usuário da Organização Atlas na página Conta.

    3. Selecione Email para enviar esses alertas para o endereço de e-mail configurado para cada usuário Atlas organização página Conta. Email está marcado por padrão.

    Atlas user

    Envia o alerta por e-mail ou mensagem de texto para um Atlas user especificado.

    1. Selecione SMS para enviar estes alertas para o número de celular configurado para o usuário do Atlas em sua página Conta.

    2. Selecione Email para enviar esses alertas para o endereço de e-mail configurado para Atlas user na página Conta. Email está marcado por padrão.

    Email

    Envia o alerta para um endereço de e-mail.

    SMS

    Envia o alerta para um número de celular. O Atlas remove todas as pontuações e letras e usa somente os dígitos. Se você estiver fora dos Estados Unidos ou do Canadá, inclua 011 e o código do país porque o Atlas usa o Twilio, com sede nos EUA, para enviar mensagens de texto. Como alternativa ao seu serviço fora dos EUA. use um número de telefone do Google voice.

    Por exemplo, digite 01164 antes do número de telefone para enviar o alerta para um número de celular da Nova Zelândia.

    Slack

    Envia o alerta para um canal do Slack. Insira o nome do canal e um token API ou um token do Bot. Para criar um token de API, consulte a página https://api.slack.com/web na página na sua conta do Slack. Para saber mais sobre os usuários de Bot no Slack, consulte https://api.slack.com/bot-users.

    Depois de criar uma notificação que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

    • Visualize ou edite o alerta por meio da UI do Atlas.

    • Acesse o query de alerta para a notificação na API de administração do Atlas.

    PagerDuty

    Envia o alerta para uma conta PagerDuty. Insira apenas a chave de serviço PagerDuty. Defina regras de escalonamento e atribuições de alerta diretamente no PagerDuty.

    Os usuários podem confirmar os alertas PagerDuty apenas no dashboard do PagerDuty.

    Todas as novas chaves do PagerDuty usam a API de eventos v2.

    Se você tiver uma chave de API de eventos v1, poderá continuar a usar essa chave com o Atlas.

    Depois de criar uma notificação que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

    • Visualize ou edite o alerta por meio da UI do Atlas.

    • Acesse o query de alerta para a notificação na API de administração do Atlas.

    Datadog

    Envia o alerta para uma conta Datadog como um evento Datadog.

    Quando o alerta é aberto pela primeira vez, o Atlas envia o alerta como um evento de "erro". Atualizações subsequentes são enviadas como eventos de "info". Quando o alerta é fechado, o Atlas envia um evento de "sucesso".

    1. Insira sua chave API do DataDog em API Key e clique em Validate Datadog API Key.

    2. Insira sua região de API .

      O Atlas é compatível com as seguintes regiões do Datadog na UI do Atlas:

      • US1

      • US3

      • US5

      • EU1

      • AP1

      O Datadog utiliza US1 por padrão.

      Para saber mais sobre as regiões de Datadog, consulte Sites de Datadog.

      Depois de criar uma notificação que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

      • Visualize ou edite o alerta por meio da UI do Atlas.

      • Acesse o query de alerta para a notificação na API de administração do Atlas.

    3. (Opcional) Para habilitar o rastreamento de métricas do banco de dados , alterne Send Database Metrics para On.

    4. (Opcional) Para habilitar o rastreamento de métricas de latência de coleção, alterne Send Collection Latency Metrics para On.

    5. (Opcional) Para habilitar o rastreamento de métricas de forma de query , alterne Send Query Shape Metrics para On.

    6. Clique em Save.

    VictorOps

    Envia o alerta para uma conta VictorOps.

    Insira a chave API alfanumérica da VictorOps para integrar o ponto de extremidade VictorOps com alertas. Adicione traços à chave API para que ela corresponda ao formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Por exemplo, 489f7he7-790b-9896-a8cf-j4757def1161. Insira uma chave de roteamento opcional para direcionar alertas para um grupo VictorOps específico. Clique em Post Test Alert para testar a configuração do VictorOps. Defina as regras de roteamento e escalonamento diretamente no VictorOps.

    Essa opção está disponível apenas para alertas que exigem confirmação. Você pode receber alertas informativos deste serviço de monitoramento de terceiros no Atlas. No entanto, você deve resolver esses alertas no serviço externo. Confirme os alertas VictorOps no dashboard do VictorOps.

    Depois de criar uma notificação que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

    • Visualize ou edite o alerta por meio da UI do Atlas.

    • Acesse o query de alerta para a notificação na API de administração do Atlas.

    Opsgenie

    Envia o alerta para uma conta Opsgenie. Insira apenas a chave API Opsgenie. Defina regras de escalonamento e atribuições de alerta diretamente no Opsgenie.

    Essa opção está disponível apenas para alertas que exigem confirmação. Você pode receber alertas informativos deste serviço de monitoramento de terceiros no Atlas. No entanto, você deve resolver esses alertas no serviço externo. Confirme os alertas do Opsgenie no dashboard do Opsgenie.

    Depois de criar uma notificação que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

    • Visualize ou edite o alerta por meio da UI do Atlas.

    • Acesse o query de alerta para a notificação na API de administração do Atlas.

    Equipes da Microsoft

    Envia o alerta para um canal do Microsoft Teams como um Cartão adaptativo.

    Para enviar notificações de alerta para um canal do Microsoft Teams, você deve criar um webhook de entrada do Microsoft Teams. Após criar o webhook, você pode utilizar o URL gerado automaticamente para configurar sua integração do Microsoft Teams no Atlas.

    Para configurar a integração, consulte Integração com o Microsoft Teams.

    Quando você visualiza ou edita o alerta para uma notificação do Microsoft Teams, a URL aparece parcialmente oculta.

    Webhook

    Envia uma solicitação POST HTTP para um endpoint para processamento programático. O corpo da solicitação contém um documento JSON que usa o mesmo formato do recurso de alertas de API de administração do Atlas.

    Essa opção estará disponível somente se você tiver definido as configurações de Webhook na página Integrações.

    Quando você exibe ou edita o alerta de uma notificação de webhook, o URL aparece parcialmente redigido, e o segredo aparece completamente redigido.

    1. No campo Webhook URL, especifique a URL de destino para alertas baseados em webhook.

    2. (Opcional) Se você configurar sua integração do webhook com um segredo, no campo Webhook Secret, especifique o segredo de autenticação para alertas baseados em webhook.

  3. Na seção Recurrence, defina o alerta para acionar quando a condição de falha na exportação de registro durar mais de 60 minutos e para reenviar a cada 10080 minutos (7 dias) até que o problema seja resolvido.

    Dessa forma, você será notificado se as falhas na exportação de log persistirem por um longo período, evitando notificações excessivas para problemas transitórios.

5

Para obter mais detalhes sobre a configuração de alertas, consulte Configurar um alerta.

Voltar

Revisar e baixar registros

Nesta página