@keeb/prometheus

Swamp extension for monitoring agent installation and Prometheus target registration.

Models

monitoring/agent

Install and configure monitoring agents (node_exporter, promtail) on a remote host over SSH.

Method	Description
install	Install node_exporter and promtail packages
configure	Configure promtail to ship logs to Loki, set up node_exporter
enableTextfileCollector	Enable the node_exporter textfile collector directory for custom metrics

monitoring/hub

Register monitoring targets with a Prometheus server.

Method	Description
discover	List currently registered Prometheus targets
register	Register a new scrape target with Prometheus

Workflows

Workflow	Description
setup-monitoring	Full monitoring setup: install agents + configure wiring + register with Prometheus
configure-monitoring	Configure monitoring wiring (promtail, Prometheus target registration)
setup-game-metrics	Enable node_exporter textfile collector on a game server VM

Dependencies

• @keeb/ssh — SSH helpers (lib/ssh.ts)

Used by

• swamp-minecraft — Game server metrics collection

Install

swamp extension pull @keeb/prometheus

Example

Install node_exporter + promtail on an Alpine VM, then register it as a scrape target:

models:
  - name: agent
    type: "@keeb/monitoring/agent"
    globalArguments:
      sshHost: "10.0.0.42"
      sshUser: "root"
  - name: hub
    type: "@keeb/monitoring/hub"
    globalArguments:
      sshHost: "hancock.local"
      sshUser: "keeb"
      targetsDir: "/etc/prometheus/targets"

jobs:
  - name: onboard-vm
    steps:
      - model: agent
        method: install
        inputs: { vmName: "web01" }
      - model: agent
        method: configure
        inputs:
          vmName: "web01"
          lokiUrl: "http://hancock.local:3100/loki/api/v1/push"
      - model: hub
        method: register
        inputs:
          vmName: "web01"
          targetIp: "10.0.0.42"

License

MIT