https://github.com/sebyx07/stats-lite
Get system stats of your linux servers. CPU, RAM, HDD, extendable
https://github.com/sebyx07/stats-lite
devops linux monitoring rails rails5 ruby
Last synced: 5 months ago
JSON representation
Get system stats of your linux servers. CPU, RAM, HDD, extendable
- Host: GitHub
- URL: https://github.com/sebyx07/stats-lite
- Owner: sebyx07
- License: mit
- Created: 2019-10-04T10:03:43.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-01-20T07:25:29.000Z (about 3 years ago)
- Last Synced: 2024-10-29T14:15:19.707Z (over 1 year ago)
- Topics: devops, linux, monitoring, rails, rails5, ruby
- Language: Ruby
- Homepage: https://github.com/sebyx07/stats-lite
- Size: 98.6 KB
- Stars: 9
- Watchers: 3
- Forks: 1
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# StatsLite
Simple way to get server information as json. Easy to extend with a `config.rb` file.
Embeddable in Rails
### Standalone usage
Requirements ruby, min version 2
```shell_script
sudo apt-get install -y ruby build-essential ruby-dev
```
Usage standalone, you might need to run some commands as __sudo__.
```shell_script
gem install stats_lite --no-ri --no-rdoc
stats-lite
curl http://localhost:9111
```
Add to startup, crontab
```shell_script
crontab -e
# then add
@reboot /usr/local/bin/stats-lite /home/deploy/.stats-lite/config.rb
```
create a `config.rb` then `stats-lite`
```ruby
# example config.rb
# basic usage
StatsLite.configure do |s|
s.password "1234" # password protection
s.port 9111 # listening port
end
```
```shell_script
# now it's protected by passowrd
curl http://localhost:9111?password=1234
```
### Rails usage
`gem "stats_lite"`
```ruby
# routes.rb
mount StatsLite::App => "/server-stats"
```
### Advanced configuration
```ruby
StatsLite.configure do |s, h|
s.password ENV["STATS_LITE_PASS"] # defaults to nil, unprotected
s.port ENV["STATS_LITE_PORT"] # defaults to 9111
s.data -> (data) do # add more data
data[:ruby_current_time] = Time.now # simple value
data[:linux_time] = h.command("date") # bash command, supports {cache: true, expires_in: 60}
data[:slow_command] = h.fetch :slow_command, -> {
sleep 1
"slow command"
}, expires_in: 5 # cached ruby value
end
s.app do |sinatra| # extend the app, add multiple routes, which are protected by the password
sinatra.get("/another_route") do
content_type :json
{ cpus: h.command("nproc", { cache: true }) }.to_json
end
end
s.rack do # use rack builder, it's also password protected from above^
map "/rack" do
run lambda { |env| [200, {'Content-Type' => 'text/plain'}, ['OK']] }
end
end
s.cron do |rufus| # uses the Rufus scheduler, more details here https://github.com/jmettraux/rufus-scheduler
rufus.every "5s" do
print "\n cron job"
end
rufus.every "1h" do
print "\n hourly cron job"
end
end
end
```