motop

"Top" clone for MongoDB.


Keywords
mongo, realtime, monitoring, examine, explain, kill, operations
License
Other
Install
pip install motop==4.2

Documentation

Motop

Realtime monitoring tool for several MongoDB servers. Shows current operations ordered by durations every second.

Usage

Install with easy_install:

easy_install motop

Install with pip:

pip install git+https://github.com/tart/motop.git

Download and install:

./setup.py install

Help:

motop -h

Monitor several servers:

motop 192.168.124.50 192.158.124.51

Actions

q Quit

p Pause

e Explain the query

k Kill operation using "mongo" executable

K Kill operations older than given seconds using "mongo" executable

r Try to reconnect to disconnected servers

R Try to reconnect to all servers

Dependencies

  • python 2.6 or greater
  • pymongo 2.0 or greater [1]

[1] http://pypi.python.org/pypi/pymongo/

Configuration (Optional)

Configuration file can be created to /etc/motop.conf.

There can be multiple sections on the configuration. Each section can include these parameters:

address
Address of the server (required)
username
Username to authenticate to the server
password
Password to authenticate to the server
status
Show status (default: on)
replicationInfo
Show replication status (default: on)
replicaSet
Show replica set status (default: on)
operations
Show operations (default: on)
replicationOperations
Show constantly appeared replication operations on the masters and the slaves (default: on)

"DEFAULT" is the special section. Parameters can be set as default in this section.

The names of the sections will be used as server names. These names can alse be used on arguments of the executable.

Example configuration:

[MongoDB01]
address=10.42.2.121
replicationOperations=off

[MongoDB02]
address=10.42.2.122

[MongoDB03]
address=10.42.2.123

[MongoDB04]
address=10.42.2.124
username=foo
password=bar

License

This tool is released under the ISC License, whose text is included to the source files. The ISC License is registered with and approved by the Open Source Initiative [1].

[1] http://opensource.org/licenses/isc-license.txt

Changelog

Motop 3.0

  • Change coding style according to the PEP 8 for more contribution
  • Improve human readable values
  • Fix replica set monitoring (UdjinM6)

Motop 3.1

  • Avoid crash for operations with missing fields
  • Avoid crash for failed explain, kill actions
  • Rename column State of the operation block
  • Show locks with operations

Motop 4.0

  • Avoid crash on missing data from server
  • Aviod crash on connection failures
  • Add reconnect buttons
  • Try to reconnect to disconnected servers after every 20 refreshes
  • Use username, password from the configuration instead of from the arguments

Motop 4.1

  • Avoid crash on replica set view

Motop 4.2

  • Support installation with pip