Class: Rubix::Connection

Inherits:
Object
  • Object
show all
Includes:
Logs
Defined in:
lib/rubix/connection.rb

Overview

Wraps and abstracts the process of connecting to a Zabbix API.

Constant Summary collapse 

'zbx_sessionid'
CONTENT_TYPE =

The content type header to send when emulating a browser.

'multipart/form-data'

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Logs

#debug, #error, #fatal, #info, #warn

Constructor Details

#initialize(uri_or_string, username = nil, password = nil) ⇒ Connection

Set up a connection to a Zabbix API.

The uri_or_string can be either a string or a URI object.

The username and password provided must correspond to an existing Zabbix account with API access enabled.

Parameters:

  • uri_or_string (URI, String) —

    the address of the Zabbix API server to connect to

  • username (String) (defaults to: nil) —

    the username of an existing Zabbix API User account with API access

  • password (String) (defaults to: nil) —

    the password for this account



56
57
58
59
60
61
 
# File 'lib/rubix/connection.rb', line 56

def initialize uri_or_string, username=nil, password=nil
  self.uri    = uri_or_string
  @username   = username || uri.user
  @password   = password || uri.password
  @request_id = 0
end

Instance Attribute Details

#auth ⇒ String (readonly)

API for this session.

Returns:

  • (String) —

    the authentication token provided by the Zabbix



31
32
33
 
# File 'lib/rubix/connection.rb', line 31

def auth
  @auth
end

#last_response ⇒ Rubix::Response (readonly)

Returns the last response from the Zabbix API – useful for logging purposes.

Returns:

  • (Rubix::Response) —

    the last response from the Zabbix API – useful for logging purposes



43
44
45
 
# File 'lib/rubix/connection.rb', line 43

def last_response
  @last_response
end

#password ⇒ String (readonly)

Returns the password of the Zabbix account used to authenticate.

Returns:

  • (String) —

    the password of the Zabbix account used to authenticate



40
41
42
 
# File 'lib/rubix/connection.rb', line 40

def password
  @password
end

#request_id ⇒ Fixnum (readonly)

Returns the ID of the next request that will be sent.

Returns:

  • (Fixnum) —

    the ID of the next request that will be sent.



34
35
36
 
# File 'lib/rubix/connection.rb', line 34

def request_id
  @request_id
end

#server ⇒ Net::HTTP (readonly)

Returns the HTTP server backing the Zabbix API.

Returns:

  • (Net::HTTP) —

    the HTTP server backing the Zabbix API.



27
28
29
 
# File 'lib/rubix/connection.rb', line 27

def server
  @server
end

#uri ⇒ URI

Returns The URI for the Zabbix API.

Returns:

  • (URI) —

    The URI for the Zabbix API.



24
25
26
 
# File 'lib/rubix/connection.rb', line 24

def uri
  @uri
end

#username ⇒ String (readonly)

Returns the username of the Zabbix account used to authenticate.

Returns:

  • (String) —

    the username of the Zabbix account used to authenticate



37
38
39
 
# File 'lib/rubix/connection.rb', line 37

def username
  @username
end

Instance Method Details

#authorize! ⇒ Object

Force the connection to execute an authorization request and renew (or set) the authorization token.

Raises:



112
113
114
115
116
117
 
# File 'lib/rubix/connection.rb', line 112

def authorize!
  response = Response.new(till_response { send_api_request(authorization_params) })
  raise AuthenticationError.new("Could not authenticate with Zabbix API at #{uri}: #{response.error_message}") if response.error?
  raise AuthenticationError.new("Malformed response from Zabbix API: #{response.body}") unless response.string?
  @auth = response.result
end

#authorized? ⇒ Boolean

Has this connection already been authorized and provided with a authorization token from the Zabbix API?

Returns:

  • (Boolean) 


106
107
108
 
# File 'lib/rubix/connection.rb', line 106

def authorized?
  !auth.nil?
end

#request(method, params) ⇒ Rubix::Response

Send a request to the Zabbix API. Will return a Rubix::Response object.

Documentation on what methods and parameters are available can be found in the Zabbix API documentation

Rubix.connection.request 'host.get', 'filter' => { 'host' => 'foobar' }

Parameters:

  • method (String) —

    the name of the Zabbix API method

  • params (Hash, Array) —

    parameters for the method call

Returns:



75
76
77
78
79
80
81
82
83
84
85
 
# File 'lib/rubix/connection.rb', line 75

def request method, params
  authorize! unless authorized?
  response = till_response do
    send_api_request :jsonrpc => "2.0",
    :id      => request_id,
    :method  => method,
    :params  => params,
    :auth    => auth
  end
  Response.new(response)
end

#web_request(verb, path, data = {}) ⇒ Net::HTTP::Response

Send a request to the Zabbix web application. The request is designed to emulate a web browser.

Any values in data which are file handles will trigger a multipart POST request, uploading those files.

Parameters:

  • verb (String) —

    one of “GET” or “POST”

  • path (String) —

    the path to send the request to

  • data (Hash) (defaults to: {}) —

    the data to include in the request

Returns:

  • (Net::HTTP::Response) 


97
98
99
100
101
102
 
# File 'lib/rubix/connection.rb', line 97

def web_request verb, path, data={}
  authorize! unless authorized?
  till_response do
    send_web_request(verb, path, data)
  end
end