COS components

This page describes the charms, rocks, and snaps that make up the current Observability 3.1 release (comprising both COS 3.1 and COS Lite 3.1). The LTS column indicates whether a component is part of the LTS set for this release; both LTS and non-LTS charms follow the release policy support windows; see that page for the end of support dates for each. Use the Track column to pick the right channel when deploying (e.g. juju deploy <charm> --channel <track>/stable). In the COS and COS Lite tables, the Deployment column shows whether the module always deploys a component (Core) or only when a specific input is set (Conditional), with the condition given alongside.

COS charms

Charm	Deployment	LTS	Substrate	Workload version	Track	Contributing
Alertmanager	Core	Yes	K8s	0.34	0.34	Source, issues
Catalogue	Core	Yes	K8s	3.0	3.0	Source, issues
Grafana	Core	Yes	K8s	12.4	12.4	Source, issues
Istio Beacon	Conditional: mesh_enabled = true	Yes	K8s	0.1.1	1.31	Source, issues
Istio Ingress	Conditional: mesh_enabled = true and any ingress toggle	Yes	K8s	0.1.1	1.31	Source, issues
Loki Coordinator	Core	Yes	K8s	1.27 (nginx)	3.7	Source, issues
Loki Worker	Core	Yes	K8s	3.7	3.7	Source, issues
Mimir Coordinator	Core	Yes	K8s	1.27 (nginx)	2.17	Source, issues
Mimir Worker	Core	Yes	K8s	2.17	2.17	Source, issues
Opentelemetry Collector	Core	Yes	K8s	0.130	0.130	Source, issues
S3 Integrator	Core	Yes	Any	-	2	Source, issues
Self-signed Certificates	Conditional: internal_tls = true	Yes	Any	-	1	Source, issues
Tempo Coordinator	Core	Yes	K8s	1.27 (nginx)	2.10	Source, issues
Tempo Worker	Core	Yes	K8s	2.10	2.10	Source, issues
Traefik	Conditional: any ingress toggle is true	Yes	K8s	2.11	latest	Source, issues

COS Lite charms

Charm	Deployment	LTS	Substrate	Workload version	Track	Contributing
Alertmanager	Core	Yes	K8s	0.34	0.34	Source, issues
Catalogue	Core	Yes	K8s	3.0	3.0	Source, issues
Grafana	Core	Yes	K8s	12.4	12.4	Source, issues
Loki	Core	Yes	K8s	3.7	3.7	Source, issues
Opentelemetry Collector	Core	Yes	K8s	0.130	0.130	Source, issues
Prometheus	Core	Yes	K8s	3.14	3.14	Source, issues
Self-signed Certificates	Conditional: internal_tls = true	Yes	Any	-	1	Source, issues
Traefik	Conditional: any ingress toggle is true	Yes	K8s	2.11	latest	Source, issues

Terraform variable mapping

The following table maps each main COS or COS Lite charm to its corresponding Terraform input variable name in the cos or cos-lite module. The Scope column indicates which module the variable belongs to.

Charmhub name	Terraform variable	Scope
alertmanager-k8s	alertmanager	cos, cos-lite
catalogue-k8s	catalogue	cos, cos-lite
grafana-k8s	grafana	cos, cos-lite
istio-beacon-k8s	istio_beacon	cos
istio-ingress-k8s	istio_ingress	cos
loki-k8s	loki	cos-lite
loki-coordinator-k8s	loki_coordinator	cos
loki-worker-k8s	loki_worker	cos
mimir-coordinator-k8s	mimir_coordinator	cos
mimir-worker-k8s	mimir_worker	cos
opentelemetry-collector-k8s	opentelemetry_collector	cos, cos-lite
prometheus-k8s	prometheus	cos-lite
s3-integrator	s3_integrator	cos
self-signed-certificates	ssc	cos, cos-lite
tempo-coordinator-k8s	tempo_coordinator	cos
tempo-worker-k8s	tempo_worker	cos
traefik-k8s	traefik	cos, cos-lite

Peripheral charms

The charms below are not deployed by the COS or COS Lite Terraform modules, so they have no Deployment value: deploy, configure and upgrade them yourself. They follow the same release policy as the components above.

Charm	LTS	Substrate	Workload version	Track	Contributing
Avalanche	No	K8s	-	0.7	Source, issues
Blackbox Exporter	Yes	K8s	0.28	0.28	Source, issues
Blackbox Exporter	Yes	Machines	0.28	0.28	Source, issues
COS Configuration	Yes	K8s	3.6	3.0	Source, issues
COS Proxy	Yes	Machines	-	3.0	Source, issues
Grafana Agent	No	Machines	0.44	0.44	Source, issues
Grafana Agent	No	K8s	0.40	0.40	Source, issues
Grafana Cloud Integrator	No	Any	-	3.0	Source, issues
k6	No	K8s	1.7	1.7	Source, issues
Litmus Auth	No	K8s	3.29	3.29	Source, issues
Litmus Backend	No	K8s	3.29	3.29	Source, issues
Litmus Chaoscenter	No	K8s	3.29	3.29	Source, issues
Litmus Infrastructure	No	K8s	3.29	3.29	Source, issues
Opentelemetry Collector	Yes	Machines	0.130	0.130	Source, issues
Opentelemetry Collector Integrator	Yes	Any	-	3.0	Source, issues
OTel eBPF Profiler	No	Machines	0.135	0.135	Source, issues
Parca Agent	No	Machines	0.35	0.35	Source, issues
Parca	No	K8s	0.27	0.27	Source, issues
Parca Scrape Target	No	Any	-	3.0	Source, issues
Polar Signals Cloud Integrator	No	Any	-	3.0	Source, issues
Prometheus Pushgateway	Yes	K8s	1.11	3.0	Source, issues
Prometheus Scrape Config	Yes	Any	-	3.0	Source, issues
Prometheus Scrape Target	Yes	Any	-	3.0	Source, issues
Pyroscope Coordinator	No	K8s	1.27 (nginx)	1.18	Source, issues
Pyroscope Worker	No	K8s	1.18	1.18	Source, issues
Script Exporter	Yes	Machines	3.2	3.2	Source, issues
SNMP Exporter	Yes	Machines	0.24	0.24	Source, issues

Rocks

Rock	Contributing
ubuntu/alertmanager	Source, issues
ubuntu/blackbox-exporter	Source, issues
ubuntu/git-sync	Source, issues
ubuntu/grafana-agent	Source, issues
ubuntu/grafana	Source, issues
ubuntu/loki	Source, issues
ubuntu/mimir	Source, issues
ubuntu/nginx	Source, issues
ubuntu/nginx-prometheus-exporter	Source, issues
ubuntu/node-exporter	Source, issues
ubuntu/opentelemetry-collector	Source, issues
ubuntu/parca	Source, issues
ubuntu/prometheus	Source, issues
ubuntu/prometheus-pushgateway	Source, issues
ghcr.io/canonical/s3proxy	Source, issues
ubuntu/tempo	Source, issues
ubuntu/xk6	Source, issues

Snaps

Snap	Contributing
Blackbox Exporter	Source, issues
Grafana Agent	Source, issues
Node Exporter	Source, issues
OpenTelemetry Collector	Source, issues

Reference pages

The following pages provide per-component reference material, including SLI definitions and workload-specific details.

• Alertmanager
• Grafana
• Loki
• Mimir
• Prometheus
• Tempo