Icinga2 is an open source monitoring solution that provides resilient monitoring as code capabilities. It uses a distributed, high availability architecture. The Icinga2 API allows dynamic management of hosts, host groups, and services. Use cases for the API include monitoring AWS autoscaling nodes by automatically adding and removing hosts, and generating dynamic inventories from the monitored infrastructure.

1. Icinga2 API Use Cases
Roy Peter

2. What is Icinga2 ?
Icinga is a resilient, open source monitoring and metric solution
Monitoring as Code
Distributed, high availability monitoring

3. Icinga2 Terminologies
Hosts
Hostgroups
Services

4. Hosts
Host objects provide a mechanism to group services that are running on the same
physical device
object Host "mysql-01" {
address = "10.0.0.1"
check_command = "hostalive"
}

5. Hostgroups
A group is a collection of similar objects. Groups are primarily used as a visualization
aid in web interfaces.
object HostGroup "mysql" {
display_name = "Mysql Servers"
}

6. Services
Services can be virtually anything which can be checked in some way.
apply Service "check_mysql" {
display_name = "Check mysql"
check_command = "check_mysql"
assign where host.groups == "mysql"
}

7. object Host "mysql-01" {
address = "10.0.0.1"
groups = ["mysql"]
check_command = "hostalive"
}
object HostGroup "mysql" {
display_name = "Mysql Servers"
}
apply Service "check_mysql" {
display_name = "Check mysql"
check_command = "check_mysql"
assign where host.groups == "mysql"
}

8. Icinga2 UI
icinga2.demo.com

9. Icinga story at Bluejeans

10. Interesting API use cases
Monitor AWS autoscaling nodes
Dynamic inventory

11. Monitor AWS autoscaling nodes

12. Demo

13. from icinga2_api import api
def lambda_handler(event, context):
message = json.loads(event['Records'][0]['Sns']['Message'])
obj = api.Api()
if message['Event'] == 'autoscaling:EC2_INSTANCE_LAUNCH':
uri = '/v1/objects/hosts/{}'.format(message['EC2InstanceId'])
data = {
"templates": [ "generic-host" ],
"attrs": {
"address": get_ec2_ip(
message['EC2InstanceId'],
message['Details']['Availability Zone'][:-1]
),
"vars.os" : "Linux"
}
}
output = obj.create(uri, data)
print (json.dumps(output['response']['data'], indent=2))
elif message['Event'] == 'autoscaling:EC2_INSTANCE_TERMINATE':
uri = '/v1/objects/hosts/{}'.format(message['EC2InstanceId'])
data = {'cascade': 1}
output = obj.delete(uri, data)
print (json.dumps(output['response']['data'], indent=2))

14. Dynamic inventory
Do you have a inventory for your dynamic infrastructure ?
What is your source of truth ?

17. from icinga2_api import api
def do_list(args):
""" --list callback """
configfile = args['configfile']
profile = args['profile']
obj = api.Api(configfile=configfile,
profile=profile)
uri = '/v1/objects/hosts'
output = obj.read(uri)
if output['response']['status_code'] !=
200:
sys.stderr.write('ERROR: icinga2 API
query failedn')
sys.stderr.write(json.dumps(output,
indent=2))
sys.exit(1)
inventory_ds = {}
for host_data in
output['response']['data']['results']:
host_name =
host_data['attrs']['display_name']
host_addr = host_data['attrs']['address']
log_prefix = 'STATUS: %s: %s' %
(host_name, host_addr)
host_groups =
host_data['attrs']['groups']
for host_group in host_groups:
if host_group not in inventory_ds:
inventory_ds[host_group] = {'hosts':
[]}
inventory_ds[host_group]['hosts'].append(host
_addr)
return inventory_ds

18. API Filters

19. Links
Demo
API Doc
API Examples
Python library
Vagrant
Manual to Automated to Distributed monitoring

20. Thank you