https://github.com/tart/motop

"Top" clone for MongoDB
https://github.com/tart/motop

Last synced: 9 days ago
JSON representation

"Top" clone for MongoDB

• Host: GitHub
• URL: https://github.com/tart/motop
• Owner: tart
• Created: 2012-05-20T12:40:00.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2015-08-13T14:53:30.000Z (about 9 years ago)
• Last Synced: 2024-09-17T02:32:16.510Z (about 2 months ago)
• Language: Python
• Homepage:
• Size: 461 KB
• Stars: 67
• Watchers: 7
• Forks: 24
• Open Issues: 7
• Metadata Files:
  • Readme: README.rst

Awesome Lists containing this project

• awesome-mongodb - Motop - MongoDB top clone (Tools / Monitoring)
• awesome-mongodb - Motop - MongoDB top clone (Tools / Monitoring)

README

        
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`