Skip to main content
← back to extensions

Prometheus

@keeb/prometheusv2026.10.15.2· 12d agoBEHAVIORSWORKFLOWSSKILLSACCEPTED WARNINGS
01README

Monitoring agent install/config + Prometheus target registration (https://github.com/keeb/swamp-prometheus)

02Behaviors2
@keeb/monitoring/agentv2026.02.17.1monitoring_agent.ts

Global Arguments

ArgumentTypeDescription
sshHoststringSSH hostname/IP of the target VM
sshUser?stringSSH user (default 'root')
fn install()
Install node-exporter and promtail binary on an Alpine VM (no configuration)
fn configure(lokiUrl: string)
Configure promtail to push logs to Loki and start the service
ArgumentTypeDescription
lokiUrlstringLoki push URL (e.g. http://192.0.2.12:3100/loki/api/v1/push)
fn enableTextfileCollector()
Enable node-exporter textfile collector for custom .prom metrics (one-time setup)

Resources

install(infinite)— Monitoring agent install state
config(infinite)— Monitoring agent configuration state
textfile(infinite)— Textfile collector setup state
@keeb/monitoring/hubv2026.04.26.1monitoring_hub.ts

Global Arguments

ArgumentTypeDescription
sshHoststringSSH hostname/IP of the monitoring hub
sshUser?stringSSH user (default 'keeb')
targetsDirstringPath to Prometheus file_sd_configs targets directory
fn discover()
Validate observability stack and write endpoint data
fn register(targetIp: string)
Register a VM as a Prometheus scrape target via file_sd_configs
ArgumentTypeDescription
targetIpstringIP address of the target VM
fn inspect()
Inspect live Prometheus scrape config and active targets via the HTTP API
fn reload()
Send SIGHUP to the prometheus container to reload its config
fn removeScrapeJob(jobName: string)
Remove a scrape_config block from the live prometheus.yml and reload
ArgumentTypeDescription
jobNamestringName of the scrape_config job_name to remove from prometheus.yml

Resources

hub(infinite)— Observability stack endpoints on the monitoring hub
target(infinite)— Prometheus scrape target registration
inspect(infinite)— Live Prometheus scrape config and active targets
removeScrapeJob(infinite)— Result of removing a scrape_config block from prometheus.yml
03Workflows3
@keeb/setup-monitoringbac98235-a359-4e2d-bf59-bba3139f3f76

Full monitoring setup — install agents + configure wiring + register with Prometheus

setupAuth + discover hub, lookup VM, install agents, configure promtail + register target
1.authkeebDev02.auth— Authenticate with Proxmox
2.discover-hubhancockMonitoring.discover— Validate observability stack on the monitoring hub
3.lookup-vmfleet.lookup— Lookup target VM in fleet
4.install-agentsmonitoringAgent.install— Install node-exporter and promtail on the VM
5.configure-promtailmonitoringAgent.configure— Configure promtail on the VM to push logs to Loki
6.register-targethancockMonitoring.register— Register VM as a Prometheus scrape target on the monitoring hub
@keeb/configure-monitoringbcc556d9-fce6-49e7-bc65-e5049000a4f6

Configure monitoring wiring (promtail → Loki, Prometheus target registration)

configureDiscover hub, lookup VM, configure promtail and register with Prometheus
1.authkeebDev02.auth— Authenticate with Proxmox
2.discover-hubhancockMonitoring.discover— Validate observability stack on the monitoring hub
3.lookup-vmfleet.lookup— Lookup target VM in fleet
4.configure-promtailmonitoringAgent.configure— Configure promtail on the VM to push logs to Loki
5.register-targethancockMonitoring.register— Register VM as a Prometheus scrape target on the monitoring hub
@keeb/setup-game-metrics31fbed74-d3be-431c-b924-864febc11e54

One-time setup — enable node-exporter textfile collector on a game server VM

setupAuth, lookup VM, enable textfile collector
1.authkeebDev02.auth— Authenticate with Proxmox
2.lookup-vmfleet.lookup— Lookup target VM in fleet
3.enable-textfilemonitoringAgent.enableTextfileCollector— Enable node-exporter textfile collector on the VM
04Skills1
prometheus1 file
05Previous Versions9
2026.10.15.1
2026.07.18.1
2026.04.26.1

Add inspect, reload, and removeScrapeJob methods for live prometheus.yml introspection and editing

2026.04.22.3
2026.04.22.2
2026.03.02.3
2026.03.02.2
2026.03.02.1
2026.02.27.1
06Stats
A
93 / 100
Downloads
75
Archive size
25.5 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • 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
  • License1/2partial

    no SPDX license declared

  • Verified public repository2/2earned
Repository
https://github.com/keeb/swamp-prometheus

08Platforms
09Labels
#prometheus#monitoring#metrics#observability