Rolle `vmagent`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/vmagent.md
Rolle vmagent
Metriken-Push per remote-write.
| Läuft gegen | Tailscale-only-Hosts (Banana Pi) |
| Tags | monitoring, vmagent |
| Quellcode | roles/vmagent |
Variablen
Defaults aus defaults/main.yml. Überschreiben in group_vars/ oder host_vars/.
| Variable | Default | Bedeutung |
|---|---|---|
vmagent_enabled |
true |
– |
vmagent_version |
1.149.0 |
– |
vmagent_arch |
arm |
– |
vmagent_sha256 |
{arm: b87fdf5bb91978bd183bf284e90930f8f1fd083b8e1151ef8bc46614435b146e} |
– |
vmagent_download_url |
https://github.com/VictoriaMetrics/VictoriaMetrics/releases/download/v{{ vmagent_versio… |
– |
vmagent_install_dir |
/opt/vmagent-{{ vmagent_version }} |
– |
vmagent_node_exporter_port |
9100 |
– |
vmagent_scrape_interval |
30s |
– |
vmagent_remote_write_queues |
1 |
– |
vmagent_remote_write_basic_auth_user |
{{ vault_vm_write_auth_user \| default('') }} |
– |
vmagent_remote_write_basic_auth_password |
{{ vault_vm_write_auth_password \| default('') }} |
– |
vmagent_remote_write_password_file |
/etc/vmagent/write-auth-password |
– |
Ablauf
- Sicherstellen dass vmagent_remote_write_url gesetzt ist
- System-User fuer vmagent anlegen
- Verzeichnis fuer lokalen remote_write-Puffer anlegen
- Konfigurationsverzeichnis anlegen
- vmutils-Release herunterladen
- Installationsverzeichnis fuer vmagent anlegen
- vmagent-Binary entpacken
- vmagent-Binary ausfuehrbar machen
- Zugangsdaten fuer den Schreib-Endpunkt ablegen
- Scrape-Konfiguration deployen
- vmagent-systemd-Service deployen
- vmagent aktivieren und starten
- vmagent deaktivieren (vmagent_enabled false)
Handler
- vmagent neu starten
Templates
vmagent-scrape.yml.j2vmagent.service.j2
Fehlersuche
Allgemeines Vorgehen bei Rollen: ansible-playbook <playbook>.yml --limit <host> --tags <tag> --check --diff -vvv zeigt Änderungen ohne sie anzuwenden (make <ziel>-check bei den Playbooks mit Dry-Run). Die Rollenübersicht mit Make-Zielen: Rollen.
sudo systemctl status vmagent
sudo journalctl -u vmagent -n 100 --no-pager
curl -s localhost:8429/targets | head
| Symptom | Ursache | Lösung |
|---|---|---|
vmagent_remote_write_url ist nicht gesetzt … |
Variable fehlt | in group_vars/banana_pis.yml setzen |
| Keine Metriken des Banana Pi in VictoriaMetrics | Push scheitert (Basic-Auth vault_vm_write_auth_*, TLS, Netz) |
Log lesen, Monitoring |
401 im Log |
Zugang vm-writer stimmt nicht |
Vault-Variablen und Secret vm-write-auth abgleichen |
| Download der gepinnten Version scheitert | vmagent_sha256 passt nicht zu vmagent_version und vmagent_arch |
beides gemeinsam aktualisieren |
Allgemeine Fehlersuche: Host-Troubleshooting, zentrale Fehlersuche.