Overview

LogicMonitor’s Kubernetes monitoring involves two semantically versioned applications: Argus and the Collectorset-Controller. New versions of these applications provide bug fixes, improvements, and new features. You can see the latest available versions of these applications (and the enhancements they provide) on their respective GitHub host pages.

• Argus
• Collectorset-Controller

Release Tagging

Argus images are tagged with semantic versioning in addition to a tag for the major version (for example, v5) which will match all images that get published with that major version (including minor improvement and bug fix increments). This ensures that new images with minor improvements and bug fixes are used automatically.

For example, for Argus version 5.0.0, the following tags are applied to the image: “v5” and “5.0.0”. If you reference “v5” in your Helm deployment at the time 5.0.0 is released, that tag would also match subsequent Argus versions 5.1.0, 5.1.1, and so on upon their release.

Opt-in is still required when a new major version is released. This means that if your Helm deployment for Argus and Collectorset-Controller currently references “latest” or hard-coded version image tags, you will need to opt into the upgrade using the instructions provided in the next section.

Opting In to Major Version Changes

Prerequisites

Ensure the following requirements are met before upgrading:

• Helm 3
• Kubernetes 1.14+

Upgrade Instructions

To upgrade the Argus chart from older versions to the latest version, you require an Argus configuration file for running the helm upgrade command.

Creating Argus configuration file

For creating .yaml configuration files for argus and collector-set controller, complete the following steps:

1. Download the configuration file template from here.

2. Get existing values using the command:

helm get values argus 

3. Save in the backup configuration file.

4. Put all existing values in the downloaded configuration file at their appropriate places. And leave the remaining values at their default.

Upgrading the Argus using Helm deployment

For upgrading to the latest version of Argus, complete the following steps:

1. Run helm repo update.
   
2. To upgrade the Argus helm chart, run the following command:
   
   helm upgrade -f argus-config.yaml argus logicmonitor/argus


Updating Configuration Parameters in the Configuration File

Export the configuration file path and enter the following helm command:

$ export ARGUS_CONF_FILE=<argus-configuration-file-path>
$ helm upgrade \
  --install \
  --debug \
  --wait \
  --namespace="$NAMESPACE" \
  -f "$ARGUS_CONF_FILE" \
  argus logicmonitor/argus

See the Configurations section for a list of values the Argus helm chart supports and their descriptions.

Configuration templates of Helm charts values.yaml

Collectorset Controller

Latest Collectorset-controller-config.yaml

Argus

Latest argus-config.yaml