This is the development version of Kanrisuru. Since this is still a pre-1.0 release, we don't recommend using this in system-critical production environments.

Kanrisuru

kernel_statistics

Get kernel statistics of a remote server in ruby
linux manual

Basic Usage

require 'kanrisuru'
host = Kanrisuru::Remote::Host.new(host: '127.0.1.1', username: 'ubuntu', keys: ['~/.ssh/id_rsa'])

result = host.kernel_statistics
result.success?
true

result.

Result

Returns a KernelStatistic struct.

KernelStatistic Fields

Field Type Description
cpu_total KernelStatisticCpu Encapsulates the stats for all cpus of the server.
cpus array Array of individual KernelStatisticCpu structs. Each instance represents the amount of time the CPU has spent performing different kinds of work.
interrupt_total integer The total of all interrupts serviced.
interrupts array A count of service interrupts since boot time for each system interrupt, as represented as the indexed position in the array.
ctxt integer The total number of context switches across all CPUs.
btime integer Boot time, in seconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC).
processes integer The number of processes and threads created, which includes (but is not limited to) those created by calls to the fork() and clone() system calls.
procs_running integer The number of processes currently running on CPUs.
procs_blocked integer The number of processes currently blocked, waiting for I/O to complete.
softirq_total integer The total of all softirqs.
softirqs arrau The total for the particular softirq.

KernelStatisticCpu Fields

Field Type Description
user integer Normal processes executing in user mode.
nice integer Niced processes executing in user mode.
system integer Processes executing in kernel mode.
idle integer Time spent in the idle task.
iowait integer Time waiting for I/O to complete.
irq integer Time servicing interrupts.
softirq integer Time servicing softirqs.
steal integer The total ticks spent executing other virtual hosts.
guest integer Guest time of the process (time spent running a virtual CPU for a guest operating system), measured in clock ticks.
guest_nice integer Time spent running a niced guest (virtual CPU for guest operating systems under the control of the Linux kernel.

Return Example

host.kstat.data
#<Struct:Kanrisuru::Core::System::KernelStatistic:0x00000640
  btime = 1638819008,
  cpu_total = #<Struct:Kanrisuru::Core::System::KernelStatisticCpu:0x00000668
    guest = 0,
    guest_nice = 0,
    idle = 3000465009,
    iowait = 220655,
    irq = 0,
    nice = 37642,
    softirq = 16981,
    steal = 6536,
    system = 497900,
    user = 974313
  >,
  cpus = [
    [0] #<Struct:Kanrisuru::Core::System::KernelStatisticCpu:0x000006b8
      guest = 0,
      guest_nice = 0,
      idle = 374868746,
      iowait = 35580,
      irq = 0,
      nice = 3642,
      softirq = 8079,
      steal = 879,
      system = 62201,
      user = 135319
    >,
    [1] #<Struct:Kanrisuru::Core::System::KernelStatisticCpu:0x000006e0
      guest = 0,
      guest_nice = 0,
      idle = 375030546,
      iowait = 29886,
      irq = 0,
      nice = 4445,
      softirq = 617,
      steal = 743,
      system = 74533,
      user = 140727
    >,
    [2] #<Struct:Kanrisuru::Core::System::KernelStatisticCpu:0x00000708
      guest = 0,
      guest_nice = 0,
      idle = 375091084,
      iowait = 33608,
      irq = 0,
      nice = 5282,
      softirq = 350,
      steal = 618,
      system = 60031,
      user = 120032
    >,
    [3] .. [4],
    [5] #<Struct:Kanrisuru::Core::System::KernelStatisticCpu:0x00000780
      guest = 0,
      guest_nice = 0,
      idle = 375128926,
      iowait = 33149,
      irq = 0,
      nice = 4997,
      softirq = 372,
      steal = 558,
      system = 54619,
      user = 104484
    >,
    [6] #<Struct:Kanrisuru::Core::System::KernelStatisticCpu:0x000007a8
      guest = 0,
      guest_nice = 0,
      idle = 375107168,
      iowait = 24471,
      irq = 0,
      nice = 4103,
      softirq = 246,
      steal = 663,
      system = 58138,
      user = 103597
    >,
    [7] #<Struct:Kanrisuru::Core::System::KernelStatisticCpu:0x000007d0
      guest = 0,
      guest_nice = 0,
      idle = 375027722,
      iowait = 24198,
      irq = 0,
      nice = 5424,
      softirq = 5943,
      steal = 1384,
      system = 66400,
      user = 140983
    >
  ],
  ctxt = 617697076,
  interrupt_total = 327938951,
  interrupts = [
    [  0] 0,
    [  1] 9,
    [  2] 0,
    [  3] .. [484],
    [485] 0,
    [486] 0,
    [487] 0
  ],
  processes = 175387,
  procs_blocked = 0,
  procs_running = 1,
  softirq_total = 137736702,
  softirqs = [
    [0] 0,
    [1] 53822324,
    [2] 86,
    [3] .. [6],
    [7] 46013049,
    [8] 2777,
    [9] 21003022
  ]
>

Exit Status

Code Description
0 Success
1 Failure

Tested On

  • Ubuntu, Debian, Centos, Fedora, Redhat, OpenSuse, SLES