Docs4dev
Docs
mongodb / v3.6 / reference / tutorial-monitor-with-snmp.html

Monitor MongoDB With SNMP on Linux

On this page

Enterprise Feature

SNMP is only available in MongoDB Enterprise .

Overview

MongoDB Enterprise can provide database metrics via SNMP, in support of centralized data collection and aggregation. This procedure explains the setup and configuration of a mongod instance as an SNMP subagent, as well as initializing and testing of SNMP support with MongoDB Enterprise.

See also

Troubleshoot SNMP and Monitor MongoDB Windows with SNMP for complete instructions on using MongoDB with SNMP on Windows systems.

Considerations

  • SNMP support is only available in mongod. Other MongoDB tools such as mongos do not support SNMP.
  • mongod does not support the use of SNMP traps.

Configuration Files

MongoDB Enterprise includes the following SNMP configuration files:

  • MONGOD-MIB.txt:

    The management information base (MIB) file that defines MongoDB’s SNMP output. On Ubuntu and Debian platforms, this file is shipped compressed as MONGOD-MIB.txt.gz and must be decompressed with gunzip.

  • mongod.conf.subagent:

    The configuration file to run mongod as the SNMP subagent. This file sets SNMP run-time configuration options, including the agentXSocket to connect to the SNMP master.

  • mongod.conf.master:

    The configuration file to run mongod as the SNMP master. This file sets SNMP run-time configuration options, including the agentaddress to run on.

The MongoDB SNMP configuration files are provided with your MongoDB Enterprise installation, as follows:

  • If you installed MongoDB Enterprise via a package manager, these files are installed to the following directory as part of the package installation process:

    Platform Path
    RHEL / CentOS /usr/share/doc/mongodb-enterprise-server-3.6.19
    Ubuntu / Debian /usr/share/doc/mongodb-enterprise-server
    SUSE /usr/share/doc/packages/mongodb-enterprise-server

  • If you installed MongoDB Enterprise from a .tgz tarball, these files were included in the tarball.

Procedure

1

Copy configuration files.

Copy the MongoDB SNMP configuration files from their installation location to their target directories, according to your platform:

  • RHEL / CentOS
  • Ubuntu / Debian
  • SUSE

  1. Navigate to the location where the SNMP files were installed. For example, if you installed the latest version of MongoDB via the yum package manager:

    cd /usr/share/doc/mongodb-enterprise-server-3.6.19

  2. Copy the two MongoDB SNMP files to their target directories:

    sudo cp MONGOD-MIB.txt /usr/share/snmp/mibs/
sudo cp mongod.conf.subagent /etc/snmp/mongod.conf

  1. Navigate to the location where the SNMP files were installed. For example, if you installed MongoDB via the apt package manager:

    cd /usr/share/doc/mongodb-enterprise-server

  2. Copy the MONGOD-MIB.txt.gz file to its target directory, and unzip it:

    sudo cp MONGOD-MIB.txt.gz /usr/share/snmp/mibs/
sudo gunzip /usr/share/snmp/mibs/MONGOD-MIB.txt.gz

  3. Copy the mongod.conf.subagent file to its target directory:

    sudo cp mongod.conf.subagent /etc/snmp/mongod.conf

  1. Navigate to the location where the SNMP files were installed. For example, if you installed the latest version of MongoDB via the zypper package manager:

    cd /usr/share/doc/packages/mongodb-enterprise-server

  2. Copy the two MongoDB SNMP files to their target directories:

    sudo cp MONGOD-MIB.txt /usr/share/snmp/mibs/
sudo cp mongod.conf.subagent /etc/snmp/mongod.conf
2

Configure SNMP.

Edit the /etc/snmp/snmpd.conf file, and add the following:

# sec.name          source         community
  com2sec local     localhost       mongodb
# group.name        sec.model  sec.name
  group MyRWGroup   any        local
# incl/excl   subtree            mask
  view all    included  .1       80
# context               sec.model sec.level prefix read   write  notif
  access MyRWGroup ""   any       noauth    0      all    all    all

master agentx
AgentXSocket /tmp/agentx/master
AgentXPerms 0777 0777 mongod mongod

  1. Install snmpd if it is not already installed:

    sudo apt-get install snmpd

  2. Edit the /etc/snmp/snmpd.conf file, and add the following:

    # sec.name          source         community
  com2sec local     localhost       mongodb
# group.name        sec.model  sec.name
  group MyRWGroup   any        local
# incl/excl   subtree            mask
  view all    included  .1       80
# context               sec.model sec.level prefix read   write  notif
  access MyRWGroup ""   any       noauth    0      all    all    all

AgentXSocket /tmp/agentx/master
AgentXPerms 0777 0777 mongodb mongodb

Edit the /etc/snmp/snmpd.conf file, and add the following:

# sec.name          source         community
  com2sec local     localhost       mongodb
# group.name        sec.model  sec.name
  group MyRWGroup   any        local
# incl/excl   subtree            mask
  view all    included  .1       80
# context               sec.model sec.level prefix read   write  notif
  access MyRWGroup ""   any       noauth    0      all    all    all

master agentx
AgentXSocket /tmp/agentx/master
AgentXPerms 0777 0777 mongod mongod

This configuration defines a UNIX domain socket for communication between the master (snmpd) and sub-agent (MongoDB), and defines basic SNMP permissions for access to the relevant MongoDB SNMP fields.

Note

To bind your master to a non-localhost IP address, add that IP address to the agentaddress field in the /etc/snmp/snmpd.conf file, and update the appropriate network security ACLs to permit a valid address range. An address range of 10.0.0.0/8 with a security name of “mynetwork” has been provided in the mongod.conf.master configuration file as an example.

The above configuration is given as an example only; you may wish to customize permissions based on your site security requirements. While MongoDB support can provide guidance on configuring MongoDB for SNMP, configuring SNMP on operating systems is out of scope.

3

Start SNMP.

Start SNMP on your system using the initialization system appropriate for your version of Linux:

  • For Linux systems using systemd (systemctl command):

    sudo systemctl start mongod

  • For Linux systems using System V init (service command):

    sudo service mongod start
4

Start MongoDB.

Start mongod with the snmp-subagent to send data to the SNMP master.

mongod --snmp-subagent
5

Confirm SNMP data retrieval.

Verify that MongoDB is accessible for SNMP queries with the snmpwalk testing command.

  1. Install snmpwalk on your system:

    sudo yum install net-snmp-utils

  2. Run snmpwalk with the following parameters to verify the ability to collect data from mongod:

    snmpwalk -m /usr/share/snmp/mibs/MONGOD-MIB.txt -v 2c -c mongodb 127.0.0.1:161 1.3.6.1.4.1.34601

  1. DEBIAN ONLY: If necessary, add the non-free repository to your /etc/apt/sources.list file to access the snmp-mibs-downloader package. For example, on Debian 9 “Stretch”, the primary repo entries might look like this:

    deb http://deb.debian.org/debian stretch main non-free
deb-src http://deb.debian.org/debian stretch main non-free

  2. DEBIAN / UBUNTU: Install the snmp-mibs-downloader package to supply necessary MIB files, then restart the snmpd service to reload the new MIB files:

    sudo apt-get update
sudo apt-get -y install snmp-mibs-downloader
sudo service snmpd re