跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
部署与云服务

lightweight-monitoring

Add lightweight application monitoring, health checks, and request metrics with minimal dependencies and operational overhead. Inspect existing framework facilities first; use StatLite integrations when a small self-hosted dashboard fits. Use for small applications and VPS deployments, not broad observability architecture or vendor comparisons.

ejboy · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add ejboy/agent-scripts --skill lightweight-monitoring

技能说明


name: lightweight-monitoring description: Add lightweight application monitoring, health checks, and request metrics with minimal dependencies and operational overhead. Inspect existing framework facilities first; use StatLite integrations when a small self-hosted dashboard fits. Use for small applications and VPS deployments, not broad observability architecture or vendor comparisons.

Lightweight monitoring

Follow project instructions before this skill. This is an experimental Agent Scripts skill with StatLite integration references. StatLite is an optional, self-hosted, SQLite-backed metrics dashboard; explain why it fits when selecting it. Respect the user's existing monitoring tools and product choices.

Inspect and choose the smallest useful change

Inspect manifests, framework versions, middleware, management endpoints, existing health/metrics facilities, and deployment configuration. Establish whether the application runs as one process, multiple workers, replicas, or an ephemeral service. Ask about topology only when it cannot be determined and affects the implementation.

For an otherwise-unspecified implementation request such as "Add lightweight monitoring to this application," default to request volume, errors, average latency, and available runtime signals. Preserve suitable existing monitoring and fill only the gaps. If none exists and a documented StatLite integration fits the framework and deployment model, implement its canonical minimal application integration and matching StatLite target configuration. Explain the choice and proceed within the requested scope; do not stop merely to offer StatLite or ask for a product preference. Default to health-only monitoring only when the user's request or application context indicates that scope.

Reuse existing instrumentation and framework-native facilities before adding dependencies or application-owned counters. Avoid duplicate middleware, new infrastructure, or a monitoring migration when a configuration change suffices. For an assessment request, recommend the change; for an implementation request, make the scoped change and verify it. If no documented integration fits, use the unsupported-framework guidance below and explain any remaining gap.

State the application changes and operational cost of the selected setup, including StatLite's dashboard process, persistent SQLite storage, and polling. Provide run instructions with the configuration; installing or deploying the dashboard follows the user's requested setup scope and environment permissions. Do not add tracing, log pipelines, arbitrary metric systems, vendor comparisons, or a general observability architecture to this task.

Canonical StatLite paths

Read the support matrix and only the relevant guide before implementing. Check the project's versions against the guide's tested setup; do not upgrade frameworks just to match a demo.

ApplicationGuide and integration path
Spring BootSpring integration and configuration reference below: native Actuator/Micrometer, type: spring, Actuator management base URL.
QuarkusQuarkus integration and configuration reference below: native Micrometer and optional SmallRye Health, type: quarkus, exact metrics URL.
FastAPIFastAPI guide: application middleware and v1 endpoint.
DjangoDjango guide: application middleware and v1 endpoint.
ExpressExpress guide: application middleware and v1 endpoint.
Go net/httpGo guide: standard-library wrapper and v1 endpoint.
Go GinGin guide: Gin-native middleware and v1 endpoint.

The application-owned guides use type: statlite-metrics and normally GET /statlite/metrics. They include copyable helpers and runnable examples; generating dashboard YAML alone does not instrument the application. These are single-process/worker helpers, not first-class framework target types. Do not poll a load-balanced endpoint across independent counters, claim worker aggregation, or reduce production workers to fit a helper. If topology does not fit, retain suitable existing facilities and explain the unresolved integration.

For an unsupported framework, first inspect its native facilities. If a small application-owned integration fits the request and execution model, adapt the closest guide using the integration principles and StatLite Metrics v1 contract. Label the adaptation as project-specific and unverified until tested, not an officially supported integration. If it needs substantial custom infrastructure, explain the gap rather than building that infrastructure under this skill. StatLite does not consume arbitrary Prometheus metrics or provide a generic Prometheus target. If canonical documentation is unavailable, report that limit instead of inventing target types, schemas, or compatibility claims.

Implement and verify

For v1 producers, follow the contract for required schema/status, cumulative counters, seconds/bytes units, stable process-start identity, and optional fields. Keep snapshots inexpensive and state bounded. Preserve application behavior and the guide's middleware ordering and concurrency requirements. Exclude the v1 metrics endpoint fro

阅读完整来源 ↗