Agent skill · data analytics · jeremylongshore
maintainx-observability
Implement comprehensive observability for MaintainX integrations.
Why this skill is useful
Adds executable scripts for metrics collection and structured logging specifically tailored for MaintainX API integrations.
What it needs
Requires node installed locally. Requires maintainx account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
MaintainX Observability Overview Implement metrics, structured logging, and alerting for MaintainX integrations to ensure reliability and rapid issue detection. Prerequisites MaintainX integration deployed Node.js 18+ Monitoring platform (Prometheus/Grafana, Datadog, or CloudWatch) Instructions Step 1: Prometheus Metrics Step 2: Instrumented API Client Step 3: Structured Logging Step 4: Health and Metrics Endpoints Step 5: Alerting Rules (Prometheus) Output Prometheus metrics (request count, latency histogram, rate limit counter, sync lag gauge) Instrumented axios client automatically recording metrics on every API call Structured JSON logging for all operations /metrics endpoint for Prometheus scraping Alerting rules for error rate, latency, rate limits, and sync staleness Error Handling Issue Cause Solution ------- ------- ---------- Metrics endpoint 500 prom-client not initialized Ensure Registry is created before metrics Missing labels Metric name mismatch Check labelNames match inc()/observe() calls Log volume too high Debug logging in production Set LOGLEVEL=info in production Stale sync alert Sync job stopped Check cron schedule, restart sync process Resources MaintainX API Reference prom-client -- Prometheus metrics for Node.js Prometheus Alerting Rules Next Steps For incident response, see maintainx-incident-runbook. Examples Datadog integration using DogStatsD:
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/maintainx-observability