Kubernetes version 1.15 or higher is required.
Explore documentation
Better Stack Kubernetes logging
Start logging in 2 minutes
How do you want to install Vector and set up Better Stack?
Kustomize
1. Create namespace
Create namespace configuration file:
Create namespace
kubectl create namespace --dry-run=client -o yaml vector > namespace.yaml
2. Set up Kustomization
Save the following config as kustomization.yaml:
Kustomization config
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
# Override the namespace of all of the resources we manage.
namespace: vector
bases:
# Include Vector recommended base (from git).
- github.com/vectordotdev/vector/distribution/kubernetes/vector-agent
images:
# Override the Vector image to pin the version used.
- name: timberio/vector
newName: timberio/vector
newTag: 0.28.1-distroless-libc
resources:
# The namespace previously created to keep the resources in.
- namespace.yaml
configMapGenerator:
# ConfigMap with Vector config.
- name: vector
behavior: replace
files:
- vector-agent.toml
patches:
# Prevent data dir read-only volume mount issue: https://github.com/vectordotdev/helm-charts/issues/226
# Set volumeMount readOnly: false
- patch: |-
- op: replace
path: /spec/template/spec/containers/0/volumeMounts/3/readOnly
value: false
target:
group: apps
version: v1
kind: DaemonSet
name: vector
3. Set up Vector
Download Vector configuration for your source:
Download Vector config
wget -O vector-agent.toml \
https://logs.betterstack.com/vector-toml/kubernetes/$SOURCE_TOKEN
4. Reload & restart
Reload Vector configuration and restart it:
Reload and restart
kubectl apply -k .
kubectl rollout restart -n vector daemonset/vector
You should see your logs in Better Stack -> Live tail.
Need help?
Please let us know at hello@betterstack.com.
We're happy to help! 🙏
Helm
1. Add repository
Add and update Helm Vector repository:
Add Vector repo
helm repo add vector https://helm.vector.dev
helm repo update
2. Setup
Download Vector Helm config for your source:
Download config
wget -O values.yaml \
https://logs.betterstack.com/vector-helm/$SOURCE_TOKEN
3. Apply
Apply Vector Helm Chart to your cluster:
Install Vector
helm install vector vector/vector \
--namespace vector \
--create-namespace \
--values values.yaml
You should see your logs in Better Stack -> Live tail.
Kubernetes version 1.15 or higher is required.
Need help?
Please let us know at hello@betterstack.com.
We're happy to help! 🙏
Additional information
Interested in reading about installing and configuring Vector in more detail?
Check out the official Vector Kubernetes installation guide.