maatkit-ruby 0.1.0

data/lib/maatkit-ruby/mk-kill.rb

@@ -0,0 +1,124 @@
+  # = maatkit-ruby - A maatkit gem for Ruby
+  #
+  # Homepage::  http://github.com/jjuliano/maatkit-ruby
+  # Author::    Joel Bryan Juliano
+  # Copyright:: (cc) 2011 Joel Bryan Juliano
+  # License::   MIT
+
+  #
+  # Kill MySQL queries that match certain criteria.
+  #
+  # Maatkit::Kill.new( array, str, array)
+  #
+  class Maatkit::Kill
+
+    attr_accessor :all # FALSE
+    attr_accessor :ask_pass # FALSE
+    attr_accessor :busy_time # (No value)
+    attr_accessor :charset # (No value)
+    attr_accessor :config # /etc/maatkit/maatkit.conf,/etc/maatkit/mk_kill.conf,/home/joel/.maatkit.conf,/home/joel/.mk_kill.conf
+    attr_accessor :daemonize # FALSE
+    attr_accessor :defaults_file # (No value)
+    attr_accessor :execute_command # (No value)
+    attr_accessor :heartbeat # FALSE
+    attr_accessor :help # TRUE
+    attr_accessor :host # (No value)
+    attr_accessor :idle_time # (No value)
+    attr_accessor :ignore_command # (No value)
+    attr_accessor :ignore_db # (No value)
+    attr_accessor :ignore_host # (No value)
+    attr_accessor :ignore_info # (No value)
+    attr_accessor :ignore_self # TRUE
+    attr_accessor :ignore_state # Locked
+    attr_accessor :ignore_user # (No value)
+    attr_accessor :interval # 30
+    attr_accessor :iterations # 1
+    attr_accessor :kill # FALSE
+    attr_accessor :kill_query # FALSE
+    attr_accessor :log # (No value)
+    attr_accessor :match_command # (No value)
+    attr_accessor :match_db # (No value)
+    attr_accessor :match_host # (No value)
+    attr_accessor :match_info # (No value)
+    attr_accessor :match_state # (No value)
+    attr_accessor :match_user # (No value)
+    attr_accessor :only_oldest # TRUE
+    attr_accessor :password # (No value)
+    attr_accessor :pid # (No value)
+    attr_accessor :port # (No value)
+    attr_accessor :print # FALSE
+    attr_accessor :replication_threads # FALSE
+    attr_accessor :run_time # (No value)
+    attr_accessor :set_vars # wait_timeout=10000
+    attr_accessor :socket # (No value)
+    attr_accessor :user # (No value)
+    attr_accessor :version # FALSE
+    attr_accessor :wait_after_kill # (No value)
+    attr_accessor :wait_before_kill # (No value)
+
+    #
+    # Sets the executable path, otherwise the environment path will be used.
+    #
+    attr_accessor :path_to_mk_kill
+
+    #
+    # Returns a new Kill Object
+    #
+    def initialize()
+    end
+
+    #
+    # Execute the command
+    #
+    def start(options = nil)
+      tmp = Tempfile.new('tmp')
+      command = option_string() + options.to_s + " 2> " + tmp.path
+      success = system(command)
+      if success
+        begin
+          while (line = tmp.readline)
+            line.chomp
+            selected_string = line
+          end
+        rescue EOFError
+          tmp.close
+        end
+        return selected_string
+      else
+        tmp.close!
+        return success
+      end
+    end
+
+    def config
+      option_string()
+    end
+
+    private
+
+    def option_string()
+
+      unless @path_to_mk_kill
+        ostring = "mk-kill "
+      else
+        ostring = @path_to_mk_kill + " "
+      end
+
+      self.instance_variables.each do |i|
+        tmp_value = self.instance_variable_get "#{i}"
+        tmp_string = i.gsub("_", "-").gsub("@", "--")
+        unless tmp_string == "--path-to-mk-kill"
+          if (tmp_value.is_a? TrueClass) || (tmp_value.is_a? FalseClass)
+            ostring += "#{tmp_string} "
+          else
+            ostring += "#{tmp_string} #{tmp_value} "
+          end
+        end
+      end
+
+      return ostring
+
+    end
+
+  end
+

