• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

MongoDB monitoramento integração (legado)

IMPORTANTE!

Esta integração de legado está prevista para chegar ao fim em 2024: adicionaremos uma data EOL específica quando soubermos disso. Recomendamos usar nossa integração mais recente com o MongoDB. Para obter informações sobre como mudar da integração de legado para a nova, consulte nossos documentos de migração.

Nosso legado integração MongoDB coleta e envia inventário e métricas do seu cluster MongoDB para nossa plataforma, onde você pode agregar e visualizar as principais métricas de desempenho. Coletamos dados em instâncias mongos e mongod, servidores de configuração, bem como em banco de dados e coleções para ajudar a identificar o desempenho gargalo.

Compatibilidade e requisitos

Esta integração de legado é compatível com MongoDB v3 e v4. Nossa integração mais recente com o MongoDB oferece suporte a versões mais recentes.

Antes de instalar esta integração de legado, certifique-se de atender aos seguintes requisitos:

Instalar e ativar

Caso queira instalar nossa integração MongoDB herdada, siga as instruções para seu ambiente:

' '

Notas Adicionais:

Configuração

Habilitando seu servidor MongoDB

No shell do MongoDB, execute os comandos a seguir para criar uma função listCollections e um novo usuário. Em seguida, atribua funções clusterMonitor e listCollections ao novo usuário. Nota: Substitua nome de usuário, senha e valores semelhantes específicos do usuário.

Consulte a documentação do MongoDB para obter detalhes sobre a criação de usuários e funções.

Dica

Conclua estas etapas nos mongos a serem monitorados. Se forem coletadas métricas de nível mongod, como estatísticas de host ou conjunto de réplicas, crie também a função e o usuário em cada mongod.

  1. No shell do MongoDB, insira use admin.

  2. Use o comando a seguir para criar a função listCollections .

    db.createRole({
    role: "listCollections",
    privileges: [
    {
    resource: { db: "", collection: "" },
    actions: ["listCollections"],
    },
    ],
    roles: [],
    })
  3. Use os comandos a seguir para criar um novo usuário e atribuir funções clusterMonitor e listCollections ao usuário.

    db.createUser({
    user: "username",
    pwd: "password",
    roles: ["clusterMonitor", "listCollections"],
    })

Este documento ajudou você na instalação?

Configurar a integração

Existem diversas formas de configurar a integração, dependendo de como ela foi instalada:

A configuração no formato YAML de uma integração é onde você pode colocar as credenciais de login necessárias e configurar como os dados são coletados. Quais opções você altera dependem de sua configuração e preferência.

O arquivo de configuração possui configurações comuns aplicáveis a toda integração, como interval, timeout, inventory_source. Para ler tudo sobre essas configurações comuns, consulte nosso documento Formato de configuração .

Importante

Se você ainda estiver usando nossos arquivos de configuração/definição legados, consulte o formato de configuração padrão para obter ajuda.

Configurações específicas relacionadas ao MongoDB são definidas usando a seção env do arquivo de configuração. Essas configurações controlam a conexão com sua instância do MongoDB, bem como outras configurações e recursos de segurança. A lista de configurações válidas é descrita na próxima seção deste documento.

A integração do MongoDB pode ser configurada para monitor um cluster MongoDB completo ou uma instância autônoma do MongoDB. Para monitor um cluster, os argumentos host e port devem apontar para uma das instâncias mongos em seu cluster. Se desejar monitor uma instância independente, certifique-se de que host e port apontem para mongod executando o banco de dados.

Dica

A autenticação SCRAM não é suportada.

Configurações da instância do MongoDB

A integração MongoDB coleta informações métricas e de inventário. Na tabela a seguir, consulte a coluna Applies To para ver as configurações disponíveis para cada coleção.

Os valores para estas configurações podem ser definidos de diversas maneiras:

  • Adicionando o valor diretamente no arquivo de configuração. Esta é a forma mais comum.
  • Substituindo os valores das variáveis de ambiente usando a notação {{}} . Isto requer o agente de infraestrutura v1.14.0 ou superior. Para obter mais informações, consulte nossa documentação sobre passthrough ou veja o exemplo de substituição.
  • Usando gerenciamento de segredos. Use isto para proteger informações confidenciais, como senhas que seriam expostas em texto simples no arquivo de configuração. Para obter mais informações, consulte Gerenciamento de segredos.

' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '

Contexto

Descrição

Aplica-se a

MONGODB_CLUSTER_NAME

Nome definido pelo usuário para identificar exclusivamente o cluster que está sendo monitorado. Required.

Métrica/Inventário

HOST

Nome do host ou IP onde o MongoDB está rodando. O padrão é localhost.

Métrica/Inventário

PORT

Porta na qual o MongoDB está escutando. O padrão é 27017.

Métrica/Inventário

USERNAME

Nome de usuário para acessar o servidor MongoDB.

Métrica/Inventário

PASSWORD

Senha do usuário fornecido.

Métrica/Inventário

AUTH_SOURCE

O banco de dados para autenticação. O padrão é admin.

Métrica/Inventário

SSL

Use SSL ao se comunicar com o servidor MongoDB. O padrão é false.

Métrica/Inventário

SSL_CA_CERTS

Localização do certificado SSL no host. Obrigatório apenas se SSL for true.

Métrica/Inventário

SSL_INSECURE_SKIP_VERIFY

Ignore a verificação da cadeia de certificados e do nome do host do servidor. O padrão é false.

Métrica/Inventário

PEM_KEY_FILE

Localização do arquivo PEM contendo a chave privada e o certificado do cliente.

Métrica/Inventário

PASSPHRASE

Senha para descriptografar o arquivo PEMKeyFile .

Métrica/Inventário

CONCURRENT_COLLECTIONS

Número de entidades para as quais recolher métricas concomitantemente. O padrão é 50.

Métrica

FILTERS

Um mapa JSON de nomes de bancos de dados para uma matriz de nomes de coleções. Se estiver vazio, o padrão é todos os bancos de dados e coleções.

Métrica

METRICS

Defina como true para ativar a coleta somente de métricas. O padrão é false.

INVENTORY

Defina como true para ativar a coleta somente de inventário. O padrão é false.

Etiquetas e atributo personalizado

Você pode decorar ainda mais sua métrica usando etiquetas. Os rótulos permitem que você adicione atributo de par de valor principal à sua métrica, que você pode usar para consultar, filtrar ou agrupar sua métrica.

Nosso arquivo de configuração de amostra padrão inclui exemplos de rótulos; entretanto, como não são obrigatórios, você pode remover, modificar ou adicionar novos de sua preferência.

labels:
env: production
role: load_balancer

Exemplo de configuração

Encontre e use dados

Os dados deste serviço são reportados para um dashboard de integração.

métrica estão anexadas a estes tipos de eventos:

  • MongoCollectionSample
  • MongoConfigServerSample
  • MongoDatabaseSample
  • MongodTopSample
  • MongoSample
  • MongodSample
  • MongosSample

Você pode consultar esses dados para fins de resolução de problemas ou para criar gráficos e dashboards personalizados.

Para saber mais sobre como encontrar e usar seus dados, consulte Compreender os dados de integração.

Dados métricos

A integração MongoDB coleta os seguintes dados métricos atributo. Alguns nomes de métricas são prefixados com um indicador de categoria e um ponto, como asserts. ou collection..

Diferentes métricas estão disponíveis dependendo se um cluster ou uma instância autônoma está sendo monitorada. Para uma instância autônoma, apenas MongodSample, MongoDatabaseSample, MongodTopSample e MongoCollectionSample são coletados. Para um cluster, todos os tipos de eventos são coletados.

Dados de inventário

A integração do MongoDB captura todas as opções de linha de comando e parâmetros configurados em tempo de execução de cada host no cluster.

Os dados estão disponíveis na página Inventário, na origem config/mongodb . Para obter mais informações sobre dados de inventário, consulte Compreender os dados de integração.

Verifique o código-fonte

Esta integração é um software de código aberto. Isso significa que você pode navegar pelo código-fonte e enviar melhorias, ou criar seu próprio fork e construí-lo.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.