LinuxSystemInfo

Gem Version Dependency Status

Linux System Info is a gem that allows you to get information about you're linux computer. It retrieves information such as CPU, RAM, Hard drive etc. This works only for your local computer and for Linux Debain or Redhat based operating system.

Requirements

The following utility is needed to get a list of devices connected to the PCI bus.

Debain based linux (installed by default)

sudo apt-get install pciutils

RedHat based linux (not installed by default)

sudo yum install pciutils

Installation

Add this line to your application's Gemfile:

gem 'LinuxSystemInfo'

And then execute:

$ bundle

Or install it yourself as:

$ gem install LinuxSystemInfo

Usage

Info

LinuxSystemInfo.info

{
  :os=>"Linux version 3.13.0-45-generic (buildd@phianna) ...",
  :uptime=>"up 5 hours, 57 minutes",
  :users=>"8"
}

CPU

LinuxSystemInfo.cpu

{
  :model=>
  {
    :name => "Intel(R) Core(TM) i7-3537U CPU @ 2.00GHz",
    :number => "58"
  },
  :address_sizes => "36 bits physical, 48 bits virtual",
  :architecture => "x86_64",
  :threads => "2",
  :cores => "2",
  :socket => "1",
  :family => "6",
  :flags => "fpu vme de pse tsc msr pae mce cx8 apic ...",
  :L1=>
  {
    :d => "32K",
    :i => "32K"
  },
  :L2 => "256K",
  :L3 => "4096K"
}

RAM

LinuxSystemInfo.memory

{
  :unit => "Megabyte",
  :total => "7431",
  :used => "4550",
  :free => "2881",
  :shared => "493",
  :buffers => "85",
  :cached => "2036"
}

Storage

LinuxSystemInfo.storage

{
  "/dev/sda1" =>
  {
    :size => "88G",
    :used => "14G",
    :available => "70G",
    :used_percentage => "17%",
    :mount => "/"
  },
  "/dev/sda8" =>
  {
    :size => "114G",
    :used => "51G",
    :available => "63G",
    :used_percentage => "45%",
    :mount => "/home"
  },
  "/dev/sda6" =>
  {
    :size => "12G",
    :used => "2.0G",
    :available => "9.3G",
    :used_percentage => "18%",
    :mount => "/repos"
  },
  "/dev/sda5" =>
  {
    :size => "23G",
    :used => "3.1G",
    :available => "20G",
    :used_percentage => "14%",
    :mount => "/virtualbox"
  }
}

Connection

LinuxSystemInfo.connection

{
  "eth0" =>
  {
    :mac => "80:2f:d5:6b:d5:88",
    :ip => "192.168.1.23",
    :mask => "255.255.255.0",
    :broadcast => "192.168.1.255",
    :ip6 => "fe80::c23f:d5ff:fe6b:d5c8/64"
  }
}

Video

LinuxSystemInfo.video

[
  "Intel Corporation Haswell-ULT Integrated Graphics Controller (rev 09)"
]

Audio

LinuxSystemInfo.audio

[
  "Intel Corporation Haswell-ULT HD Audio Controller (rev 09)",
  "Intel Corporation Lynx Point-LP HD Audio Controller (rev 04)"
]

USB

LinuxSystemInfo.usb

[
  "Intel Corporation Lynx Point-LP USB xHCI HC (rev 04)",
  "Intel Corporation Lynx Point-LP USB EHCI #1 (rev 04)"
]

Network

LinuxSystemInfo.network

[
  "Intel Corporation Ethernet Connection I218-V (rev 04)",
  "Intel Corporation Wireless 7260 (rev 73)"
]

Host

LinuxSystemInfo.hostname

"example.com"

Processes

LinuxSystemInfo.processes

Returns all process that are not by root, nobody, and syslog user.

