sysmon/README.md

43 lines
1.1 KiB
Markdown
Raw Normal View History

2021-05-21 09:08:43 +00:00
# System Monitor
2021-04-25 13:25:20 +00:00
2021-05-21 09:08:43 +00:00
Java based system monitoring solution with support for plugins.
2021-04-25 13:25:20 +00:00
- Example Grafana [dashboard](https://bitbucket.org/mnellemann/sysmon/downloads/sysmon-example-dashboard.png) showing metrics from a host running *sysmon*.
2021-04-25 13:25:20 +00:00
## Known problems
### Correct timezone and clock
- Ensure you have **correct timezone and date/time** and NTPd (or similar) running to keep it accurate!
### Naming collision
You can't have hosts with the same name, as these cannot be distinguished when metrics are
written to InfluxDB (which uses the hostname as key).
### Renaming hosts
If you rename a host, the metrics in InfluxDB will still be available by the old hostname, and new metrics will be written with the new hostname. There is no easy way to migrate the old data, but you can delete it easily:
```text
USE sysmon;
DELETE WHERE hostname = 'unknown';
```
## Components
2021-04-25 13:25:20 +00:00
### Client
2021-04-25 13:25:20 +00:00
Runs on your hosts and collects metrics, which are sent to the central *server*.
2021-04-25 13:25:20 +00:00
### Server
Receives aggregated metrics from clients and saves these into InfluxDB.
2021-04-25 13:25:20 +00:00
### Plugins
Loaded by the client and provides extensions for doing the actual collecting of metrics.