You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Nicolas Massé
5828e563f8
|
10 months ago | |
|---|---|---|
| .. | ||
| config | 10 months ago | |
| Makefile | 10 months ago | |
| README.md | 10 months ago | |
| overlay.bu | 10 months ago | |
| vmagent.container | 10 months ago | |
README.md
Podman Quadlet: vmagent
Overview
vmagent is a Victoria Metrics agent started as a Podman Quadlet. It collects metrics from various sources and forwards them to a Victoria Metrics or Prometheus-compatible remote storage.
This cookbook:
- Runs vmagent as a rootless container with minimal privileges.
- Uses environment-based configuration via global and local environment files.
- Stores scraped data temporarily in
/var/lib/quadlets/vmagent/for reliability. - Reads scrape configuration from
/etc/quadlets/vmagent/conf.d/. - Supports automatic container image updates via Podman auto-update.
Prerequisites
- Configuration file
/etc/quadlets/vmagent/vmagent.local.envmust exist. - Global configuration in
/etc/quadlets/vmagent/vmagent.global.env. - Scrape targets configured in
/etc/quadlets/vmagent/conf.d/.
Usage
In a separate terminal, follow the logs.
sudo make tail-logs
Install the Podman Quadlets and start vmagent.
sudo make clean install
You should see the vmagent.service starting up and beginning to scrape configured targets.
Verify vmagent is running:
sudo systemctl status vmagent.service
Check vmagent's own metrics:
curl http://127.0.0.1:8429/metrics
Finally, remove the quadlets, their configuration and their data.
sudo make uninstall clean
Integration tests
sudo make test