Skip to content

canonical/grafana-agent-operator

Repository files navigation

Grafana Agent Charmed Operator for Machines (LXD, MaaS, etc.)

Charmhub Badge Release Charm to Edge and Publish Libraries Discourse Status

Description

Grafana Agent is a telemetry collector for sending metrics, logs, and trace data to the opinionated Grafana observability stack.

The Grafana Agent Charmed Operator deploys Grafana Agent in machines using Juju and the Charmed Operator Lifecycle Manager (OLM).

As a single entry point to the Canonical Observability Stack, the Grafana Agent charm brings several conveniences when deployed inside a monitored cluster:

  • Charms are related to the Grafana Agent charm, instead of to Prometheus and Loki individually. In typical deployments this would reduce the number of cross-model relations that would have been otherwise needed.
  • Conversion from scraping to remote writing: Grafana Agent would collect telemetry inside the cluster network and push it to the COS cluster (via loki_push_api and prometheus_remote_write), which simplifies firewall configuration, as only outgoing connections would need to be established.

See deployment scenarios for further detail.

Usage

Create a Juju model for your operators, say "cos"

juju add-model cos

The Grafana agent may be deployed using the juju command line:

juju deploy grafana-agent

If required, you can remove the deployment completely:

juju destroy-model -y cos --no-wait --force --destroy-storage

Relations

Detailed information about the relations can be found in Charmhub integrations page.

OCI Images

This charm by default uses the latest release of the grafana-agent