This version of the documentation is archived and no longer supported.

Troubleshoot SNMP

On this page

New in version 2.6.

Enterprise Feature

SNMP is only available in MongoDB Enterprise.


MongoDB Enterprise can provide database metrics via SNMP, in support of centralized data collection and aggregation. This document identifies common problems you may encounter when deploying MongoDB Enterprise with SNMP as well as possible solutions for these issues.

See Monitor MongoDB With SNMP on Linux and Monitor MongoDB Windows with SNMP for complete installation instructions.


Failed to Connect

The following in the mongod logfile:

Warning: Failed to connect to the agentx master agent

AgentX is the SNMP agent extensibility protocol defined in Internet RFC 2741. It explains how to define additional data to monitor over SNMP. When MongoDB fails to connect to the agentx master agent, use the following procedure to ensure that the SNMP subagent can connect properly to the SNMP master.

  1. Make sure the master agent is running.
  2. Compare the SNMP master’s configuration file with the subagent configuration file. Ensure that the agentx socket definition is the same between the two.
  3. Check the SNMP configuration files to see if they specify using UNIX Domain Sockets. If so, confirm that the mongod has appropriate permissions to open a UNIX domain socket.

Error Parsing Command Line

One of the following errors at the command line:

Error parsing command line: unknown option snmp-master
try 'mongod --help' for more information
Error parsing command line: unknown option snmp-subagent
try 'mongod --help' for more information

mongod binaries that are not part of the Enterprise Edition produce this error. Install the Enterprise Edition and attempt to start mongod again.

Other MongoDB binaries, including mongos will produce this error if you attempt to star them with snmp-master or snmp-subagent. Only mongod supports SNMP.

Error Starting SNMPAgent

The following line in the log file indicates that mongod cannot read the mongod.conf file:

[SNMPAgent] warning: error starting SNMPAgent as master err:1

If running on Linux, ensure mongod.conf exists in the /etc/snmp directory, and ensure that the mongod UNIX user has permission to read the mongod.conf file.

If running on Windows, ensure mongod.conf exists in C:\snmp\etc\config.