timberio/vector repository overview

Website⁠  •  ⁠Docs⁠  •  ⁠Community⁠  •  ⁠Github⁠ ⁠ ⁠

Vector is an ⁠open-source⁠ utility for building observability pipelines. Collect⁠, transform⁠, and route⁠ log, metrics and events with one simple tool.

Built in Rust⁠, Vector places high-value on performance⁠, correctness⁠, and operator friendliness⁠. It compiles to a single static binary and is designed to be deployed⁠ across your entire infrastructure, serving as a light-weight daemon⁠, sidecar⁠, or highly efficient service⁠. Take back ownership and control of your observability data with Vector.

Vector is maintained by Datadog's Community Open Source Engineering team⁠.

⁠Configuring

As shown above, you can pass a custom Vector configuration file⁠ via the -c flag. You'll want to do this since the default /etc/vector/vector.toml configuration file⁠ doesn't do anything.

⁠Deploying

How you deploy Vector is largely dependent on your use case and environment. Please see the deployment section⁠ for more info on how to deploy Vector.

⁠Updating

Simply run with newer version in the tag:

docker pull timberio/vector:X.X.X-alpine && \
  docker run timberio/vector:X.X.X-alpine

See the variants⁠ and versions⁠ sections to choose the appropriate image for your use case.

⁠Images

⁠Variants

⁠alpine

This image is based on the alpine Docker image⁠, which is a Linux distribution built around musl libc and BusyBox. It is considerably smaller in size than other Docker images and statically links libraries. This is the image we recommend due to it's small size and reliability.

docker run timberio/vector:0.10.0-alpine

⁠debian

This image is based on the debian-slim image⁠, which is a smaller, more compact variant of the debian image⁠.

docker run timberio/vector:0.10.0-debian

⁠distroless-*

Distroless⁠ is a base docker image based on either stripping down an OS, or building the key parts from scratch. It contains only the barest of essentials for running a static or dynamically linked binary.

distroless-static uses the statically linked musl x86 build distroless-libc uses a dynamically linked build which leverages libc provided by distroless/base/cc

⁠Architectures

Vector's images are multi-arch and support the x86_64, ARM64, and ARMv7 architectures. Docker handles this transparently for you.

⁠Versions

Vector's Docker images can be downloaded with the following tags. Note that Vector maintains special tags that are automatically updated whenever Vector is released⁠:

⁠Source Files

Vector's Docker source files are located in it's Github repo⁠.