Upgrading the Collector

❗️

Deprecated

As of January 2024, the Monte Carlo Data Collector Deployment Model has been deprecated in favor of the Agent and Object Storage Deployment models. Please see Architecture & Deployment Options for more information.

If you host a Data Collector you might need to occasionally upgrade it. Usually this is necessary when infrastructure changes are made, or if you disabled remote upgrades.

Upgrades are performed with the Monte Carlo CLI. The Collectors settings page that used to offer an Upgrade option has been retired, and its link now opens Settings > Deployments. Your collector is listed there, but it can't be upgraded from that page.

If you're planning a larger change, consider moving to an agent instead.

Upgrading a Data Collector via the CLI

❗️

This command performs operations in your AWS account (e.g. stack updates, gateway deployments, etc.)

To perform an upgrade:

  1. Follow this guide to install and configure the CLI (requires v0.9.0 or greater).
  2. Use the upgrade command to update your collector. It requires --aws-profile, the AWS profile used to update the collector's stack. Add --update-infra to update the infrastructure as well as the code. See the reference guide here.
montecarlo collectors upgrade --aws-profile <profile> --update-infra

And if you'd like to review the latest template this can be done via the get-template command.

If you have more than one collector the IDs and other details can be echoed via the list command.

As always if you have any questions please let your Monte Carlo representative know or ask Bayes, and we'd be happy to work with you to get you up and running!

FAQs

What does --update-infra do?

By default, upgrade updates only the code of the collector's Lambda functions. With --update-infra, it also updates the CloudFormation stack to the latest template, so infrastructure changes are applied too. get-template --update-infra returns that template's link if you'd rather review it, or apply it yourself.

Consider that some Monte Carlo features are only available on latest versions of both the infrastructure and code.


What’s Next

Continue to learn more about advanced configurations.

Did this page help you?