Zabbix APIをRubyから利用する場合どのライブラリが良いのか調べてみる

Readme.md

Zabbix APIをRubyから利用する場合どのライブラリが良いのか調べてみる

• Docs/api/libraries - Zabbix.orgによると以下のライブラリが存在する
• Zabbix API
• Rubix
• zabbixapi
• zabby
• どのライブラリを使ったら良いのか選定してみる(調査日：2013/02/01あたり)

選定結果

• zabbixapiを使ってみる
• ruby1.9でしかサンプルが動かなかったのが気になるがサンプルが充実していて対応するzabbixのバージョンも明記されている

Hostの情報取得を書いてみた所感

• Zabbix API
• 日本語の使用レポートがちらほらあるが公式のtracではあまりドキュメントがない
• Rubix
• apiごとに特化したIFではなく汎用的なIFを用意している感じ
• zabbixapi
• apiごとに使いやすいAPIが用意されている感じ(ただし、ruby1.9でしかサンプルが動かなかった)
• githubページでサンプルが充実していて対応するzabbixのバージョンも明記されている
• zabby
• 書き方が独特な感じ

各ライブラリの最終更新日

• Zabbix API
• 4ヶ月前
• Rubix
• 6ヶ月前
• zabbixapi
• 2日前
• zabby
• 10ヶ月前

各ライブラリのgemダウンロード数(2013/2/4現在)

• Zabbix API
• 16,628
• Rubix
• 16,151
• zabbixapi
• 13,844
• zabby
• 2,946

Gemfile

# A sample Gemfile
source "https://rubygems.org"

gem 'rubix'
gem 'zabbixapi'
gem 'zabby'
gem 'zbxapi'

rubix-host-get-test.rb

require 'rubix'

ZABBIX_SERVER = "example.com"
ZABBIX_API_URL = "http://#{ZABBIX_SERVER}/zabbix/api_jsonrpc.php"
ZABBIX_LOGINID = "admin"
ZABBIX_PASSWORD = "zabbix"

zbx = Rubix.connect(ZABBIX_API_URL, ZABBIX_LOGINID, ZABBIX_PASSWORD)
res = zbx.request('host.get', "output" => "extend")
p res.result

zabbixapi-host-get-test.rb

require 'zabbixapi'

ZABBIX_SERVER = "example.com"
ZABBIX_API_URL = "http://#{ZABBIX_SERVER}/zabbix/api_jsonrpc.php"
ZABBIX_LOGINID = "admin"
ZABBIX_PASSWORD = "zabbix"

zbx = ZabbixApi.connect(:url => ZABBIX_API_URL, :user => ZABBIX_LOGINID, :password => ZABBIX_PASSWORD)
p zbx.hosts.get("output" => "extend")

zabby-host-get-test.rb

require 'zabby'

ZABBIX_SERVER = "example.com"
ZABBIX_API_URL = "http://#{ZABBIX_SERVER}/zabbix/api_jsonrpc.php"
ZABBIX_LOGINID = "admin"
ZABBIX_PASSWORD = "zabbix"

z = Zabby.init do
  set :server => ZABBIX_API_URL
  set :user => ZABBIX_LOGINID
  set :password => ZABBIX_PASSWORD
  login
end

p z.run { Zabby::Host.get("output" => "extend") }

zbxapi-host-get-test.rb

require 'zbxapi'

ZABBIX_SERVER = "example.com"
ZABBIX_API_URL = "http://#{ZABBIX_SERVER}/zabbix/api_jsonrpc.php"
ZABBIX_LOGINID = "admin"
ZABBIX_PASSWORD = "zabbix"

zbxapi = ZabbixAPI.new(ZABBIX_API_URL)
zbxapi.login(ZABBIX_LOGINID, ZABBIX_PASSWORD)
p zbxapi.host.get("output" => "extend")