Using the CLI

👍

Looking for our CLI reference?

See here for documentation on all commands, options, and arguments.

This guide explains basic usage of Monte Carlo's CLI. See here for additional details and examples.

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 a key here by selecting "CREATE KEY" for either a personal or service account key:

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

❗️

Careful!

You are only able to see the Secret once! Save that in a safe place.

Choose the option you are comfortable with, and then click "CREATE". Then, input these details into your terminal. You will also be prompted to specify an AWS profile and region. This is technically optional and only necessary if you intend to interact with a Data Collector (like updated a self hosted Data Collector or auto-generating IAM roles for onboarding). If you do choose to specify a value, any AWS profiles or regions should be for the account the Data Collector is deployed in.

See here for more details on AWS profiles and note that if the region is left blank it will default to us-east-1.

After configuring you can validate your connection with:

montecarlo validate

Documentation

Documentation for commands, options, and arguments can be found here.

Otherwise, 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