https://github.com/plandes/gelfglance
Forward Glances statistics as gelf logs
https://github.com/plandes/gelfglance
gelf glances graylog logging monitoring
Last synced: 4 months ago
JSON representation
Forward Glances statistics as gelf logs
- Host: GitHub
- URL: https://github.com/plandes/gelfglance
- Owner: plandes
- License: apache-2.0
- Created: 2018-05-21T21:46:09.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-01-18T02:45:13.000Z (over 6 years ago)
- Last Synced: 2025-02-21T20:25:13.358Z (8 months ago)
- Topics: gelf, glances, graylog, logging, monitoring
- Language: Python
- Homepage:
- Size: 39.1 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Forward glance statistics as gelf logs
This command line utility forwards [Glances] statistics and forwards the data
to [Graylog]. The program runs in a loop for an (optional) given number of
times in a timeout. Each loop cycle collects data from the [Glances] server
and forwards the data as a "first class" (descrete fields) Graylog message.
With this data you can configured dashboards to report statistics based on
system health, temperatures etc.
The program currently records the following:
* CPU temperature (sensors)
* CPU load
Other data from [Glances] is very easy to add, I just haven't had a lot of time
to add them but I'd be glad to if someone asked for more. If so, create an
issue and I'll look into your request.
## Installing
You need Python 3 to run the program and the *pip* installer.
Install the library and program:
```bash
pip install gelfglance
```
For *systemd* operating systems, the example [systemd service] file might be
useful.
## Usage
Example: forward [Glances] statistics on server `jove.com` at port 61207 to
the [Graylog] server `ossage.com` every minute.
```bash
gelfglance server --gelfserver jove.com --glancesport 61207 --source ossage --glancesserver ossage.com -t 60
```
Here's the usage for convenience (use `--help`):
```pony
Usage: gelfglance [options]
Options:
--version show program's version number and exit
-h, --help show this help message and exit
-w NUMBER, --whine=NUMBER
add verbosity to logging
-x, --short short output for list
Usage: gelfglance server [additional options]
Start in server mode
Options:
-g STRING, --gelfserver=STRING
Graylog host name (defaults to localhost)
-p INTEGER, --gelfport=INTEGER
Graylog port (defaults to 12201)
-s STRING, --glancesserver=STRING
Glances server port (defaults to localhost)
-l INTEGER, --glancesport=INTEGER
Glances port (defaults to 61208)
-r STRING, --source=STRING
Graylog port (defaults to 12201)
-c STRING, --count=STRING
Number of messages to send (default to infinite)
-t STRING, --timeout=STRING
Timeout between each sent message in seconds (defaults to 10)
-h, --help show this help message and exit
```
## Changelog
An extensive changelog is available [here](CHANGELOG.md).
## License
Copyright © 2018 Paul Landes
Apache License version 2.0
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
[Glances]: https://nicolargo.github.io/glances/
[Graylog]: https://www.graylog.org
[systemd service]: config/glancesgelf.service