MOPS
A command-line interface for performing MongoDB Cloud Manager | Ops Manager tasks through their Public API.
Benefits
- Easily do things from the terminal that are available to the UI and API.
- Quickly add new commands to automate things you'd like.
- Quickly move data back and forth between Cloud Manager an Ops Manager.
- Run custom analytics on permformance metrics data in Excel, R, etc.
- Leverages node-mms-client JS API wrapper, a Node wrapper around the public API.
Installation
You can install the mops-cli npm package directly.
npm install -g mops-cli
Commands
The core mops commands are documented below.
configure
configure login
mops configure login -h HOSTNAME -p PORT -u USERNAME -a APIKEY
Set user credentials for MongoDB Cloud Manager | Ops Manager
| Options | Description | Default |
|---|---|---|
| -h, --host [host] | The API endpoint hostname | cloud.mongodb.com |
| -p, --port [port] | The API endpoint port | 443 |
| -P, --protocol [protocol] | The API endpoint protocol | https |
| -u, --user [user] | Email address or username accessing the API | |
| -a, --apiKey [apiKey] | The specified user's API key |
configure defaults
mops configure defaults -g GROUPID
Set defaults to prevent always specifying options on the command line.
| Options | Description | Default |
|---|---|---|
| -g, --groupId [groupId] | Group identifier |
groups
groups list
mops groups list
Display all current groups (JSON)
groups delete
mops groups delete -n GROUPNAME
Create new alert configurations
| Options | Description | Default |
|---|---|---|
| -n, --name [name] | Group name |
groups create
mops groups create -n GROUPNAME
hosts
hosts list
mops hosts list -g GROUPID
Display all current hosts (JSON)
| Options | Description | Default |
|---|---|---|
| -g, --groupId [groupId] | Group identifier |
metrics
metrics csv
mops metrics csv -g GROUPID -h HOSTID
Export all metrics for the specified host in CSV format
| Options | Description | Default |
|---|---|---|
| -g, --groupId [groupId] | Group identifier | |
| -h, --hostId [hostId] | Host identifier | |
| -G, --granularity [granularity] | Granularity | MINUTE |
| -P, --period [period] | Period | P1DT24H |
alertConfigs
alertConfigs list
mops alertConfigs list -g GROUPID
Display all current alert configurations (JSON)
| Options | Description | Default |
|---|---|---|
| -g, --groupId [groupId] | Group identifier |
alertConfigs create
mops alertConfigs create -g GROUPID -f myAlerts.json
Create new alert configurations
| Options | Description | Default |
|---|---|---|
| -g, --groupId [groupId] | Group identifier | |
| -f, --file [filename] | JSON file of alert configs |
alertConfigs edit
mops alertConfigs edit -g GROUPID -i ALERTCONFIGID
Edit specified alertConfig in your text editor
| Options | Description | Default |
|---|---|---|
| -g, --groupId [groupId] | Group identifier | |
| -i, --alertConfigId [alertConfigId] | Alert Configuration identifier |
automationConfig
automationConfig edit
mops automationConfig edit -g GROUPID
Edit the current automationConfig in your text editor
| Options | Description | Default |
|---|---|---|
| -g, --groupId [groupId] | Group identifier |
Example Workflows
Copying alerts configuration from one group to another
mops alertConfigs list -g GROUPID > myAlerts.json
mops alertConfigs create -g GROUPID -f myAlerts.json
Note: You can do a mops configure login between these two commands to change username, API key, even hosts (i.e., move from Cloud Manager to Ops Manager)
Exporting host metrics into CSV format (for Excel, R, etc.)
Run mops host list to get a list of all the host IDs in your group.
Then run mops metrics csv -g GROUPID -h HOSTID > hostMetrics.csv to put all that host's metrics into a CSV file.
License
Licensed under the MIT license.
Contributors
- Dennis Kuczynski @denniskuczynski
- Emily Pakulski @ohEmily
- Peter Gravelle @pcgMongo
- Daiji Shikama @deerspace
Shout Outs
mops-cli is a MongoDB Skunkworks Project
