zugorum

JVM	Platform	Status
OpenJDK (Temurin) Current	Linux
OpenJDK (Temurin) LTS	Linux
OpenJDK (Temurin) Current	Windows
OpenJDK (Temurin) LTS	Windows

Repository Relocation

Development of this project has moved to an open-source but not open-contribution model.

Source code and commits will remain publicly available perpetually, but issues and/or pull requests will be rejected and/or ignored. Additionally, this project will now only be available via a read-only mirror at:

https://codeberg.org/io7m-com/zugorum

zugorum

The zugorum package provides a server for making requests to external sites in order to test liveness, and publishing the results as Prometheus metrics.

Features

• Check the liveness of external sites and publish Prometheus metrics.
• A small, easily auditable codebase.
• Platform independence. No platform-dependent code is included in any form, and installations can largely be carried between platforms without changes.
• OCI-ready: Ready to run as an immutable, stateless, read-only, unprivileged container for maximum security and reliability.
• OSGi-ready.
• JPMS-ready.
• ISC license.

Usage

{
  "ListenAddress": "0.0.0.0",
  "ListenPort": 8190,
  "Checks": [
    {
      "Type": "HTTP2xx",
      "URI": "https://example.invalid",
      "PauseMinimum": "PT1S",
      "PauseMaximum": "PT10S"
    },
    {
      "Type": "HTTP2xx",
      "URI": "https://www.io7m.com",
      "PauseMinimum": "PT1S",
      "PauseMaximum": "PT10S"
    },
    {
      "Type": "HTTP2xx",
      "URI": "http://www.io7m.com",
      "PauseMinimum": "PT1S",
      "PauseMaximum": "PT10S"
    },
    ...
}

$ zugorum server --configuration config.json

Prometheus metrics will be available on port 8190.