Install Vector via DPKG

Dpkg is the software that powers the package management system in the Debian operating system and its derivatives. Dpkg is used to install and manage software via .deb packages. This page will cover installing and managing Vector through the DPKG package repository.

Installation

0.11.X
amd64
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. Install Vector

    curl --proto '=https' --tlsv1.2 -O https://packages.timber.io/vector/0.11.X/vector-0.11.X-amd64.deb && \
        sudo dpkg -i vector-amd64.deb

  2. Configure Vector

    cat <<-'VECTORCFG' > /etc/vector/vector.toml
    # Vector's API for introspection
    [api]
    enabled = true
    address = "127.0.0.1:8686"
    

    # Host-level logs
    [sources.logs]
    type = "journald"
    

    # Host-level metrics (cpu, memory, disk, etc)
    [sources.host_metrics]
    type = "host_metrics"
    

    # Vector's own internal metrics
    [sources.internal_metrics]
    type = "internal_metrics"
    

    # --> Add transforms here to parse, enrich, and process data
    

    # print all events, replace this with your desired sink(s)
    # https://vector.dev/docs/reference/sinks/
    [sinks.out]
    type = "console"
    inputs = [ "logs", "host_metrics", "internal_metrics" ]
    encoding.codec = "json"
    VECTORCFG

  3. Restart Vector

    sudo systemctl restart vector

  4. Observe Vector

    sudo journalctl -fu vector
    explain this command

Deployment

Vector is an end-to-end observability data platform 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 topologies:

Common Deployment Topologies

Administration

0.11.X
amd64

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

Uninstall

0.11.X
amd64
sudo dpkg -r vector
explain this command
Contents
Resources