Project

servermonitor

0.0
No commit activity in last 3 years
No release in over 3 years
servermonitorneidiom/servermonitorHomepageDocumentationSource CodeBug TrackerWiki
A collection of server monitoring ruby scripts packaged in a gem
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
9,824
Stars
0
Forks
0
Watchers
1
 Releases
Current version
0.1.2
Total releases
6
First release
2017-04-17
Latest release
2017-10-29
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2017-10-17
Reverse Dependencies
0

 Dependencies

Development

rspec
~> 3.6

Runtime

mail
~> 2.6
 Project Readme

Ruby Server Monitor

This is a configurable Ruby gem providing a collection of server monitoring scripts.

Current scripts provided

  • Mailq - check number of messages in the server's mail queue
  • MegaCliVDStatus - check the status of LSI RAID Controller Virtual Drive
  • MegaCliDiskSMARTStatus - check if disk returns a S.M.A.R.T alert

Custom configuration examples

Configure MailQ script

#!/usr/bin/env ruby -w

require "servermonitor/mailq"

ServerMonitor::Mailq.configure do |config|
  config.path       = "/opt/zimbra/common/sbin/postqueue -p"
  config.grep       = "/bin/grep"
  config.exit_codes = false
end

ServerMonitor::Mailq.run

Configure MegaCliVDStatus script

Output VD (Virtual Drive) status to STDOUT

#!/usr/bin/env ruby -w

require "servermonitor/megacli_vd_status"

ServerMonitor::MegaCliVDStatus.configure do |config|
  config.megacli    = "/usr/sbin/megacli"
  config.grep       = "/bin/grep"
  config.exit_codes = false
end

ServerMonitor::MegaCliVDStatus.run

Send VD (Virtual Drive) status to email

#!/usr/bin/env ruby -w

require "servermonitor/megacli_vd_status"

ServerMonitor::MegaCliVDStatus.configure do |config|
  config.megacli        = "/usr/sbin/megacli"
  config.grep           = "/bin/grep"
  config.exit_codes     = false
  config.email_to       = "example@example.to"
  config.email_from     = "example@example.from"
  config.smtp_address   = "server"
  config.smtp_port      = "25"
  config.smtp_username  = "username"
  config.smtp_password  = "password"
end

ServerMonitor::MegaCliVDStatus.run

Configure MegaCliDiskSMARTStatus script

Output disk S.M.A.R.T alerts to STDOUT

#!/usr/bin/env ruby -w

require "servermonitor/megacli_disk_smart_status"

ServerMonitor::MegaCliDiskSMARTStatus.configure do |config|
  config.megacli        = "/usr/sbin/megacli"
  config.grep           = "/bin/grep"
  config.exit_codes     = false
end

ServerMonitor::MegaCliDiskSMARTStatus.run

Send disk S.M.A.R.T alerts to email

#!/usr/bin/env ruby -w

require "servermonitor/megacli_disk_smart_status"

ServerMonitor::MegaCliDiskSMARTStatus.configure do |config|
  config.megacli        = "/usr/sbin/megacli"
  config.grep           = "/bin/grep"
  config.exit_codes     = false
  config.email_to       = "example@example.to"
  config.email_from     = "example@example.from"
  config.smtp_address   = "server"
  config.smtp_port      = "25"
  config.smtp_username  = "username"
  config.smtp_password  = "password"
end

ServerMonitor::MegaCliDiskSMARTStatus.run

RVM and Shebang

#!/usr/bin/env rvm-auto-ruby

require "servermonitor/mailq"

ServerMonitor::Mailq.configure do |config|
  config.path       = "/opt/zimbra/common/sbin/postqueue -p"
  config.grep       = "/bin/grep"
  config.exit_codes = false
end

ServerMonitor::Mailq.run

Use with external monitoring systems

Set exit_codes to true in order to use with monit

Example monit configuration to check postfix mailqueue

  • find out path of binary with which postmailq
  • put script in /etc/monit/conf.d/chech_mail-queue 
check program CheckMailQueue path "/home/nedim/.rvm/gems/ruby-2.4.2/bin/postmailq"
    if status != 0 then alert
  • replace /home/nedim/.rvm/gems/ruby-2.4.2/bin/postmailq with output you got from which postmailq

Howto manually invoke

Commands

servermonitor

postmailq

Install with Bundler

Add to your Gemfile

gem 'servermonitor', git: 'https://github.com/neidiom/servermonitor.git'

Run bundler

bundle install

Manually build the ServerMonitor gem

gem build servermonitor.gemspec
ls *.gem
gem install servermonitor-*.gem