Talk by Michael Friedrich at Icinga Camp Berlin 2016. Talk covers the latest development in the Icinga 2 core, especially the API

1. www.icinga.org
#icingacamp – Berlin – 03/01/2016
ICINGA 2 – APIFY THEM ALL

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

3. ICINGA2 - API

4. We had “APIs”

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

6. ApiUser Object
# vim /etc/icinga2/conf.d/api-users.conf
object ApiUser "root" {
password = "icinga”
permissions = [ "*" ]
}

7. ApiUser Permissions
permissions = [
{
permission = "objects/query/Host"
filter = {{ regex("^Linux", host.vars.os) }}
},
{
permission = "objects/query/Service"
filter = {{ regex("^Linux", service.vars.os) }}
}
]

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

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

10. • Event Streams
• Based on Types and Filters
CheckResult, StateChange, Notification,
Acknowledgement*, Comment*, Downtime*
• Example
/v1/events?queue=camp&types=CheckResult

11. • Status, Objects, Actions and Events
• Simple filter
• services?service=localhost!ping6
• Advanced filter
• type=Service&filter=service.name==%22ping6%22
• (Hint: assign where expressions)

12. Demo

13. API CLIENTS

14. Icinga Studio

15. 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%"
]

16. Icinga 2 Dashing

17. Icinga Director
Wait for Tom! 

18. ICINGA 2 API – WHAT’S NEXT?

19. • Libraries
• Foreman, Puppet Hook?
• Logstash integration?
• Nagstamon, NagVis, …?
• Send a PR:
https://github.com/Icinga/icinga2-api-
examples

20. CONCLUSION

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

22. THANK YOU!
www.icinga.org
dev.icinga.org
git.icinga.org
@icinga
/icinga
+icinga