EXTENSIONS
Built by operatives — models, drivers, vaults, and reports, the parts that plug into Swamp.
Filter by what you need and pull what fits.
Swamp Watch
Per-workflow observability for a swamp repo's own scheduled work.
Aws/bedrock Usage
AWS Bedrock token usage monitoring — multi-account fan-out scanning of
Ai Usage
Unified cross-provider AI token usage monitoring — workflow, model, and
Gcp/vertex Usage
GCP Vertex AI token usage monitoring — multi-project scanning of
Datadog/synthetics
Datadog Synthetics — synthetic monitoring tests, results, and locations
Aws/metrics
Query and analyze CloudWatch Metrics for operational visibility and performance monitoring.
Azure/openai Usage
Azure OpenAI / AI Services token usage monitoring — multi-subscription
Prometheus
Evidence-preserving instant and range PromQL queries against Prometheus, with explicit timestamps and optional SSH transport.
Prometheus Pushgateway
Push metrics from a scheduled swamp method into a Prometheus Pushgateway. Scheduled jobs are exactly what Pushgateway exists for: a batch that runs, computes numbers, and exits long before any scrape could reach it. The `@sntxrr/prometheus/pushgateway` model's `push` method takes a flat `{name, value, labels}` series — the shape several models already emit alongside their verdicts — renders it as text exposition format, and writes it to a grouping key. Defaults to PUT so a series that disappears from the source disappears from the gateway, rather than lingering at its last value forever. Validates metric and label names and rejects non-finite values before sending, because Pushgateway answers 400 without naming the offending series and a single NaN discards the whole batch. Handles the base64 grouping-key escape for values containing a slash or empty values, which would otherwise corrupt or collapse a path segment. Emits an optional heartbeat counter, because pushed metrics go stale silently: the gateway serves the last value forever, so a job that stops running leaves every dashboard green while nothing is being checked.
Unifi Fabric
Structural health monitoring for a UniFi fabric. The `@sntxrr/unifi-fabric/topology` model's `check` method compares a declared topology against live `/stat/device` rows and reports the failures that outcome-based monitoring cannot see: a device expected on the wire that has silently fallen back to a wireless mesh uplink, attachment to the wrong upstream device, links negotiated below their expected speed, ports carrying error counters, and — the one with no equivalent elsewhere — ports that are down but have carried real traffic before, which identifies a run that used to work. An access point that loses its wired uplink does not fail; it meshes, keeps serving clients, and every uptime check stays green while latency quietly goes from sub-millisecond to tens of milliseconds and jittery. `uplink.type` flipping from `wire` to `wireless` is a boolean, so it is asserted exactly rather than thresholded. Read-only: never writes to the controller. Emits a flat Prometheus-ready metric series alongside the verdict, including for healthy devices, so alerts can fire on a series dropping to zero rather than on a document changing shape. Authenticates with an API key over `X-API-KEY`, which sidesteps the HTTP 499 that MFA-enabled SSO accounts return for password logins.
Credential Expiry
Probe the credentials a fleet actually holds and report how long each has left, distinguishing expiry from an outage in progress
Observability Agent
Install and configure a host-native metrics + logs agent on a remote
Cadvisor
cAdvisor container metrics for swamp — deploy a cAdvisor container over SSH,
Gcp/monitoring
Google Cloud monitoring infrastructure models
Zabbix
Zabbix Monitoring — read-only integration for troubleshooting and observing monitored infrastructure via the Zabbix JSON-RPC 2.0 API. Retrieves hosts, problems, triggers, items, history, host groups, maintenance windows, events, and network maps.
Coder Metrics Sampler
Scrapes Prometheus metrics from Coder's metrics endpoint. Extracts key operational indicators (API latency, workspace counts, agent connections) and writes typed snapshots for trend analysis.
Coder Workspace Watch
Queries Coder workspace API and captures state snapshots. Records workspace status, agent state, and build info for stability and drift analysis.
Coder Health Probe
Polls Coder server health and build info endpoints. Produces typed health state with latency measurements for reliability analysis.
Scaleway Cockpit
Manage a Scaleway Cockpit (Observability) data source — sync state, create metrics/logs/traces data sources, delete, and discover data sources and tokens in a region, via the Cockpit API with X-Auth-Token auth.
Prometheus
Monitoring agent install/config + Prometheus target registration (https://github.com/keeb/swamp-prometheus)
Grafana
Grafana dashboard and alert management via API (https://github.com/keeb/swamp-grafana)
Google Meet Hardware
Google Meet hardware device monitoring via Workspace Admin Reports API. Tracks device online/offline state, peripheral attach/detach (camera, mic, speaker, display, touch controller), call state (Meet, Teams, Webex, Zoom), power state, firmware updates, and restarts. Uses service account with domain-wide delegation — no interactive auth required.
Openai Usage
OpenAI platform usage and cost reporting via the Organization Usage API — daily and total completion token counts and USD spend, month-to-date by default. Vault-based Admin API key (the api.usage.read scope is required; a standard project key cannot read usage).
Disk Usage
Check disk usage statistics for a filesystem path