https://github.com/schanur/steel-copper

System monitoring web service with nice graphs
https://github.com/schanur/steel-copper

collectd graphs monitoring rocket rrd rrd-files rrdtool rust webserver webservice

Last synced: 19 days ago
JSON representation

System monitoring web service with nice graphs

• Host: GitHub
• URL: https://github.com/schanur/steel-copper
• Owner: schanur
• License: mit
• Created: 2020-07-30T20:28:20.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2022-06-18T21:12:10.000Z (over 2 years ago)
• Last Synced: 2024-10-10T20:41:48.718Z (about 1 month ago)
• Topics: collectd, graphs, monitoring, rocket, rrd, rrd-files, rrdtool, rust, webserver, webservice
• Language: Rust
• Homepage: https://github.com/schanur/steel-copper
• Size: 43.9 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Steel-Copper

## Simple system monitoring using graphs

Steel-Copper is a web-server which renders rrd database files to graphs using rrdtool.

## Screenshot

![Screenshot of monitoring website with multiple graphs](https://assets.schanur.net/steel-copper/screenshots/graphs_dark_v1.png)

## Usage

After starting the steel-copper binary, the integrated web server starts on port 8000.

If you want to modify startup parameter (TCP port, etc.), you have multiple options:

* Create Rocket.toml file in the directory where you run steel-copper. [Rocket.toml configuration manual](https://rocket.rs/v0.4/guide/configuration/)

* Use environment variables. [Examples](https://api.rocket.rs/v0.4/rocket/config/index.html#environment-variables)

## Dependencies

* collectd service has to be installed and running to create/update periodic sample databases (rrd database files).

* rrdgraph binary is required to render the graphs. On most Linux distributions, the tool is included in the rrdtool package.

* nightly version of Rust. This will change in the near future, so that stable Rust will be able to build it.

## Installation

```

cargo +nightly install steel-copper

```

installs the steel-copper binary.

## Building from source

```

cargo build --release

```

builds a single executable file steel-copper in the directory target/release.

## Contribute

This is a very young project with a small feature set. Two types of input I would like to get are feature requests of things you are missing and of course bug reports.