Install Vector using Helm

Helm is a package manager for Kubernetes that facilitates the deployment and management of applications and services on Kubernetes clusters. This page covers installing and managing Vector through the Helm package repository.

Installation

Aggregator role in private beta

Helm support for the aggregator role is currently in private beta. We’re currently seeking beta testers. If interested, please join our chat and let us know.

As an alternative, you can still manually deploy Vector in the aggregator role. Instructions throughout this doc will be for the agent role only.

Add the Vector repo:

helm repo add timberio https://packages.timber.io/helm/latest

Check available Helm chart configuration options:

helm show values timberio/vector-agent

Configure Vector:

cat <<-'VALUES' > values.yaml
# The Vector Kubernetes integration automatically defines a
# kubernetes_logs source that is made available to you.
# You do not need to define a log source.
sinks:
  # Adjust as necessary. By default we use the console sink
  # to print all data. This allows you to see Vector working.
  # /docs/reference/sinks/
  stdout:
    type: console
    inputs: ["kubernetes_logs"]
    target: "stdout"
    encoding: "json"
VALUES

Install Vector:

helm install vector timberio/vector-agent \
  --namespace vector \
  --create-namespace \
  --values values.yaml

Other actions

helm uninstall --namespace vector vector
helm repo update && helm upgrade --namespace vector vector timberio/vector-agent --reuse-values

Management