true Highgroove Studios

passenger

class PassengerMemoryStats < Scout::Plugin
  def build_report
    cmd  = option(:passenger_memory_stats_command) || "passenger-memory-stats"
    data = `#{cmd} 2>&1`
    if $?.success?
      stats = parse_data(data)
      report(stats)
      stats.each do |name, total|
        short_name = name.sub(/_total\z/, "")
        max        = option("max_#{short_name}").to_f
        next unless max.nonzero?
        num        = total.to_f
        mem_name   = "#{name}_failure"
        human_name = short_name.capitalize.
                                gsub(/_([a-z])/) { " #{$1.capitalize}"}.
                                gsub("Vms", "VMS")
        if num > max and not memory(mem_name)
          alert "Maximum #{human_name} Exceeded (#{total})", ''
          remember(mem_name => true)
        elsif num < max and memory(mem_name)
          alert "Maximum #{human_name} Has Dropped Below Limit (#{total})", ''
          memory.delete(mem_name)
        else
          remember(mem_name => memory(mem_name))
        end
      end
    else
      error "Could not get data from command", "Error:  #{data}"
    end
  end

  private

  def parse_data(data)
    table        = nil
    headers      = nil
    field_format = nil
    stats        = { "apache_processes"        => 0,
                     "apache_vmsize_total"     => 0.0,
                     "apache_private_total"    => 0.0,
                     "nginx_processes"         => 0,
                     "nginx_vmsize_total"      => 0.0,
                     "nginx_private_total"     => 0.0,
                     "passenger_processes"     => 0,
                     "passenger_vmsize_total"  => 0.0,
                     "passenger_private_total" => 0.0 }

    data.each do |line|
      line = line.gsub(/\e\[\d+m/,'')
      if line =~ /^\s*-+\s+(Apache|Passenger|Nginx)\s+processes/
        table        = $1.downcase
        headers      = nil
        field_format = nil
      elsif table and line =~ /^\s*###\s+Processes:\s*(\d+)/
        stats["#{table}_processes"] = $1
      elsif table and line =~ /^[A-Za-z]/
        headers      = line.scan(/\S+\s*/)
        field_format = headers.map { |h| "A#{h.size - 1}" }.join("x").
                               sub(/\d+\z/, "*")
        headers.map! { |h| h.strip.downcase }
      elsif table and headers and line =~ /^\d/
        fields = Hash[*headers.zip(line.strip.unpack(field_format)).flatten]
        stats["#{table}_vmsize_total"] += as_mb(fields["vmsize"])
        stats["#{table}_private_total"] += as_mb(fields["private"])
      end
    end

    stats.each_key do |field|
      if field =~ /(?:vmsize|private)_total\z/
        stats[field] = "#{stats[field]} MB"
      end
    end

    stats
  end

  def as_mb(memory_string)
    num = memory_string.to_f
    case memory_string
    when /\bB/i
      num / (1024 * 1024).to_f
    when /\bKB/i
      num / 1024.0
    when /\bGB/i
      num * 1024
    else
      num
    end
  end
end

2008-08-22T08:49:33-07:00

Tracks "Phusion Passenger's":http://www.modrails.com VM size, process count, and the amount of private memory it has squirreled away. You can also elect to be emailed if any of these statistics crosses a line you indicate. As an added bonus, this plugin also tracks the same statistics for the Apache instance managing Passenger. The passenger-memory-stats program recommends that you run it with super user privileges to gain more information. This plugin is usable without the extra access rights, but you will need to add them if you want the full details. Note that *you need to edit the sudoers file on your server to allow the Scout agent to run @passenger-memory-stats@ without a password*. You will need to address this access issue on your server. "Learn how here":https://scoutapp.com/plugin_urls/82-phusion-passenger-monitor/help_entries/91 false 82 --- | options: passenger_memory_stats_command: name: The Passenger Memory Stats Command notes: The full path to the passenger-memory-stats command. default: /usr/bin/passenger-memory-stats max_apache_processes: name: Max Apache Processes notes: If Apache's process count is larger than this amount, an alert is generated. Use 0 to disable this check. default: 0 max_apache_vmsize: name: Max Apache VMSize (MB) notes: If Apache's memory is larger than this amount, an alert is generated. Use 0 to disable this check. default: 2000 max_apache_private: name: Max Apache Private Memory (MB) notes: If Apache's private memory is larger than this amount, an alert is generated. Use 0 to disable this check. default: 0 max_passenger_processes: name: Max Passenger Processes notes: If Passenger's process count is larger than this amount, an alert is generated. Use 0 to disable this check. default: 0 max_passenger_vmsize: name: Max Passenger VMSize (MB) notes: If Passenger's memory is larger than this amount, an alert is generated. Use 0 to disable this check. default: 500 max_passenger_private: name: Max Passenger Private Memory (MB) notes: If Passenger's private memory is larger than this amount, an alert is generated. Use 0 to disable this check. default: 0 Phusion Passenger Monitor

121

0.0

Passenger Memory Stats ====================== Created by [Highgroove Studios LLC](http://www.highgroove.com) Compatibility ------------- Works on Linux. Sudo Usage ---------- The passenger-memory-stats program recommends that you run it would super user privileges to gain more information. This plugin is usable without the extra access rights, but you will need to add them if you want the full details. It's important to note though that it is not safe for you to transmit your super user password to us. You will need to address this access issue on your server. Our recommended procedure to handle this is: 1. Edit the sudoers file on your server to allow the user that runs the scout client listed in your crontab to be able to run passenger-memory-stats without a password 2. Login into Scout and edit your plugin settings to add sudo in front of the command name

Tracks Passenger's VM size, process count, and the amount of private memory it has squirreled away. You can also elect to be emailed if any of these statistics crosses a line you indicate.

linux

2010-03-03T21:16:53-08:00

http://github.com/highgroove/scout-plugins/raw/5bb58ea082496cbbef5f8d1bb0d84a2a82b0297a/passenger_memory_stats/passenger_memory_stats.rb