Using the CLI
This guide explains basic usage of Monte Carlo's CLI. The CLI provides commands that will help you set up integrations programmatically.
Installing/Update the CLI
The CLI requires Python 3.7 or greater.
To install or update the CLI, please run:
pip install -U montecarlodata
And then verify the installation using:
montecarlo --version


Setting up the CLI
To configure your CLI with your API key and other settings, please run:
montecarlo configure
You will then be prompted to add your Monte Carlo API key/secret information. You can generate that by going to the "Settings" tab, and then "API". Click on the "CREATE KEY" button:


You will then name your key and have the option to expire your key at varying intervals:


Choose the option you are comfortable with, and then click "CREATE".
Careful!
You are only able to see the Secret once! Save that in a safe place.
Input these details into your terminal:


AWS Profile
The AWS profile and region are only necessary if you host your own Data Collector. If Monte Carlo hosts your data collector, you can skip these entries.
If you do host your own data collector, you will need to run commands through a network that has access to the account the collector is in. Commands like adding a new integration will route from your local network to the network hosting the data collector; it does not run through Monte Carlo's environment.
Next, you are prompted to give your AWS details. It is technically optional to include the AWS settings when setting up the CLI. It is strongly recommended if you are hosting your own Data Collector, but only necessary if you need to do things like make an update to the collector. Any AWS profiles or regions should be for the account the Data Collector is deployed to.


Profile name obscured for security
The AWS profile can follow the pattern of accountid_permission
. For example, 12345678_AdministratorAccess
. See here for more details: https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html
The region will look like us-east-1
. If you leave this blank, we will default to us-east-1
.
And then verify the configuration using:
montecarlo validate


Documentation
To get high-level help, please run:
montecarlo --help
Similarly, you can get help for a specific set of commands:
montecarlo integrations --help
To retrieve documentation (help text) on all commands, subcommands and options:
montecarlo help
As an example, this is how you would list all active integrations:
montecarlo integrations list
Updated 2 months ago