kubernetes

Kubernetes Config

This directory contains Kubernetes manifest templates for rolling out the Agent.

Manifests:

• Metric collection (StatefulSet): agent-bare.yaml
• Log collection (DaemonSet): agent-loki.yaml
• Trace collection (Deployment): agent-traces.yaml

⚠️ These manifests do not include the Agent's configuration (ConfigMaps), which are necessary to run the Agent.

For sample configurations and detailed installation instructions, please head to:

• Grafana Agent Metrics Kubernetes Quickstart
• Grafana Agent Logs Kubernetes Quickstart
• Grafana Agent Traces Kubernetes Quickstart

Manually Applying

Since the manifest files are just templates, note that they are not ready for applying out of the box and you will have to manually perform the following steps:

1. Download the manifest as manifest.yaml

2. Modify your copy of the manifest, replacing relevant variables with the appropriate values

3. Apply the modified manifest file: kubectl -ndefault apply -f manifest.yaml.

This directory also contains an install-bare.sh script that is used inside of Grafana Cloud instructions. If using the Grafana Agent outside of Grafana Cloud, it is recommended to follow the steps above instead of calling this script directly.

Rebuilding the manifests

The manifests provided are created using Grafana Labs' production Tanka configs with some default values. If you want to build the YAML file with some custom values, you will need the following pieces of software installed:

1. Tanka >= v0.8
2. jsonnet-bundler >= v0.2.1

See the template Tanka environment for the current settings that initialize the Grafana Agent Tanka configs.

To build the YAML files, execute the ./build/build.sh script or run make example-kubernetes from the project's root directory.