Markus Waldmüller - Icinga Integrations

1. Icinga Camp | Bangalore | 2017/05/13
Integrations with Icinga
2017/05/13

2. • Markus Waldmüller
• Bavaria, South of Germany
• Working at NETWAYS
• Senior Consultant
• Trainer
NETWAY
S

3. • Agenda
• Overview
• Automated Deployments and Configuration
• Director Automation
• Dashboards, Metrics and Events
• Modules for Icinga Web 2
• Notifications
• Preview
• Conclusion
Agenda

4. Overview

5. Icinga is a scalable and extensible monitoring system
which checks the availability of your resources, notifies
users of outages and provides extensive metrics.
availability notifies
metrics

6. OpenTSDB
REST API
GELF
Perfdata Graphite
Elastic
Logstash
DB IDO
InfluxDB
• Modular Interfaces
• Not just “checks” &
“notifications”
• Integrations?

7. What‘s next?

8. • Understand the principles of Icinga 2
• Configuration DSL
• Distributed environments
• REST API
• Build your own stack with integrationsstack
principles

9. Automated Deployments
and Configuration

10. • Icinga 2 Puppet Module
https://forge.puppet.com/icinga/icinga2
• Icinga Web 2 Puppet Module
https://forge.puppet.com/icinga/icingaweb2
Puppet
Puppet

11. • Approved Icinga 2 Puppet ModuleApproved

12. class { '::icinga2':
manage_repo => true,
features => ['checker', 'mainlog'],
}

13. include ::icinga2
include ::mysql::server
mysql::db { 'icinga':
user => 'icinga''
password => 'sw0rdfish',
host => 'localhost',
grant => ['ALL'],
}
class {'icinga2::feature::idomysql':
user => 'icinga',
password => 'sw0rdfish',
database => 'icinga',
import_schema => true,
require => Mysql::Db['icinga'],
}

14. • Chef Partner Cookbook Program
• Chef Icinga2 Cookbook
https://supermarket.chef.io/cookbooks/icinga2
• Setup Icinga 2 & Icinga Web 2
• Manage configuration objects
Chef

15. • Ansible Roles for Icinga 2
https://github.com/Icinga/icinga2-ansible
• Setup Icinga 2 & Icinga Web 2
• Manage configuration objects
Ansible

16. • Salt Formula
https://github.com/saltstack-formulas/icinga2-formula
• Setup Icinga 2, ClassicUI and NRPE
Salt

17. • Foreman Smart Proxy Plugin
https://github.com/theforeman/smart_proxy_monitoring
• Information from:
• Icinga 2 API
• Icinga Web 2 Module Director
• Status
• Host management
Foreman

18. • Foreman Smart Proxy PluginForeman

19. • Terraform Icinga 2 Provider
https://www.terraform.io/docs/providers/icinga2/
• Configure Hosts
Terraform

20. Director Automation

21. • Icinga DirectorDirector

22. • Icinga Director
• Import and modify
• Lots of Import Sources and Modifiers
• Sync rules
• Create, update and delete objects
• Deployment
• Schedule Jobs
• Versioning (Diff and rollback)
• API
Director

23. • Director Import Sources
• SQL - MySQL, pgSQL and MSSQL
• Icinga 2 API
• Files - CSV, JSON, YAML and XML
https://github.com/Icinga/icingaweb2-module-fileshipper
• PuppetDB
https://github.com/Icinga/icingaweb2-module-puppetdb
• AWS
https://github.com/Icinga/icingaweb2-module-aws
Import Sources

24. • Director Lifecycle
ImportSources Deploy
185.11.254.90www.icinga.org
Modifier
(DNS Lookup)
Lifecycle
Sync Rules
object Host “icingahost01” {
address = 185.11.254.90
….
}

25. Dashboards

26. • Icinga Web 2 Custom DashboardsIcinga Web 2

27. • Dashing for Icinga 2
https://github.com/Icinga/dashing-icinga2
Dashing

28. • More REST API resources
https://github.com/Icinga/icinga2-api-examples

29. Metrics

