StatLite

A lightweight, self-hosted metrics dashboard with a small memory and operational footprint, designed for applications running on VPSs and small servers. A single Go binary monitors Spring Boot applications through Actuator and other applications that expose a small, fixed JSON metrics endpoint, without requiring Prometheus or Grafana. It stores focused health, traffic, latency, CPU, memory, and optional host metrics in SQLite.

Website: pvrlabs.xyz/statlite

StatLite is built for resource-constrained servers. Low memory, CPU, disk, and operational overhead are treated as product constraints.

Learn how to set up lightweight Spring Boot monitoring without Prometheus and Grafana.

Try it

docker run --rm \
  -p 127.0.0.1:9090:9090 \
  ghcr.io/pvrlabs/statlite:latest

Open http://127.0.0.1:9090. StatLite monitors itself by default, so the dashboard starts with live data.

See the Docker guide for persistent storage, container networking, local builds, and access guidance.

StatLite is intentionally focused and is not a replacement for Prometheus and Grafana.

Install

See Installation for the release installer, Homebrew, and source-build instructions.

Configure an application

Start with an application's base URL. StatLite can identify a supported integration and print the target YAML to copy into statlite.yaml:

statlite inspect 'http://localhost:8080'

The command checks the conventional Spring Boot Actuator and StatLite Metrics v1 paths, then prints the detected endpoint, available capabilities, and the next command. It is bounded and read-only: it does not require or create statlite.yaml, open SQLite, or start monitoring.

Important

Quote browser-pasted URLs, especially URLs containing ? or &. Inspection requires a base HTTP or HTTPS URL, so remove any query string or fragment first.

For a Spring application, the successful output includes:

targets:
  - name: "my-app"
    type: "spring"
    actuator_base_url: "http://localhost:8080/actuator"

Copy the suggested target into a complete statlite.yaml, then run:

statlite

See Configuration for discovery limits, authentication limitations, all settings, and manual target configuration. See examples/ for Spring Boot, Python/FastAPI, self-monitoring, and multi-target configurations.

Important

StatLite has no built-in dashboard or API authentication. Review the server and access guidance before exposing it remotely.

Supported metric sources

• Spring Boot Actuator: Collects health, request, JVM, process, and optional host metrics from Actuator endpoints.
• StatLite Metrics v1: A small, fixed JSON endpoint that applications in any language or framework can implement.
• StatLite self-monitoring: StatLite can report its own health, traffic, process, and host metrics.

Depending on the integration, StatLite can also collect CPU, memory, and disk metrics for the environment running the application.

Documentation

• Installation
• Docker
• Configuration
• Monitoring on resource-constrained servers
• StatLite Metrics v1
• systemd deployment
• Product and architecture
• Spring Boot guide
• Examples

License

MIT