Learn about our RFC process, Open RFC meetings & more.Join in the discussion! »

This package has been deprecated

Author message:

renamed to mongo-monitor: please use 'npm i mongo-monitor' to update

mongo-monitor-cli

0.3.0 • Public • Published

mongo-monitor

CircleCI codecov Greenkeeper badge

Simple CLI to monitor the status of a MongoDB cluster.

mongo-monitor mongodb://address:27017

Replicaset Screenshot

The connection string is handled with mongo-connection-string, which means it'll handle input which is not URI encoded.

Install with:

npm install mongo-monitor-cli

Usage

The monitor is primary designed to show the status of a MongoDB cluster, updated real-time. This is useful when performing administrative operations such as replicaset or shard configuration.

On a sharded cluster, if you provide a connection string with admin priviledges to any mongos host, you will see the sharding configuration.

On a replicaset, if you provide a connection string with admin priviledges to any host, or to the entire set, you will see the replicaset configuration:

Replicaset Screenshot

For a standalone, basic info is reported. Sharded clusters show details of the shards, as welll as the replicasets which make up each shard:

Sharded Cluster Screenshot

Samples

To try the monitor out, there are a few samples you can try.

Monitor a standalone instance:

make sample-standalone
mongo-monitor localhost:271017

Monitor a replicaset:

make sample-replicaset
mongo-monitor localhost:27017,localhost:27018,localhost:27019?replicaSet=cluster

Monitor a sharded cluster:

make sample-shard
mongo-monitor localhost

Cleanup sample processes:

make sample-shutdown

Developing

Lint with npm run lint, test with npm test, release with npm run release.

Tests

The following files are useful for testing:

File Notes
shard.isMaster.json The output of isMaster for a mongos member of a sharded cluster.
shard.listShards.json The output of listShards for a mongos member of a sharded cluster.
shard.node.isMaster.json The output of isMaster for a mongod member of a sharded cluster.

Keywords

none

Install

npm i mongo-monitor-cli

DownloadsWeekly Downloads

3

Version

0.3.0

License

ISC

Unpacked Size

909 kB

Total Files

31

Last publish

Collaborators

  • avatar