data/lib/maatkit-ruby/mk-loadavg.rb

@@ -0,0 +1,313 @@
+  # = maatkit-ruby - A maatkit gem for Ruby
+  #
+  # Homepage::  http://github.com/jjuliano/maatkit-ruby
+  # Author::    Joel Bryan Juliano
+  # Copyright:: (cc) 2011 Joel Bryan Juliano
+  # License::   MIT
+
+  #
+  # Watch MySQL load and take action when it gets too high.
+  #
+  # Maatkit::LoadAvg.new( array, str, array)
+  #
+  class Maatkit::LoadAvg
+
+    #
+    # group: Action
+    # Trigger the actions only when all "--watch" items exceed their thresholds.
+    # The default is to trigger the actions when any one of the watched items exceeds its threshold.  This
+    # option requires that all watched items exceed their thresholds before any action is triggered.
+    attr_accessor :and # FALSE
+
+    #
+    # Prompt for a password when connecting to MySQL.
+    attr_accessor :ask_pass # FALSE
+
+    #
+    # short form: -A; type: string
+    # Default character set.  If the value is utf8, sets Perl's binmode on STDOUT to utf8, passes the
+    # mysql_enable_utf8 option to DBD::mysql, and runs SET NAMES UTF8 after connecting to MySQL.  Any other
+    # value sets binmode on STDOUT without the utf8 layer, and runs SET NAMES after connecting to MySQL.
+    attr_accessor :charset # (No value)
+
+    #
+    # type: Array
+    # Read this comma-separated list of config files; if specified, this must be the first option on the
+    # command line.
+    attr_accessor :config # /etc/maatkit/maatkit.conf,/etc/maatkit/mk_loadavg.conf,/home/joel/.maatkit.conf,/home/joel/.mk_loadavg.conf
+
+    #
+    # Fork to the background and detach from the shell.  POSIX operating systems only.
+    attr_accessor :daemonize # FALSE
+
+    #
+    # short form: -D; type: string
+    # Database to use.
+    attr_accessor :database # (No value)
+
+    #
+    # short form: -F; type: string
+    # Only read mysql options from the given file.  You must give an absolute pathname.
+    attr_accessor :defaults_file # (No value)
+
+    #
+    # type: string; group: Action
+    # Execute this command when watched items exceed their threshold values
+    # This command will be executed every time a "--watch" item (or all items if "--and" is specified)
+    # exceeds its threshold.  For example, if you specify "--watch "Server:vmstat:swpd:":0">, then this
+    # command will be executed when the server begins to swap and it will be executed again at each
+    # "--interval" so long as the server is still swapping.
+    # After the command is executed, mk-loadavg has no control over it, so it is responsible for its own info
+    # gathering, logging, interval, etc.  Since the command is spawned from mk-loadavg, its STDOUT, STDERR
+    # and STDIN are closed so it doesn't interfere with mk-loadavg.  Therefore, the command must redirect its
+    # output to files or some other destination.  For example, if you specify "--execute-command 'echo
+    # Hello'", you will not see "Hello" printed anywhere (neither to screen nor "--log") because STDOUT is
+    # closed for the command.
+    # No information from mk-loadavg is passed to the command.
+    # See also "--and".
+    attr_accessor :execute_command # (No value)
+
+    #
+    # Show help and exit.
+    attr_accessor :help # TRUE
+
+    #
+    # short form: -h; type: string
+    # Connect to host.
+    attr_accessor :host # (No value)
+
+    #
+    # type: time; default: 60s; group: Watch
+    # How long to sleep between each check.
+    attr_accessor :interval # 60
+
+    #
+    # type: string
+    # Print all output to this file when daemonized.
+    # Output from "--execute-command" is not printed to this file.
+    attr_accessor :log # (No value)
+
+    #
+    # short form: -p; type: string
+    # Password to use when connecting.
+    attr_accessor :password # (No value)
+
+    #
+    # type: string
+    # Create the given PID file when daemonized.  The file contains the process ID of the daemonized
+    # instance.  The PID file is removed when the daemonized instance exits.  The program checks for the
+    # existence of the PID file when starting; if it exists and the process with the matching PID exists, the
+    # program exits.
+    attr_accessor :pid # (No value)
+
+    #
+    # short form: -P; type: int
+    # Port number to use for connection.
+    attr_accessor :port # (No value)
+
+    #
+    # type: time
+    # Time to run before exiting.
+    # Causes "mk-loadavg" to stop after the specified time has elapsed.  Optional suffix: s=seconds,
+    # m=minutes, h=hours, d=days; if no suffix, s is used.
+    attr_accessor :run_time # (No value)
+
+    #
+    # type: string; default: /tmp/mk-loadavg-sentinel
+    # Exit if this file exists.
+    attr_accessor :sentinel # /tmp/mk_loadavg_sentinel
+
+    #
+    # type: string; default: wait_timeout=10000
+    # Set these MySQL variables.  Immediately after connecting to MySQL, this string will be appended to SET
+    # and executed.
+    attr_accessor :set_vars # wait_timeout=10000
+
+    #
+    # short form: -S; type: string
+    # Socket file to use for connection.
+    attr_accessor :socket # (No value)
+
+    #
+    # Stop running instances by creating the "--sentinel" file.
+    attr_accessor :stop # FALSE
+
+    #
+    # short form: -u; type: string
+    # User for login if not current user.
+    attr_accessor :user # (No value)
+
+    #
+    # short form: -v
+    # Print information to STDOUT about what is being done.
+    # This can be used as a heartbeat to see that mk-loadavg is still properly watching all its values.  If
+    # "--log" is specified, this information will be printed to that file instead.
+    attr_accessor :verbose # FALSE
+
+    #
+    # Show version and exit.
+    attr_accessor :version # FALSE
+
+    #
+    # type: string; default: vmstat 1 2; group: Watch
+    # vmstat command for "--watch" Server:vmstat:...
+    # The vmstat output should look like:
+    #  procs -----------memory---------- ---swap-- -----io---- -system-- ----cpu----
+    #  r  b # swpd # free # buff  cache # si # so #  bi #  bo # in # cs us sy id wa
+    #  0  0 #  # 0 590380 143756 571852 #  0 #  0 #   6 #   9  228  340  4  1 94  1
+    #  0  0 #  # 0 590400 143764 571852 #  0 #  0 #   0 #  28  751  818  4  2 90  3
+    # The second line from the top needs to be column headers for subsequent lines.  Values are taken from
+    # the last line.
+    # The default, "vmstat 1 2",  gets current values.  Running just "vmstat" would get average values since
+    # last reboot.
+    attr_accessor :vmstat # vmstat # 1 # 2
+
+    #
+    # type: time; default: 60s
+    # Wait this long to reconnect to MySQL.
+    # If the MySQL server goes away between "--interval" checks, mk-loadavg will attempt to reconnect to
+    # MySQL forever, sleeping this amount of time in between attempts.
+    attr_accessor :wait # 60
+
+    #
+    # type: string; group: Watch
+    # A comma-separated list of watched items and their thresholds (required).
+    # Each watched item is string of arguments separated by colons (like arg:arg).  Each argument defines the
+    # watch item: what particular value is watched and how to compare the current value to a threshold value
+    # (N).  Multiple watched items can be given by separating them with a comma, and the same watched item
+    # can be given multiple times (but, of course, it only makes sense to do this if the comparison and/or
+    # threshold values are differnt).
+    # The first argument is the most important and is case-sensitive.  It defines the module responsible for
+    # watching the value.  For example,
+    #   --watch Status:...
+    # causes the WatchStatus module to be loaded.  The second and subsequent arguments are passed to the
+    # WatchStatus module which parses them.  Each watch module requires different arguments.  The watch
+    # modules included in mk-loadavg and what arguments they require are listed below.
+    # This is a common error when specifying "--watch" on the commnad line:
+    #  # mk-loadavg --watch Server:vmstat:swpd:>:0
+    #  # Failed to load --watch WatchServer: Error parsing parameters vmstat:swpd:: No comparison parameter; expected >, < or = at ./mk-loadavg line 3100.
+    # The "--watch" values need to be quoted:
+    #  # mk-loadavg --watch "Server:vmstat:swpd:>:0"
+    # Status
+    #  #  Watch SHOW STATUS, SHOW INNODB STATUS, and SHOW SLAVE STATUS values.  The value argument is case-
+    #  #  sensitive.
+    #  #  # --watch Status:[status|innodb|slave]:value:[><=]:N
+    #  #  Examples:
+    #  #  # --watch "Status:status:Threads_connected:>:16"
+    #  #  # --watch "Status:innodb:Innodb_buffer_pool_hit_rate:<:0.98"
+    #  #  # --watch "Status:slave:Seconds_behind_master:>:300"
+    #  #  You can easily see what values are available for SHOW STATUS and SHOW SLAVE STATUS, but the values
+    #  #  for SHOW INNODB STATUS are not apparent.  Some common values are:
+    #  #  # Innodb_buffer_pool_hit_rate
+    #  #  # Innodb_buffer_pool_pages_created_sec
+    #  #  # Innodb_buffer_pool_pages_dirty
+    #  #  # Innodb_buffer_pool_pages_read_sec
+    #  #  # Innodb_buffer_pool_pages_written_sec
+    #  #  # Innodb_buffer_pool_pending_data_writes
+    #  #  # Innodb_buffer_pool_pending_dirty_writes
+    #  #  # Innodb_buffer_pool_pending_fsyncs
+    #  #  # Innodb_buffer_pool_pending_reads
+    #  #  # Innodb_buffer_pool_pending_single_writes
+    #  #  # Innodb_common_memory_allocated
+    #  #  # Innodb_data_fsyncs_sec
+    #  #  # Innodb_data_pending_fsyncs
+    #  #  # Innodb_data_pending_preads
+    #  #  # Innodb_data_pending_pwrites
+    #  #  # Innodb_data_reads_sec
+    #  #  # Innodb_data_writes_sec
+    #  #  # Innodb_insert_buffer_pending_reads
+    #  #  # Innodb_rows_read_sec
+    #  #  # Innodb_rows_updated_sec
+    #  #  # lock_wait_time
+    #  #  # mysql_tables_locked
+    #  #  # mysql_tables_used
+    #  #  # row_locks
+    #  #  # io_avg_wait
+    #  #  # io_wait
+    #  #  # max_io_wait
+    #  #  Several of those values can appear multiple times in the SHOW INNODB STATUS output.  The value used
+    #  #  for comparison is always the higest value.  So the value for io_wait is the highest io_wait value
+    #  #  for all the IO threads.
+    # Processlist
+    #  #  Watch aggregated SHOW PROCESSLIST values.
+    #  #  #  --watch Processlist:[db|user|host|state|command]:value:[count|time]:[><=]:N
+    #  #  Examples:
+    #  #  # --watch "Processlist:state:Locked:count:>:5"
+    #  #  # --watch "Processlist:command:Query:time:<:1"
+    # Server
+    #  #  Watch server values.
+    #  #  #  --watch Server:loadavg:[1|5|15]:[><=]:N
+    #  #  #  --watch Server:vmstat:[r|b|swpd|free|buff|cache|si|so|bi|bo|in|cs|us|sy|id|wa]:[><=]:N
+    #  #  Examples:
+    #  #  # --watch "Server:loadavg:5:>:4.00"
+    #  #  # --watch "Server:vmstat:swpd:>:0"
+    #  #  # --watch "Server:vmstat:free:=:0"
+    #  #  See "--vmstat".
+    attr_accessor :watch # (No value)
+
+    #
+    # Sets the executable path, otherwise the environment path will be used.
+    #
+    attr_accessor :path_to_mk_loadavg
+
+    #
+    # Returns a new LoadAvg Object
+    #
+    def initialize()
+    end
+
+    #
+    # Execute the command
+    #
+    def start(options = nil)
+      tmp = Tempfile.new('tmp')
+      command = option_string() + options.to_s + " 2> " + tmp.path
+      success = system(command)
+      if success
+        begin
+          while (line = tmp.readline)
+            line.chomp
+            selected_string = line
+          end
+        rescue EOFError
+          tmp.close
+        end
+        return selected_string
+      else
+        tmp.close!
+        return success
+      end
+    end
+
+    def config
+      option_string()
+    end
+
+    private
+
+    def option_string()
+
+      unless @path_to_mk_loadavg
+        ostring = "mk-loadavg "
+      else
+        ostring = @path_to_mk_loadavg + " "
+      end
+
+      self.instance_variables.each do |i|
+        tmp_value = self.instance_variable_get "#{i}"
+        tmp_string = i.gsub("_", "-").gsub("@", "--")
+        unless tmp_string == "--path-to-mk-loadavg"
+          if (tmp_value.is_a? TrueClass) || (tmp_value.is_a? FalseClass)
+            ostring += "#{tmp_string} "
+          else
+            ostring += "#{tmp_string} #{tmp_value} "
+          end
+        end
+      end
+
+      return ostring
+
+    end
+
+  end
+

