Skip to main content

Observability Agent

@magistr/observability-agentv2026.07.02.3· 11d agoMODELS
01README

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 to bindAddress — 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 the vector user to adm so 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.

02Release Notes

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.

03Models1
@magistr/observability/agentv2026.07.02.3extensions/models/observability_agent.ts

Global Arguments

ArgumentTypeDescription
sshHoststringSSH hostname or IP of the target host
sshUserstringSSH user (default root)
sshPortnumberSSH port (default 22)
nodePortnumbernode_exporter port
blackboxPortnumberblackbox port
fn install()
Install prometheus-node-exporter, prometheus-blackbox-exporter, and vector on the target host (idempotent).
fn configure()
Write exporter + Vector configs (exporters bound to bindAddress), grant blackbox CAP_NET_RAW for ICMP, add the vector user to the adm group so it can read logs, then enable + restart all services.
fn status()
Report systemd state of the three agent services and whether each exporter is answering on its bound address.
fn inventory()
Full host inventory over SSH: every running systemd service, every TCP/UDP listening socket with its owning process, and a process-name rollup. Use to audit exactly what is running/exposed on a host.

Resources

install(infinite)— Installed agent package versions
config(infinite)— Applied agent configuration
status(infinite)— Live health of the agent services + listeners
inventory(infinite)— Complete host inventory: running systemd services, all TCP/UDP listeners with owning process, and process rollup
04Stats
A
92 / 100
Downloads
0
Archive size
11.2 KB
  • 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
05Platforms
06Labels