Install Vector via APT

Advanced Package Tool, or APT, is a free package manager that handles the installation and removal of software on Debian, Ubuntu, and other Linux distributions.

Our APT repositories are provided by Cloudsmith and you can find instructions for manually adding the repositories. This page will cover installing and managing Vector through the APT package repository.

Installation

Vector daemon deployment strategyVector daemon deployment strategy
1. Your service logs to STDOUT
STDOUT follows the 12 factor principles.
2. STDOUT is captured
STDOUT is captured by your platform.
3. Vector collects & fans-out data
Vector collects data from your platform.

The agent role is designed to collect all data on a single host. Vector runs as a background process and interfaces with a host-level APIs for data collection. By default, Vector will collect logs from Journald via Vector's journald source and metrics via the host_metrics source, but it is recommended to adjust your pipeline as necessary using Vector's sources, transforms, and sinks.


  1. Add the Vector repo

    curl -1sLf \
    'https://repositories.timber.io/public/vector/cfg/setup/bash.deb.sh' \
    | sudo -E bash
  2. Install Vector

    sudo apt-get install vector
  3. Configure Vector

    none
  4. Restart Vector

    sudo systemctl restart vector
  5. Observe Vector

    sudo journalctl -fu vector
    explain this command

Deployment

Vector is an end-to-end observability data pipeline designed to deploy under various roles. You mix and match these roles to create topologies. The intent is to make Vector as flexible as possible, allowing you to fluidly integrate Vector into your infrastructure over time. The deployment section demonstrates common Vector pipelines:

Common Deployment Topologies

Administration

Start

sudo systemctl start vector
explain this command

Stop

sudo systemctl stop vector
explain this command

Reload

systemctl kill -s HUP --kill-who=main vector.service
explain this command

Restart

sudo systemctl restart vector
explain this command

Observe

sudo journalctl -fu vector
explain this command

Upgrade

sudo apt-get upgrade vector
explain this command

Uninstall

sudo apt remove vector
explain this command