data/lib/maatkit-ruby/mk-log-player.rb

@@ -0,0 +1,316 @@
+  # = maatkit-ruby - A maatkit gem for Ruby
+  #
+  # Homepage::  http://github.com/jjuliano/maatkit-ruby
+  # Author::    Joel Bryan Juliano
+  # Copyright:: (cc) 2011 Joel Bryan Juliano
+  # License::   MIT
+
+  #
+  # Replay MySQL query logs.
+  #
+  # Maatkit::LogPlayer.new( array, str, array)
+  #
+  class Maatkit::LogPlayer
+
+    #
+    # group: Play
+    # Prompt for a password when connecting to MySQL.
+    attr_accessor :ask_pass # FALSE
+
+    #
+    # type: string; default: ./
+    # Base directory for "--split" session files and "--play" result file.
+    attr_accessor :base_dir # ./
+
+    #
+    # type: string; default: session
+    # Base file name for "--split" session files and "--play" result file.
+    # Each "--split" session file will be saved as <base-file-name>-N.txt, where N is a four digit, zero-
+    # padded session ID.  For example: session-0003.txt.
+    # Each "--play" result file will be saved as <base-file-name>-results-PID.txt, where PID is the process
+    # ID of the executing thread.
+    # All files are saved in "--base-dir".
+    attr_accessor :base_file_name # session
+
+    #
+    # group: Play
+    # short form: -A; type: string
+    # Default character set.  If the value is utf8, sets Perl's binmode on STDOUT to utf8, passes the
+    # mysql_enable_utf8 option to DBD::mysql, and runs SET NAMES UTF8 after connecting to MySQL.  Any other
+    # value sets binmode on STDOUT without the utf8 layer, and runs SET NAMES after connecting to MySQL.
+    attr_accessor :charset # FALSE
+
+    #
+    # type: Array
+    # Read this comma-separated list of config files; if specified, this must be the first option on the
+    # command line.
+    attr_accessor :config # /etc/maatkit/maatkit.conf,/etc/maatkit/mk_log_player.conf,/home/joel/.maatkit.conf,/home/joel/.mk_log_player.conf
+
+    #
+    # short form: -F; type: string
+    # Only read mysql options from the given file.
+    attr_accessor :defaults_file # (No # value)
+
+    #
+    # Print which processes play which session files then exit.
+    attr_accessor :dry_run # FALSE
+
+    #
+    # type: string; group: Split
+    # Discard "--split" events for which this Perl code doesn't return true.
+    # This option only works with "--split".
+    # This option is a string of Perl code or a file containing Perl code that gets compiled into a
+    # subroutine with one argument: $event.  This is a hashref.  If the given value is a readable file, then
+    # mk-log-player reads the entire file and uses its contents as the code.  The file should not contain a
+    # shebang (#!/usr/bin/perl) line.
+    # If the code returns true, the query is split; otherwise it is discarded.  The code is the last
+    # statement in the subroutine other than "return $event".  The subroutine template is:
+    #   sub { $event = shift; filter && return $event; }
+    # Filters given on the command line are wrapped inside parentheses like like "( filter )".  For complex,
+    # multi-line filters, you must put the code inside a file so it will not be wrapped inside parentheses.
+    # Either way, the filter must produce syntactically valid code given the template.  For example, an if-
+    # else branch given on the command line would not be valid:
+    #   --filter 'if () { } else { }'  # WRONG
+    # Since it's given on the command line, the if-else branch would be wrapped inside parentheses which is
+    # not syntactically valid.  So to accomplish something more complex like this would require putting the
+    # code in a file, for example filter.txt:
+    #   my $event_ok; if (...) { $event_ok=1; } else { $event_ok=0; } $event_ok
+    # Then specify "--filter filter.txt" to read the code from filter.txt.
+    # If the filter code won't compile, mk-log-player will die with an error.  If the filter code does
+    # compile, an error may still occur at runtime if the code tries to do something wrong (like pattern
+    # match an undefined value).  mk-log-player does not provide any safeguards so code carefully!
+    # An example filter that discards everything but SELECT statements:
+    #   --filter '$event->{arg} =~ m/^select/i'
+    # This is compiled into a subroutine like the following:
+    #   sub { $event = shift; ( $event->{arg} =~ m/^select/i ) && return $event; }
+    # You can find an explanation of the structure of $event at
+    # <http://code.google.com/p/maatkit/wiki/EventAttributes>.
+    attr_accessor :filter # (No # value)
+
+    #
+    # Show help and exit.
+    attr_accessor :help # TRUE
+
+    #
+    # short form: -h; type: string; group: Play
+    # Connect to host.
+    attr_accessor :host # (No # value)
+
+    #
+    # type: int; default: 1; group: Play
+    # How many times each thread should play all its session files.
+    attr_accessor :iterations # 1
+
+    #
+    # type: int; default: 5000000; group: Split
+    # Maximum number of sessions to "--split".
+    # By default, "mk-log-player" tries to split every session from the log file.  For huge logs, however,
+    # this can result in millions of sessions.  This option causes only the first N number of sessions to be
+    # saved.  All sessions after this number are ignored, but sessions split before this number will continue
+    # to have their queries split even if those queries appear near the end of the log and after this number
+    # has been reached.
+    attr_accessor :max_sessions # 5000000
+
+    #
+    # group: Play
+    # Play only SELECT and USE queries; ignore all others.
+    attr_accessor :only_select # FALSE
+
+    #
+    # short form: -p; type: string; group: Play
+    # Password to use when connecting.
+    attr_accessor :password # (No # value)
+
+    #
+    # type: string
+    # Create the given PID file.  The file contains the process ID of the script.  The PID file is removed
+    # when the script exits.  Before starting, the script checks if the PID file already exists.  If it does
+    # not, then the script creates and writes its own PID to it.  If it does, then the script checks the
+    # following: if the file contains a PID and a process is running with that PID, then the script dies; or,
+    # if there is no process running with that PID, then the script overwrites the file with its own PID and
+    # starts; else, if the file contains no PID, then the script dies.
+    attr_accessor :pid # (No # value)
+
+    #
+    # type: string; group: Play
+    # Play (execute) session files created by "--split".
+    # The argument to play must be a commaxn-separated list of session files created by "--split" or a
+    # directory.  If the argument is a directory, ALL files in that directory will be played.
+    attr_accessor :play # (No # value)
+
+    #
+    # short form: -P; type: int; group: Play
+    # Port number to use for connection.
+    attr_accessor :port # (No # value)
+
+    #
+    # group: Play
+    # Print queries instead of playing them; requires "--play".
+    # You must also specify "--play" with "--print".  Although the queries will not be executed, "--play" is
+    # required to specify which session files to read.
+    attr_accessor :print # FALSE
+
+    #
+    # Do not print anything; disables "--verbose".
+    attr_accessor :quiet # FALSE
+
+    #
+    # default: yes
+    # Print "--play" results to files in "--base-dir".
+    attr_accessor :results # TRUE
+
+    #
+    # type: int; default: 8; group: Split
+    # Number of session files to create with "--split".
+    # The number of session files should either be equal to the number of "--threads" you intend to "--play"
+    # or be an even multiple of "--threads".  This number is important for maximum performance because it:
+    #   * allows each thread to have roughly the same amount of sessions to play
+    #   * avoids having to open/close many session files
+    #   * avoids disk IO overhead by doing large sequential reads
+    # You may want to increase this number beyond "--threads" if each session file becomes too large.  For
+    # example, splitting a 20G log into 8 sessions files may yield roughly eight 2G session files.
+    # See also "--max-sessions".
+    attr_accessor :session_files # 8
+
+    #
+    # type: string; group: Play; default: wait_timeout=10000
+    # Set these MySQL variables.  Immediately after connecting to MySQL, this string will be appended to SET
+    # and executed.
+    attr_accessor :set_vars # wait_timeout=10000
+
+    #
+    # short form: -S; type: string; group: Play
+    # Socket file to use for connection.
+    attr_accessor :socket # (No # value)
+
+    #
+    # type: string; group: Split
+    # Split log by given attribute to create session files.
+    # Valid attributes are any which appear in the log: Thread_id, Schema, etc.
+    attr_accessor :split # (No # value)
+
+    #
+    # group: Split
+    # Split log without an attribute, write queries round-robin to session files.
+    # This option, if specified, overrides "--split" and causes the log to be split query-by-query, writing
+    # each query to the next session file in round-robin style.  If you don't care about "sessions" and just
+    # want to split a lot into N many session files and the relation or order of the queries does not matter,
+    # then use this option.
+    attr_accessor :split_random # FALSE
+
+    #
+    # type: int; default: 2; group: Play
+    # Number of threads used to play sessions concurrently.
+    # Specifies the number of parallel processes to run.  The default is 2.  On GNU/Linux machines, the
+    # default is the number of times 'processor' appears in /proc/cpuinfo.  On Windows, the default is read
+    # from the environment.  In any case, the default is at least 2, even when there's only a single
+    # processor.
+    # See also "--session-files".
+    attr_accessor :threads # 2
+
+    #
+    # type: string; group: Split
+    # The type of log to "--split" (default slowlog).  The permitted types are
+    # binlog
+    #  #  Split a binary log file.
+    # genlog
+    #  #  Split a general log file.
+    # slowlog
+    #  #  Split a log file in any varation of MySQL slow-log format.
+    attr_accessor :type # slowlog
+
+    #
+    # short form: -u; type: string; group: Play
+    # User for login if not current user.
+    attr_accessor :user # (No # value)
+
+    #
+    # short form: -v; cumulative: yes; default: 0
+    # Increase verbosity; can specifiy multiple times.
+    # This option is disabled by "--quiet".
+    attr_accessor :verbose # 0
+
+    #
+    # Show version and exit.
+    attr_accessor :version # FALSE
+
+    #
+    # type: array; default: 0; group: Play
+    # Not implemented yet.
+    # The wait time is given in seconds with microsecond precision and can be either a single value or a
+    # range.  A single value causes an exact wait; example: 0.010 = wait 10 milliseconds.  A range causes a
+    # random wait between the given value times; example: 0.001,1 = random wait from 1 millisecond to 1
+    # second.
+    attr_accessor :wait_between_sessions # (No # value)
+
+    #
+    # default: no; group: Play
+    # Print warnings about SQL errors such as invalid queries to STDERR.
+    attr_accessor :warnings # TRUE
+
+    #
+    # Sets the executable path, otherwise the environment path will be used.
+    #
+    attr_accessor :path_to_mk_log_player
+
+    #
+    # Returns a new LogPlayer Object
+    #
+    def initialize()
+    end
+
+    #
+    # Execute the command
+    #
+    def start(options = nil)
+      tmp = Tempfile.new('tmp')
+      command = option_string() + options.to_s + " 2> " + tmp.path
+      success = system(command)
+      if success
+        begin
+          while (line = tmp.readline)
+            line.chomp
+            selected_string = line
+          end
+        rescue EOFError
+          tmp.close
+        end
+        return selected_string
+      else
+        tmp.close!
+        return success
+      end
+    end
+
+    def config
+      option_string()
+    end
+
+    private
+
+    def option_string()
+
+      unless @path_to_mk_log_player
+        ostring = "mk-log-player "
+      else
+        ostring = @path_to_mk_log_player + " "
+      end
+
+      self.instance_variables.each do |i|
+        tmp_value = self.instance_variable_get "#{i}"
+        tmp_string = i.gsub("_", "-").gsub("@", "--")
+        unless tmp_string == "--path-to-mk-log-player"
+          if (tmp_value.is_a? TrueClass) || (tmp_value.is_a? FalseClass)
+            ostring += "#{tmp_string} "
+          else
+            ostring += "#{tmp_string} #{tmp_value} "
+          end
+        end
+      end
+
+      return ostring
+
+    end
+
+  end
+