+2

LMA Light

  • By Leon
juju deploy lma-light --channel edge
Show information
You will need Juju 2.9 to be able to run this command. Learn how to upgrade to Juju 2.9.
Channel Version Revision Published Base
latest/edge 8 8 12 Oct 2021

Platform:

About

Bundle for LMA-Light observability stack Read more


Relevant links


Discuss this bundle

Share your thoughts on this charm with the community on discourse.

Join the discussion

LMA Light bundle

At Canonical, LMA stands for "Logs, Metrics and Alerts", and is a moniker to describe observability stacks. This Juju bundle deploys such an observability stack, called "LMA Light", based on consisting of the following interrelated charms:

This bundle is under development. Join us on Discourse and MatterMost!

The Vision

LMA Light is going to be the go-to solution for monitoring Canonical appliances when the end user does not already have an established observability stack. LMA Light is designed for:

  • Best-in-class monitoring of software charmed with Juju
  • Limited resource consumption
  • High integration and out-of-the-box value
  • Running on MicroK8s

After the GA of LMA Light, we will be working on a High-Availability Bundle (LMA HA), that will use the same components as LMA Light (plus additional ones) and provide the same overall user-experience, and focus on scalability, resilience and broad compatibility with Kubernetes distributions out there.

Usage

Before deploying the bundle you may want to create a dedicated model for it:

juju add-model lma
juju switch lma

You can deploy the bundle from charmhub with:

juju deploy lma-light --channel=edge --trust

or, to deploy the bundle from a local file:

# generate and activate a virtual environment with dependencies
tox -e integration --notest
source .tox/integration/bin/activate

# render bundle with default values
./render_bundle.py bundle.yaml
juju deploy ./bundle.yaml --trust

Currently the bundle is available only on the edge channel, using edge charms. When the charms graduate to beta, candidate and stable, we will issue the bundle in the same channels.

The --trust option is needed by the charms in the lma-light bundle to be able to patch their K8s services to use the right ports (see this Juju limitation).

We also make available some overlays as convenience. A Juju overlay is a set of model-specific modifications, which reduce the amount of commands needed to set up a bundle like LMA Light. Specifically, we offer the following overlays:

  • the offers overlay exposes as offers the relation endpoints of the LMA Light charms that are likely to be consumed over cross-model relations.
  • the storage-small overlays provides a setup of the various storages for the LMA Light charms for a small setup. Using an overlay for storage is fundamental for a productive setup, as you cannot change the amount of storage assigned to the various charms after the deployment of LMA Light.

In order to use the overlays above, you need to:

  1. Download the overlays (or clone the repository)
  2. Pass the --overlay <path-to-overlay-file-1> --overlay <path-to-overlay-file-2> ... arguments to the juju deploy command

For example, to deploy the LMA Light bundle with the offers overlay, you would do the following:

curl -L https://raw.githubusercontent.com/canonical/lma-light-bundle/main/overlays/offers-overlay.yaml -O

juju deploy lma-light --channel=edge --overlay ./offers-overlay.yaml