Skip to main content

PyPI version Build Status Python 27 Python 36

mtools is a collection of helper scripts to parse, filter, and visualize MongoDB log files (mongod, mongos). mtools also includes mlaunch, a utility to quickly set up complex MongoDB test environments on a local machine.

mtools box

What’s in the box?

The following tools are in the mtools collection:

mlogfilter

slices log files by time, merges log files, filters slow queries, finds table scans, shortens log lines, filters by other attributes, convert to JSON

mloginfo

returns info about log file, like start and end time, version, binary, special sections like restarts, connections, distinct view

mplotqueries

visualize log files with different types of plots (requires matplotlib)

mlogvis

creates a self-contained HTML file that shows an interactive visualization in a web browser (as an alternative to mplotqueries)

mlaunch

a script to quickly spin up local test environments, including replica sets and sharded systems (requires pymongo)

For more information, see the mtools documentation.

Requirements and Installation Instructions

The mtools collection is written in Python, and most of the tools only use the standard packages shipped with Python. The tools are currently tested with Python 2.7 and 3.6.

Some of the tools have additional dependencies, which are listed under the specific tool’s section. See the installation instructions for more information.

The mtools suite is only tested with actively supported (non End-of-Life) versions of the MongoDB server. As of April 2018, that includes MongoDB 3.2 or newer.

Recent Changes

See Changes to mtools for a list of changes from previous versions of mtools.

Contribute to mtools

If you’d like to contribute to mtools, please read the contributor page for instructions.

Disclaimer

This software is not supported by MongoDB, Inc. under any of their commercial support subscriptions or otherwise. Any usage of mtools is at your own risk. Bug reports, feature requests and questions can be posted in the Issues section on GitHub.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mtools-1.5.2.tar.gz (2.9 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mtools-1.5.2-py2-none-any.whl (2.0 MB view details)

Uploaded Python 2

File details

Details for the file mtools-1.5.2.tar.gz.

File metadata

  • Download URL: mtools-1.5.2.tar.gz
  • Upload date:
  • Size: 2.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/39.1.0 requests-toolbelt/0.8.0 tqdm/4.23.1 CPython/2.7.14

File hashes

Hashes for mtools-1.5.2.tar.gz
Algorithm Hash digest
SHA256 a0ca9338e1c92d3fc4821baa792a80e54b9a9e0ca3c6bbe8b9c47556e3587d5e
MD5 3d1dea3e5b7bbdb2b11313efbb758245
BLAKE2b-256 6fcdd222c30e5720ee8833ff8afaa8a2e7b9583b0a8a4ed1484dab9a0e2ecc6d

See more details on using hashes here.

File details

Details for the file mtools-1.5.2-py2-none-any.whl.

File metadata

  • Download URL: mtools-1.5.2-py2-none-any.whl
  • Upload date:
  • Size: 2.0 MB
  • Tags: Python 2
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/39.1.0 requests-toolbelt/0.8.0 tqdm/4.23.1 CPython/2.7.14

File hashes

Hashes for mtools-1.5.2-py2-none-any.whl
Algorithm Hash digest
SHA256 742a3fcf678507fc4137c1e2a113fd0a9e7572e6e830c35617ef1b4278843411
MD5 7ee99b664c00283426dbb2c3f73d33c3
BLAKE2b-256 b5b09bec4d1759186b1cbde241cdd3e3c436bb56f6b1f57815d9edbcabe4a8c7

See more details on using hashes here.

Release history Release notifications | RSS feed

1.7.2

2 files

1.7.1

2 files

1.7.0

2 files

1.6.4

2 files

1.6.3

2 files

1.6.2

2 files

1.6.1

2 files

1.6.0

2 files

1.5.3

2 files

This release

1.5.2 This release

2 files

1.5.1

2 files

1.5.0

2 files

1.4.1

2 files

1.4.0

2 files

1.3.2

2 files

1.3.1

2 files

1.3.0

1 file

1.2.3

1 file

1.2.2

1 file

1.2.1

1 file

1.2.0

1 file

1.1.9

1 file

1.1.8

1 file

1.1.7

1 file

1.1.6

1 file

1.1.5

1 file

1.1.4

1 file

1.1.3

1 file

1.1.2

1 file

1.1.1

1 file

1.1.0

1 file

1.0.5

1 file

1.0.4

1 file

1.0.3

1 file

1.0.2

1 file

1.0.1

1 file

1.0.0

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page