riemann-docker 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 18789e6607828d9b9942daa049e237d4db277d00
+  data.tar.gz: 88c3041ff216855fcdda256ade673ccbbab14540
+SHA512:
+  metadata.gz: afb2483d328a5c8fe160244acecb4ad0041a933b7b77283a5fda376f3ccfeaf5ec0dc6763004f03e0c95e3b888e741690bedee9a0da31eb52e9df02827296dd1
+  data.tar.gz: 1e82590ded355a73df4ff5354d63a5d2f5a36926157a730482ecf2d1d89cd53e92f7f58e004316d72e14cd577731e04b4abc1bb3087b3b7d091553215864ad20

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2011 Kyle Kingsbury
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,10 @@
+# Riemann Docker
+
+Gathers Docker container metrics and sends them to Riemann.
+
+# Getting started
+
+```
+gem install riemann-docker
+riemann-docker --help
+```

data/bin/riemann-docker

@@ -0,0 +1,205 @@
+#!/usr/bin/env ruby
+
+# Reports current CPU, disk, load average, and memory use to riemann.
+
+require 'riemann/tools'
+
+class Riemann::Tools::DockerHealth
+  require 'docker'
+  require 'socket'
+  include Riemann::Tools
+  include Docker
+
+  opt :docker_host, "Docker Container Host (see https://github.com/swipely/docker-api#host)", :default => nil
+  opt :cpu_warning, "CPU warning threshold (fraction of total jiffies)", :default => 0.9
+  opt :cpu_critical, "CPU critical threshold (fraction of total jiffies)", :default => 0.95
+  opt :disk_warning, "Disk warning threshold (fraction of space used)", :default => 0.9
+  opt :disk_critical, "Disk critical threshold (fraction of space used)", :default => 0.95
+  opt :memory_warning, "Memory warning threshold (fraction of RAM)", :default => 0.85
+  opt :memory_critical, "Memory critical threshold (fraction of RAM)", :default => 0.95
+  opt :host_hostname, "Suffix of host", :type => String, :default => nil
+  opt :checks, "A list of checks to run.", :type => :strings, :default => ['cpu', 'memory', 'disk', 'basic']
+
+  def get_containers
+    Docker::Container.all
+  end
+
+  def get_container_name(container)
+    container.json['Name'][1..-1]
+  end
+
+  def initialize
+
+    if (opts[:docker_host] != nil)
+      Docker.url = opts[:docker_host]
+    end
+
+    @hostname = opts[:host_hostname]
+    if (@hostname.nil? || !(@hostname.is_a? String) || @hostname.empty?)
+      @hostname = Socket.gethostname
+    end
+
+    @cpu_coefficient = 1000 * 1000 * 1000
+
+    @limits = {
+      :cpu => {:critical => opts[:cpu_critical], :warning => opts[:cpu_warning]},
+      :disk => {:critical => opts[:disk_critical], :warning => opts[:disk_warning]},
+      :memory => {:critical => opts[:memory_critical], :warning => opts[:memory_warning]}
+    }
+
+    @last_cpu_reads = Hash.new
+    @last_uptime_reads = Hash.new
+
+    opts[:checks].each do |check|
+      case check
+      when 'disk'
+        @disk_enabled = true
+      when 'cpu'
+        @cpu_enabled = true
+      when 'memory'
+        @memory_enabled = true
+      when 'basic'
+        @basic_inspection_enabled = true
+      end
+    end
+  end
+
+  def alert(container, service, state, metric, description)
+
+    opts = {  :service => service.to_s,
+              :state => state.to_s,
+              :metric => metric.to_f,
+              :description => description }
+
+    if (container != nil)
+      opts[:host] = "#{@hostname}-#{container}"
+    else
+      opts[:host] = @hostname
+    end
+
+    report(opts)
+  end
+
+  def report_pct(container, service, fraction, report = '', name = nil)
+    if fraction
+
+      if (name == nil)
+        name = service
+      end
+
+      if fraction > @limits[service][:critical]
+        alert container, name, :critical, fraction, "#{sprintf("%.2f", fraction * 100)}% #{report}"
+      elsif fraction > @limits[service][:warning]
+        alert container, name, :warning, fraction, "#{sprintf("%.2f", fraction * 100)}% #{report}"
+      else
+        alert container, name, :ok, fraction, "#{sprintf("%.2f", fraction * 100)}% #{report}"
+      end
+    end
+  end
+
+
+  def cpu(id, name, stats)
+
+    current = stats['precpu_stats']['cpu_usage']['total_usage'] / stats['precpu_stats']['cpu_usage']['percpu_usage'].count
+
+    unless current
+      alert name, :cpu, :unknown, nil, 'no total usage found in docker remote api stats'
+      return false
+    end
+
+    current_time = Time.parse(stats['read']);
+    if (@last_cpu_reads[id] != nil)
+      last = @last_cpu_reads[id]
+      used = (current - last[:v]) / (current_time - last[:t]) / @cpu_coefficient
+
+      report_pct name, :cpu, used
+    end
+
+    @last_cpu_reads[id] = { v: current, t: current_time }
+  end
+
+  def memory(id, name, stats)
+    memory_stats = stats['memory_stats']
+    usage = memory_stats['usage'].to_f
+    total = memory_stats['limit'].to_f
+    fraction = (usage / total)
+
+    report_pct name, :memory, fraction, "#{usage} / #{total}"
+  end
+
+  def disk
+    `df -P`.split(/\n/).each do |r|
+      f = r.split(/\s+/)
+      next if f[0] == 'Filesystem'
+      next unless f[0] =~ /\// # Needs at least one slash in the mount path
+
+      # Calculate capacity
+      x = f[4].to_f/100
+      report_pct(nil, :disk, x, "#{f[3].to_i / 1024} mb left", "disk #{f[5]}")
+    end
+  end
+
+  def basic_inspection(id, name, inspection)
+
+    state = inspection['State']
+    json_state = JSON.generate(state)
+
+    running = state['Running']
+
+    alert(name, "status",
+          running ? "ok" : "critical",
+          running ? 1 : 0,
+          json_state)
+
+    if (running)
+      start_time = DateTime.rfc3339(state['StartedAt']).to_time.utc.to_i
+      now = DateTime.now.to_time.utc.to_i
+      uptime = now - start_time
+
+      if (@last_uptime_reads[id] != nil)
+        last = @last_uptime_reads[id]
+        restarted = start_time != last
+        alert(name, "uptime",
+              restarted ? "critical" : "ok",
+              uptime,
+              "last 'StartedAt' measure was #{last} (#{Time.at(last).utc.to_s}), " +
+              "now it's #{start_time} (#{Time.at(start_time).utc.to_s})")
+      end
+
+      @last_uptime_reads[id] = start_time
+    end
+  end
+
+  def tick
+
+    # Disk is the same in every container
+    if @disk_enabled
+      disk()
+    end
+
+    # Get CPU, Memory and Load of each container
+    containers = get_containers()
+    containers.each do |container|
+
+      id = container.id
+      name = get_container_name(container)
+
+      stats = Docker::Util.parse_json(container.connection.get("/containers/#{id}/stats", {stream:false}))
+
+      if @basic_inspection_enabled
+        inspection = Docker::Util.parse_json(container.connection.get("/containers/#{id}/json"))
+        basic_inspection(id, name, inspection)
+      end
+      if @cpu_enabled
+        cpu(id, name, stats)
+      end
+      if @memory_enabled
+        memory(id, name, stats)
+      end
+    end
+
+  end
+end
+
+Riemann::Tools::DockerHealth.run
+

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: riemann-docker
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Shani Elharrar
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-01-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: riemann-tools
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.7
+- !ruby/object:Gem::Dependency
+  name: docker-api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.22.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.22.0
+description: 
+email: ''
+executables:
+- riemann-docker
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/riemann-docker
+homepage: https://github.com/riemann/riemann-docker
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.8.7
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: riemann-docker
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Submits Docker container stats to riemann.
+test_files: []