Explore documentation
  1. Common content
    1. Language clients 2
    2. Testing codeblocks
    3. Drafts
    4. Drafts
    5. Vector (Recommended) (?)

Logtail Kubernetes logging

Start logging in 5 minutes

How do you want to install Vector and set up Logtail?

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 Chart config for your source:

Download config
wget -O values.yaml \
    https://logtail.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 Logtail -> Live tail.

Kubernetes version 1.15 or higher is required.

Need help?

Please let us know at [email protected].
We're happy to help! 🙏

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://logtail.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 Logtail -> Live tail.

Kubernetes version 1.15 or higher is required.

Need help?

Please let us know at [email protected].
We're happy to help! 🙏

Additional information

Interested in reading about installing and configuring Vector in more detail?
Read the official Vector Kubernetes installation guide.