Grafana Agent Charmed Operator for K8s

Welcome to the Grafana Agent Charmed Operator for K8s documentation!

This Charmed Operator handles instantiation, scaling, configuration, optimisation, networking, service mesh, observability, and Day 2 operations specific to Grafana Agent.

On the principle that an operator should “do one thing and do it well”, this operator drives Grafana Agent application only. However, it can be composed with other operators to deliver a complex application or service. Because operators package expert knowledge in a reusable and shareable form, they hugely simplify software management and operations.

Getting started

Basic deployment

Create a Juju model for your operator, say “observability”

juju add-model observability

The Grafana Agent Charmed Operator may be deployed using the Juju command line in a quite very way.

 juju deploy grafana-agent-k8s --channel edge

Checking deployment status

Once the Charmed Operator is deployed, the status can be checked running:

juju status

Model          Controller  Cloud/Region        Version  SLA          Timestamp
observability  charm-dev   microk8s/localhost  2.9.22   unsupported  10:46:32-03:00

App                Version  Status  Scale  Charm              Store     Channel  Rev  OS          Address         Message
grafana-agent-k8s           active      1  grafana-agent-k8s  charmhub  edge       5  kubernetes  10.152.183.232  

Unit                  Workload  Agent  Address      Ports  Message
grafana-agent-k8s/0*  active    idle   10.1.157.90   

As we can appreciate, deploying Grafana Agent in Kubernetes using Juju involves only two commands!

OCI Images

Every release of the Grafana Agent Charmed Operator uses the latest stable version of grafana/agent at the time of release.

Official Documentation

For further details about Grafana Agent configuration and usage, please refer to Grafana Agent Documentation