SuperAPI AI 工具集

maintainx-observability

部署与运维

查看项目

更新于 10-15 23:27

技能介绍

用途:为 MaintainX API 集成建立监控、日志与告警,提升可靠性并快速发现问题。

主要能力:使用 prom-client 定义指标,包括 maintainx_api_requests_total(按 method、endpoint、status 标签)、maintainx_api_latency_seconds 延迟直方图、maintainx_rate_limit_hits_total 限流计数、maintainx_work_orders_processed_total 工单处理计数、maintainx_sync_lag_seconds 同步延迟 Gauge。提供带拦截器的 axios 客户端,自动记录每次 API 调用的请求数、延迟,并在 429 时累加限流计数。提供结构化 JSON 日志类,输出 level、message、service、timestamp 及自定义字段,便于 ELK、CloudWatch、Datadog 聚合。提供 Express 服务,暴露 /metrics 供 Prometheus 抓取,/health 返回运行状态与关键指标。附带 Prometheus 告警规则示例:错误率、p95 延迟、限流、同步过期。

使用方式:需已部署 MaintainX 集成、Node.js 18+ 及监控平台(Prometheus/Grafana、Datadog 或 CloudWatch)。按步骤创建 metrics、instrumented-client、logger、server 文件,启动后监听 9090 端口。Datadog 可用 hot-shots 的 DogStatsD 发送指标。

限制:资料未提供安装命令、完整依赖清单、鉴权与安全配置、指标保留策略及具体部署方式;示例代码需按实际环境调整。