1. 19.06.2013
Thruk
Monitoring Webinterface for Nagios/Shinken/Icinga
Sven Nierlein

2. 19.06.2013 www.consol.com2
• Under the hood
• Live Demo

3. • ...
has had 3,749 commits made by 20 contributors
representing 224,804 lines of code
• ...
took an estimated 58 years of effort
starting with its first commit in November, 2009
*https://www.ohloh.net/p/Thruk
19.06.2013 www.consol.com3
Statistics

4. • 12 Authors
git shortlog --since=1.year -s | wc -l
• 1463 Commits
git log --since=1.year --format=%H | wc -l
• 27 stable releases
19.06.2013 www.consol.com4
Git Statistics

5. • Cascaded Configs
• HTTP Backends
• Connection Pooling
• Logfile Cache
19.06.2013 www.consol.com5
Under the Hood

6. • most configuration items can be overridden for specific groups & users
# disable all commands, except reschedule for all users
command_disabled = 0-6,8-95,97-999
<Group admins>
# enable commands for admins again
command_disabled =
</Group>
• Thruk uses Nagios contactgroups and users
*http://www.thruk.org/documentation.html#_user_amp_group_specific_overrides
19.06.2013 www.consol.com6
Under the Hood
Cascaded Configs

7. • allows remote configuration and status requests
19.06.2013 www.consol.com7
Under the Hood
HTTP Backends

8. • parallel is always better than seriel
• since Thruk 1.72 backend connections
are parallel by default
• connection pool uses more memory but
is way faster
• tweak size with ‘connection_pool_size’
• there are Thruk installations with > 50 backends
19.06.2013 www.consol.com8
Under the Hood
Connection Pools

9. 19.06.2013 www.consol.com9
Under the Hood
Logfile Cache

10. • increase reporting / logfile performance
• drastically reduce network usage
• lower memory footprint of nagios (caches logfiles otherwise)
19.06.2013 www.consol.com10
Under the Hood
Logfile Cache

11. 19.06.2013 www.consol.com11
Under the Hood
Logfile Cache

12. 19.06.2013 www.consol.com12
Under the Hood
Logfile Cache

13. 19.06.2013 www.consol.com13
Live Demo

14. • flexible dashboard
• Include own pages with
generic url panel
19.06.2013 www.consol.com14
Panorama Dashboard

15. • completly reworked reports
plugin
• schedule email reports
• every page can be a report
19.06.2013 www.consol.com15
Reports 2
• based on wkhtml2pdf
• customizable with html and css

16. • Displays Problems Counter
as Favicon
• Uses filter of current page!
19.06.2013 www.consol.com16
Favicon Problem Counter

17. • Form / Cookie Based Login
• Uses Apache Rewrite Map
• OMD
• Works for PNP4Nagios and other
Addons too
• `omd config`
19.06.2013 www.consol.com17
Form Login

18. • automatically activated with
10 or more backends
• Backends can be grouped
• Toggle groups at once
19.06.2013 www.consol.com18
Site Panel

19. • show custom variables
with ‘show_custom_vars’
• uses order from
thruk_local.conf
19.06.2013 www.consol.com19
Custom Variables

20. • beautify your config files:
OMD[workshop]:~$ cat etc/nagios/conf.d/jmx4perl_nagios.cfg | naglint
##############################################################
# Jmx4Perl Configuration for OMD
# ==============================
# Command definition, using hostnames to refer to server names
# in the jmx4perl configuration (<server>...</server> section)
# The 'real' checks are defined in $SITE/etc/jmx4perl/jmx4perl.cfg
# in jmx4perl specific syntax and are referenced by name from
# Nagios service definitions.
define command {
command_name check_jmx4perl
command_line $USER1$/check_jmx4perl
--config $USER4$/etc/jmx4perl/jmx4perl.cfg
--server $HOSTNAME$
--check $ARG1$ $ARG2$ $ARG3$ $ARG4$
}
• Inline replace is possible
19.06.2013 www.consol.com20
Naglint

21. • new thruk support
• uses json api
• not yet released
• Thanks to Henri Wahl and Davide Cecchetto
19.06.2013 www.consol.com21
Nagstamon for Thruk

22. • automatically activated when
using git for your configs
• automatic commits possible
with save hooks
19.06.2013 www.consol.com22
Git History (upcoming)

23. 19.06.2013 www.consol.com23
Resources

24. • http://www.thruk.org
• http://thruk.org/ideas.html
• http://labs.consol.de/nagios/thruk/
• https://github.com/sni/Thruk
• http://demo.thruk.org
19.06.2013 www.consol.com24
Resources

25. 19.06.2013 www.consol.com25
Questions?