jane

Version, currently master branch1 version
  • master branchlatestAug 3, 2026

github.com/perfecto25/jane

linux monitoring system

0 stars
0 dependents
License: MIT

Installation

# Add this to your shard.yml
dependencies:
  jane:
    github: perfecto25/jane
    branch: master

master is a branch, not a release, so this tracks it rather than pinning a version.

Then run:

shards install

shard.yml

Crystal
1.11.0
License
MIT
Target
  • jane from src/jane.cr

Dependencies

Runtime Dependencies

  • toml*github: crystal-community/toml.cr
  • msgpack*github: crystal-community/msgpack-crystal
  • tallboy*github: epoch/tallboy

README

Jane Agent

Fresh, organic, farm to table metrics and events.

Description

Jane is a lightweight sytem and process monitoring software. It is inspired by Tildeslash Monit and uses the same philosophy to report on a system's metrics and observability.

Jane consists of 2 parts

  1. Jane agent - a basic monitoring agent that runs on a managed host and reports Metrics and Checks

Metrics show things like CPU utilization, memory usage, process uptime, etc

Checks show whether configured thresholds are over the limit and issue alerts

  1. Jane HQ - a central server that receives agent events and uses logical rules to send alerts to users based on Check thresholds.

Installation

TODO: Write installation instructions here

install prereqs

dnf install pcre2-devel

Usage

Alerting

Jane has 3 main methods of alerting.

  • direct email
  • HQ
  • slack

Jane will alert on any issues depending on how alerting is setup in config.toml

if HQ is enabled, it will alert to your HQ endpoint

only HQ or alert.email can be enabled at once, if both are enabled, Jane will send to HQ only.

alert.slack can be enabled with any other method - and will fire off a slack message regardless of other alerting methods.

Roadmap

  • add additional utils (network, process) (done)
  • ability to send alerts from agent via smtp host (done)
  • add Slack alert functionality

Contributing

  1. Fork it (https://github.com/perfecto25/jane/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors