StatLite 0.4.1: TierHive deployment and self-monitoring

[ejboy]

StatLite is a lightweight, self-hosted monitoring dashboard for small applications and servers. Version 0.4.1 adds a native TierHive deployment recipe and makes StatLite self-monitoring a first-class integration, alongside several correctness improvements for health, polling, and dashboard metrics.

What is new in 0.4.1

TierHive deployment recipe

StatLite can now be installed on a native Alpine Linux TierHive VPS with a small, provider-neutral recipe:

• Installs StatLite as a non-root statlite OpenRC service.
• Keeps the dashboard loopback-only at 127.0.0.1:9090.
• Persists configuration and SQLite history under the documented StatLite paths.
• Creates a configured Spring Boot Actuator target plus a fixed local statlite-self target.
• Supports safe dashboard access through an SSH local tunnel.

For an exact v0.4.1 installation:

export spring_actuator_url='http://127.0.0.1:8080/actuator'
export statlite_version='v0.4.1'
curl -fsSL https://raw.githubusercontent.com/PVRLabs/statlite/v0.4.1/deploy/tierhive/run.sh | sh

See the TierHive deployment guide for credentials, reruns, service checks, and dashboard access.

StatLite self-monitoring

StatLite exposes the canonical statlite-metrics/v1 profile and can monitor itself or another StatLite instance:

targets:
  - name: "statlite-self"
    type: "statlite-metrics"
    url: "http://127.0.0.1:9090/statlite/metrics"

The self-monitoring target includes StatLite process, database, host CPU, memory, and filesystem visibility through the normal dashboard.

Correctness and dashboard improvements

• Separated application health from reporting status.
• Improved counter recovery and poll-identity delta handling across restarts and stale data.
• Changed latency aggregation to be request-weighted.
• Clarified dashboard range behavior, metric units, SQLite path resolution, and integration guidance.
• Continued compatibility coverage for Spring Actuator, Spring Prometheus, Quarkus, and the deprecated Spring configuration alias.

Certification

The exact v0.4.1 candidate passed release certification for:

• Spring Boot 3.5.5 and 4.0.8 Actuator and Prometheus integrations.
• Deprecated Spring compatibility configuration.
• Quarkus 3.39.1 with Java 21.
• Historical SQLite upgrade and data preservation.
• Long-history dashboard stress testing with no HTTP failures.

The release candidate also passed exact-binary health, metrics, dashboard, self-monitoring, target-switching, and time-range smoke checks.

Try it

Run the exact release container:

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

Or use the rolling latest image:

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 local data.

Learn more

• StatLite on GitHub
• StatLite 0.4.1 release
• Documentation and installation
• Complete changelog