{
  "929"=>{:user=>"avahi", :pid=>"929", :cpu=>"0.0", :mem=>"0.0", :vsz=>"32348", :rss=>"1644", :tty=>"?", :stat=>"S", :start=>"07:42", :time=>"0:00", :command=>"avahi-daemon:"},
  "932"=>{:user=>"avahi", :pid=>"932", :cpu=>"0.0", :mem=>"0.0", :vsz=>"32224", :rss=>"468", :tty=>"?", :stat=>"S", :start=>"07:42", :time=>"0:00", :command=>"avahi-daemon:"},
  "1096"=>{:user=>"whoopsie", :pid=>"1096", :cpu=>"0.0", :mem=>"0.0", :vsz=>"430420", :rss=>"4964", :tty=>"?", :stat=>"Ssl", :start=>"07:42", :time=>"0:00", :command=>"whoopsie"},
  "1229"=>{:user=>"mysql", :pid=>"1229", :cpu=>"0.0", :mem=>"1.7", :vsz=>"922568", :rss=>"136528", :tty=>"?", :stat=>"Ssl", :start=>"07:42", :time=>"0:21", :command=>"/usr/sbin/mysqld"},
  "1252"=>{:user=>"postgres", :pid=>"1252", :cpu=>"0.0", :mem=>"0.2", :vsz=>"247716", :rss=>"16184", :tty=>"?", :stat=>"S", :start=>"07:42", :time=>"0:00", :command=>"/usr/lib/postgresql/9.3/bin/postgres"},
  "1284"=>{:user=>"postgres", :pid=>"1284", :cpu=>"0.0", :mem=>"0.0", :vsz=>"248580", :rss=>"2996", :tty=>"?", :stat=>"Ss", :start=>"07:42", :time=>"0:00", :command=>"postgres:"},
  "1285"=>{:user=>"postgres", :pid=>"1285", :cpu=>"0.0", :mem=>"0.0", :vsz=>"103392", :rss=>"1772", :tty=>"?", :stat=>"Ss", :start=>"07:42", :time=>"0:00", :command=>"postgres:"},
  [...]
  "1671"=>{:user=>"kernoops", :pid=>"1671", :cpu=>"0.0", :mem=>"0.0", :vsz=>"37144", :rss=>"1008", :tty=>"?", :stat=>"Ss", :start=>"07:42", :time=>"0:00", :command=>"/usr/sbin/kerneloops"}
}

Hash

LinuxSystemInfo.to_hash

{
  :info =>
  {
    :os => "Linux version 3.13.0-45-generic (buildd@phianna) ...",
    :uptime => "up 5 hours, 57 minutes",
    :users => "8"
  },
  :hostname => "example.com",
  :cpu =>
  {
    :model =>
    {
      :name => "Intel(R) Core(TM) i5-4250U CPU @ 1.30GHz",
      :number => "69"
    },
    :address_sizes => "39 bits physical, 48 bits virtual",
    :architecture => "x86_64",
    :threads => "2",
    :cores => "2",
    :socket => "1",
    :family => "6",
    :flags => "fpu vme de pse tsc msr pae mce cx8 apic ...",
    :L1=>
    {
      :d => "32K",
      :i => "32K"
    },
    :L2 => "256K",
    :L3 => "3072K"
  },
  :ram =>
  {
    :unit => "Megabyte",
    :total => "15001",
    :used => "4419",
    :free => "10582",
    :shared => "330",
    :buffers => "231",
    :cached => "1836"
  },
  :storage =>
  {
    "/dev/sda1" =>
    {
      :size => "88G",
      :used => "14G",
      :available => "70G",
      :used_percentage => "17%",
      :mount => "/"
    },
    "/dev/sda8" =>
    {
      :size => "114G",
      :used => "51G",
      :available => "63G",
      :used_percentage => "45%",
      :mount => "/home"
    },
    "/dev/sda6" =>
    {
      :size => "12G",
      :used => "2.0G",
      :available => "9.3G",
      :used_percentage => "18%",
      :mount => "/repos"
    },
    "/dev/sda5" =>
    {
      :size => "23G",
      :used => "3.1G",
      :available => "20G",
      :used_percentage => "14%",
      :mount => "/virtualbox"
    }
  },
  :network =>
  [
    "Intel Corporation Ethernet Connection I218-V (rev 04)",
    "Intel Corporation Wireless 7260 (rev 73)"
  ],
  :connection =>
  {
    "eth0" =>
    {
      :mac => "80:2f:d5:6b:d5:88",
      :ip => "192.168.1.23",
      :mask => "255.255.255.0",
      :broadcast => "192.168.1.255",
      :ip6 => "fe80::c23f:d5ff:fe6b:d5c8/64"
    }
  },
  :video =>
  [
    "Intel Corporation Haswell-ULT Integrated Graphics Controller (rev 09)"
  ],
  :audio =>
  [
    "Intel Corporation Haswell-ULT HD Audio Controller (rev 09)",
    "Intel Corporation Lynx Point-LP HD Audio Controller (rev 04)"
  ],
  :usb =>
  [
    "Intel Corporation Lynx Point-LP USB xHCI HC (rev 04)",
    "Intel Corporation Lynx Point-LP USB EHCI #1 (rev 04)"
  ]
}

Notice: to_s prints the hash as JSON what is for printing purpose only. Example: LinuxSystemInfo.to_s

Contributing

  1. Fork it ( https://github.com/SaimonL/LinuxSystemInfo/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request