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

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

In the event of any inconsistency between the English version and the translated version, the English versionwill take priority. Please visit this page for more information.

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.