The document discusses Icinga 2, a monitoring tool, focusing on its API features, such as user authentication and permissions management. It highlights the capabilities for configuration management, event streams, and filtering options, alongside example API calls and integrations. The conclusion encourages users to explore Icinga 2 through vagrant boxes and the API documentation.

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