hosts.md

Icinga2 - Hosts

add a host

add_host( params )

Example

param = {
  name: 'foo',
  address: 'foo.bar.com',
  display_name: 'test node',
  max_check_attempts: 5,
  notes: 'test node',
  vars: {
    description: 'host foo',
    os: 'Linux',
    partitions: {
      '/' => {
        crit: '95%',
        warn: '90%'
      }
    }
  }
}
@icinga.add_host(param)

delete a host

delete_host( params )

Example

@icinga.delete_host(name: 'foo')

modify a host

modify_host( params )

Example

param = {
  name: 'foo',
  address: 'foo.bar.com',
  display_name: 'Host for an example Problem',
  max_check_attempts: 10,
}

or

param = {
  name: 'foo',
  address: 'foo.bar.com',
  notes: 'an demonstration object',
  vars: {
    description: 'schould be delete ASAP',
    os: 'Linux',
    partitions: {
      '/' => {
        crit: '98%',
        warn: '95%'
      }
    }
  },
  merge_vars: true
}

or

param = {
  name: 'foo',
  address: 'foo.bar.com',
  vars: {
    description: 'removed all other custom vars',
  }
}

@icinga.modify_host( name: 'foo')

list hosts

list a named host

hosts( params )

Example

@icinga.host(name: 'icinga2')

list all hosts

hosts

Example

@icinga.hosts

check if the host exists

exists_host?( host_name )

Example

@icinga.exists_host?('icinga2')

get host objects

host_objects( params )

Example

@icinga.host_objects(attrs: ['name', 'state'])

count of hosts with problems

count_hosts_with_problems

Example

@icinga.count_hosts_with_problems

a hash of hosts with problems

list_hosts_with_problems( max_items )

Example

@icinga.list_hosts_with_problems
@icinga.list_hosts_with_problems( 10 )

count of all hosts

hosts_all

Example

@icinga.hosts_all

count all hosts with problems (down, warning, unknown state)

host_problems

Example

all, down, critical, unknown, handled, adjusted = @icinga.host_problems.values

or

p = @icinga.host_problems
down = h.dig(:down)

(protected) calculate a host severity

host_severity( params )

original code are from Icinga Web2

Example

host_severity( {'attrs' => { 'state' => 0.0, 'acknowledgement' => 0.0, 'downtime_depth' => 0.0 } } )