30. • Plugins provide Performance Data
• Metrics for “free”
• Store them in Graphite, InfluxDB, …
• Visualize them in Grafana
Metrics
Grafana

31. • Icinga Dashboards for Grafana
https://grafana.com/icinga
Dashboards

32. Events

33. • Forward Icinga 2 events
• GELF Writer
• Elastic Beats
• Filebeat
• Icingabeat
events

34. • GELF Writer
• Check results, notifications and state
changes
• Performance data
• Event correlation
Performance data

35. • GELF Writer - GraylogGELF Writer

36. • Elastic Beats
• Small event shippers
• Support for Logstash & Elasticsearch
• Forward “lightweight” events & status
Elastic Beats

37. • Filebeat
• Monitors log directories and log files
• Icinga Module (next release?)
https://www.elastic.co/guide/en/beats/filebeat/master/filebeat- module-
icinga.html
• Main log
• Debug log
• Startup log
Filebeat

38. • filebeatFilebeat

39. • Icingabeat
https://github.com/Icinga/icingabeat
• Fetches data from Icinga 2 API
• Support for Logstash & Elasticsearch
• Provides Kibana Dashboards
Icingabeat

40. • Icingabeat – Checkresults DashboardIcingabeat

41. • Icingabeat – Status DashboardIcingabeat

42. • Icingabeat – Notification DashboardIcingabeat

43. Modules for
Icinga Web 2

44. • Icinga Web 2 Modules
• Add ons
• Graphs
• Ticket Systems
• Maps and Processes
Modules

45. • Business Process
https://github.com/Icinga/icingaweb2-module-businessprocess
Business Process

46. • NagVis - Visualization
https://github.com/Icinga/icingaweb2-module-nagvis
NagVis

47. • PNP - RRD based
https://github.com/Icinga/icingaweb2-module-pnp
PNP

48. • Generic TTS - Ticket System Integration
https://github.com/Icinga/icingaweb2-module-generictts
Generic TTS

49. • Cube – Drill Down View
https://github.com/Icinga/icingaweb2-module-cube
Cube

50. Community Modules for
Icinga Web 2

51. • Graphite
https://github.com/findmypast/icingaweb2-module-graphite
Graphite

52. • Grafana
https://github.com/Mikesch-mp/icingaweb2-module-grafana
Grafana

53. • Globe 3D
https://github.com/Mikesch-mp/icingaweb2-module-globe
Globe 3D

54. Alerts and Escalations

55. Notifications – just Email?

56. • Enhanced Notifications
https://github.com/mmarodin/icinga2-plugins/tree/master/notification
• Grafana Graphs & HTML
Enhanced

57. Recommendation: “Use at least two
different notification ways”
• Extend Notifications
• SMS
• Prowl
• Scripts (SNMP-Traps, …)
Extend

58. Advanced Notifications

59. • Event correlation
• Schedules
• Escalation policies
• Alert consolidation
• Multiple notification channels

60. • Advanced Notification Tools & Services
• PagerDuty
https://www.pagerduty.com/docs/guides/icinga2-integration-guide/
• VictorOps
https://victorops.com/icinga-monitoring/
• BigPanda
https://bigpanda.io/bp_integrations/icinga/
• OpsGenie
https://www.opsgenie.com/docs/integrations/icinga2-integration
Advanced

61. • Advanced Notification Tools & Services
• AlertOps
https://github.com/Icinga/icinga2-notification-alertops
• NoMa (Notification Manager
https://git.netways.org/noma/noma
• Cloud services and many more…
Advanced

62. Preview

63. • Writer for Elastic Stack components
• Logstash Output Plugin
• Filebeat Module for Icinga
• Kubernetes Operator

64. Conclusion

65. • Test and play with integrations
• Open feature requests
• Raise awareness on issues

66. • Play with the Vagrant boxes
https://github.com/Icinga/icinga-vagrant
• Integrate “everything”
• Join the community channels
• Share your story
Vagrant

67. www.icinga.com
github.com/icinga
exchange.icinga.com
Thank You!
@icinga
/icinga
+icinga