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
- Agent Role
- Aggregator Role
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.
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.debConfigure Vector
cat <<-'VECTORCFG' > /etc/vector/vector.toml# Vector's API for introspection[api]enabled = trueaddress = "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"VECTORCFGRestart Vector
sudo systemctl restart vectorObserve Vector
- Logs
- Metrics
sudo journalctl -fu vectorexplain 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 pipelines:
Administration
Start
sudo systemctl start vector
Stop
sudo systemctl stop vector
Reload
systemctl kill -s HUP --kill-who=main vector.service
Restart
sudo systemctl restart vector
Observe
- Logs
- Metrics
sudo journalctl -fu vector
Uninstall
sudo dpkg -r vector