timberio/vector

https://vector.dev  •  https://vector.dev/docs/  •  https://vector.dev/community/  •  https://github.com/timberio/vector

---

Vector is an https://github.com/timberio/vector utility for building observability pipelines. https://vector.dev/docs/reference/sources/, https://vector.dev/docs/reference/transforms/, and https://vector.dev/docs/reference/sinks/ log, metrics and events with one simple tool.

Built in https://www.rust-lang.org/, Vector places high-value on https://vector.dev/#performance, https://vector.dev/#correctness, and https://vector.dev/docs/administration/. It compiles to a single static binary and is designed to be https://vector.dev/docs/setup/deployment/ across your entire infrastructure, serving as a light-weight https://vector.dev/docs/setup/deployment/strategies/#daemon, https://vector.dev/docs/setup/deployment/strategies/#sidecar, or highly efficient https://vector.dev/docs/setup/deployment/strategies/#service. Take back ownership and control of your observability data with Vector.

Vector is maintained by Datadog's https://opensource.datadoghq.com/about/#the-community-open-source-engineering-team.

Configuring

As shown above, you can pass a custom https://vector.dev/docs/setup/configuration/ via the -c flag. You'll want to do this since the https://github.com/timberio/vector/blob/master/config/vector.toml doesn't do anything.

Deploying

How you deploy Vector is largely dependent on your use case and environment. Please see the https://vector.dev/docs/setup/deployment/ for more info on how to deploy Vector.

Updating

Simply run with newer version in the tag:

bash
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 https://hub.docker.com/_/alpine, which is a Linux distribution built around musl libc and BusyBox. It is ***ably 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.

bash
docker run timberio/vector:0.10.0-alpine

debian

This image is based on the https://hub.docker.com/_/debian, which is a smaller, more compact variant of the https://hub.docker.com/_/debian.

bash
docker run timberio/vector:0.10.0-debian

distroless-*

https://github.com/GoogleContainerTools/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 https://vector.dev/releases/latest/:

Source Files

Vector's Docker source files are located https://github.com/timberio/vector/tree/master/distribution/docker.