Observability Agent
Install and configure a host-native metrics + logs agent on a remote Debian/Ubuntu host over SSH, for a VictoriaMetrics (pull) + VictoriaLogs (push via Vector) backend.
Model:
@magistr/observability/agent— drives one target host over SSH. Methods:install— apt-installs prometheus-node-exporter + prometheus-blackbox-exporter and installs vector from the pinned .deb (idempotent).configure— writes exporter defaults (bound tobindAddress— set it to a WireGuard tunnel IP to keep exporters off the public interface), a blackbox module set (http_2xx / http_public / icmp), grants blackbox CAP_NET_RAW for ICMP probes, and configures Vector to tail nginx + syslog and ship to VictoriaLogs' Elasticsearch-bulk endpoint. Adds thevectoruser toadmso it can read the logs.status— systemd state of all three services + whether each exporter is answering on its bound address.
The home VictoriaMetrics scrapes bindAddress:9100 (node) and
bindAddress:9115 (blackbox) over the tunnel; Vector pushes logs to
VictoriaLogs. Pairs with @magistr/victoriametrics for querying.
Release 2026.07.16.2 — align model versions with manifests
Maintenance release across the @magistr extensions. For most packages this
carries no functional change: the only edit is the model's version: field,
brought back in line with its manifest version so the published model type
version and the package version no longer drift.
Functional changes in this release are limited to:
anime-cron: normalizeTitle now strips a ": subtitle" suffix and a trailing parenthesized year before comparison, fixing dedup false-misses where the torrent title carries a subtitle or year that the AniList romaji does not.
arckit: first publish. Standalone ArcKit port — a 12-phase architecture governance state machine with 65 bundled templates, driven by a bundled skill.
Also tracks three extensions (kaiten, observability-agent, music-library) that previously existed only as untracked working-tree directories, recovered from stashes.
Global Arguments
| Argument | Type | Description |
|---|---|---|
| sshHost | string | SSH hostname or IP of the target host |
| sshUser | string | SSH user (default root) |
| sshPort | number | SSH port (default 22) |
| nodePort | number | node_exporter port |
| blackboxPort | number | blackbox port |
Resources
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive0/1missing
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned