www.icinga.org

#icingacamp – Berlin – 03/01/2016

ICINGA 2 – APIFY THEM ALL

• Michael Friedrich• Core developer, Vagrant boxes• Senior Developer @NETWAYS• ~7 years #icingalove• monitoring-portal.org

• @dnsmichi

ICINGA2 - API

We had “APIs”

• HTTP with RESTful Url Schema • ApiUser config object• X.509 and/or Basic Auth

ApiUser Object

# vim /etc/icinga2/conf.d/api-users.conf

object ApiUser "root" {

password = "icinga”

permissions = [ "*" ]

}

ApiUser Permissions

permissions = [

{

permission = "objects/query/Host"

filter = {{ regex("^Linux", host.vars.os) }}

},

{

permission = "objects/query/Service"

filter = {{ regex("^Linux", service.vars.os) }}

}

]

• create, modify and delete objects• retrieve information and run actions• subscribe to events• manage configuration packages

• Configuration management• New standard config API • Support for Packages and Stages• Support for Zones• Used by the Icinga Director

• Event Streams• Based on Types and Filters

CheckResult, StateChange, Notification, Acknowledgement*, Comment*, Downtime*

• Example/v1/events?queue=camp&types=CheckResult

• Status, Objects, Actions and Events• Simple filter

• services?service=localhost!ping6

• Advanced filter• type=Service&filter=service.name==%22ping6%22• (Hint: assign where expressions)

Demo

API CLIENTS

Icinga Studio

Icinga2 console

# ICINGA2_API_PASSWORD=icinga icinga2 console --connect 'https://root@localhost:5665/' --eval 'get_host(NodeName).last_check_result.command' | python -m json.tool

[ "/usr/lib64/nagios/plugins/check_ping", "-H", "127.0.0.1", "-c", "5000,100%", "-w", "3000,80%"]

Icinga 2 Dashing

Icinga Director

Wait for Tom!

ICINGA 2 API – WHAT’S NEXT?

• Libraries• Foreman, Puppet Hook?• Logstash integration?• Nagstamon, NagVis, …?• Send a PR:

https://github.com/Icinga/icinga2-api-examples

CONCLUSION

• Download Icinga 2• Play with the Vagrant boxes• Check the API docs• Share your ideas & API clients

THANK YOU!www.icinga.orgdev.icinga.orggit.icinga.org

@icinga/icinga+icinga