Bernd Erk - Icinga Director

1. #ICINGACAMP| 13th of May 2017
Icinga Director

2. New config tool?

3. Motivation for a config tool
• Make config easy for the end user
• Offer interfaces to other tools
• Avoid writing config files
• Import config from everywhere

4. The hard parts
• Support for a config DSL
• Enable anyone to use it
• Keep it simple
• Don’t restrict the user too much

5. Kickstart

6. Requirements
• Icinga 2 with API and credentials
• Icinga Web 2 with PHP
• MySQL/PostgreSQL database

7. Installing the module
• Just put the module in place
• Enable it
• Preconfigure Icinga 2 Zones

8. Director Kickstart
• Creates database schema
• Connects to Icinga 2 API
• Imports Icinga 2 core data
CommandsEndpointsZones

11. Basics

12. Templates
• How to monitor X
• Check Command + settings
• Zone + Agent usage
• Defining fields + variables

13. Host / Service
• Imports a template
• Set variables and details
• Extra info about the object

14. Hosts

18. Custom Data

19. Data Fields
• Command configuration (vars)
• Custom data for hosts and services
• Provide vars for filtering, context, meta
data, responsibilities

21. Data Lists
• Data source for fields
• Restrict data selection
• Query data from elsewhere

25. Services

30. Worth mentioning

31. • Host and Service groups, assign or
direct
• Service Sets, assign a bunch of services
• Notifications by assign
• User and Groups
• Timeperiods

32. Deployment

33. • Keep track of changes
• Render Icinga 2 configuration
• Store configuration history
• Push configuration to the Icinga 2 API
• Verify deployment status

40. Big Data

41. Import
• Retrieve data from external resources
• Convert data into relational view
• Store the data locally

42. Databases
• MySQL
• PostgreSQL
• MSSQL
• Oracle

43. LDAP, AD
Want all servers
from your
Active Directory
being monitored
automatically?

44. Strange or incorrect values?
You can fix them with modifiers:
Resolve the IP address?
The SID is stored in binary format!

45. Modifiers
Use them
Add your own
Send Pull Request

46. Files: CSV, JSON, XML, YAML

47. AWS
Load
Balancers
EC2 Instances
Scaling
Groups

48. Puppet DB
Hosts with facts
Custom services
from exported
resources

49. Sync will actually update data
• Creates objects from an import source
• Defines how to map values
• Import  Sync  Deploy

50. Be careful
what you
sync

51. Integrations
• REST API for object management
• Icingacli as command line tool
• Schedule imports, sync jobs,
deployment tasks

52. Custom Integrations and Hooks
• Import sources
Implement your own data source
• Property modifiers
Resolve / mangle data
• Data types
Your custom meta data

53. Next?

54. From the Roadmap
• Packages for major distributions
• Puppet module support
• Scheduled Downtimes
• Dependencies

55. Check it out
https://github.com/Icinga
 icingaweb2-module-director
 icingaweb2-module-aws
 icingaweb2-module-puppetdb
 icingaweb2-module-fileshipper

56. Play around with my Vagrant demo
https://github.com/Icinga
vagrant-director-demo
Give us feedback about Director!

57. www.icinga.com
github.com/Icinga
exchange.icinga.com
Thank You!
icinga
icinga
icinga