true Scout, Eric Lindvall

memory, process

class ProcessUsage < Scout::Plugin  
  MEM_CONVERSION = 1024
  
  def build_report
    if option(:command_name).nil? or option(:command_name) == ""
      return error("Please specify the name of the process you want to monitor.")
    end
    ps_command   = option(:ps_command) || "ps auxww"
    ps_regex     = (option(:ps_regex) || "(?i:\\bCOMMAND\\b)").to_s.gsub("COMMAND") { Regexp.escape(option(:command_name)) }

    ps_output = `#{ps_command}`
    unless $?.success?
      return error("Couldn't use `ps` as expected.", error.message)
    end

    ps_lines = ps_output.split(/\n/)
    fields   = ps_lines.shift.downcase.split
    unless (memory_index = fields.index("rss")) && (pid_index = fields.index('pid'))
      return error( "RSS or PID field not found.",
                    "The output from `#{ps_command}` did not include the needed RSS and PID fields." )
    end

    # narrow the ps lines to just those mentioning the process we're interested in
    process_lines = ps_lines.grep(Regexp.new(ps_regex))

    if process_lines.any?
      rss_values = process_lines.map { |com| Float(com.split[memory_index]).abs }
      pids       = process_lines.map { |com| Integer(com.split[pid_index]) }
      highest    = rss_values.max
      total      = rss_values.inject(0){|s,value| s + value }
      restarts   = 0

      if remembered_pids = memory(:pids)
        # Find how many new pids we haven't seen before
        new_pids     = (pids - remembered_pids).length

        # Find how many more pids we have now than before
        started_pids = pids.length - remembered_pids.length
        started_pids = 0 if started_pids < 1

        # Don't include newly started processes as restarts
        restarts = new_pids - started_pids
      end

      report(:memory        => (highest/MEM_CONVERSION).to_i,
             :total_rss     => (total/MEM_CONVERSION).to_i,
             :num_processes => process_lines.size,
             :restarts      => restarts)

      remember(:pids => pids)
    else
      error( "Command not found.",
             "No processes found matching #{option(:command_name)}." )
    end
  rescue Exception => e
    error("Error when executing: #{e.class}", e.message)
  end
end

2007-12-12T15:49:41-08:00

Given a process name, this plugin monitors: * _Number of Processes_ - the number of matching processes running * _Largest Process Memory Usage_ - the memory usage (RSS) of the largest instance * _Total Memory Usage_ - the total memory usage (RSS) across all process instances. * _Restarts_ - the number of process restarts true 1 --- | options: command_name: name: Command Name notes: The name of the command to pull statistics for. default: mongrel_rails ps_command: name: The Process Status (ps) Command notes: The command with options. The default works on most systems. default: ps auxww ps_regex: name: The regex used to match a command name. notes: "By default, this matches a command name anywhere in the ps output line. The word COMMAND get's replaced with the command you gave (regex escaped). You may wish to try the following pattern if you only want to match a command in the last column: (?i:COMMAND\\s+$)" default: "(?i:\\bCOMMAND\\b)" metadata: memory: label: Largest Process Memory Usage units: MB precision: 0 total_rss: label: Total Memory Usage units: MB precision: 0 num_processes: label: Number of Processes units: "" precision: 0 restarts: label: Restarts units: "" precision: 0 triggers: - type: peak dname: memory max_value: 10 - type: trend dname: memory direction: UP percentage_change: 20 duration: 60 window_reference: LAST_WEEK min_value: 5 Process Usage

247

4.0

Process Usage Plugin ==================== Created by [Highgroove Studios LLC](http://www.highgroove.com) Compatibility ------------- Works on Linux and OSX.

Monitors the memory usage of a process, generating an alert if it exceeds a specified threshold.

linux macosx solaris

2010-01-21T15:18:47-08:00

http://github.com/highgroove/scout-plugins/raw/master/process_memory/process_usage.rb