diff --git a/css/main.css b/css/main.css index 89842f7..7b30dcc 100755 --- a/css/main.css +++ b/css/main.css @@ -148,3 +148,10 @@ A.nav_label { position: absolute; left: -10px; } + +.svg-image { + max-width: 400px; + padding: 3px; + margin: 3px; + background-color: #f5f5f5; +} \ No newline at end of file diff --git a/documentation/usersguide/addons.md b/documentation/usersguide/addons.md index ef9f101..e754722 100644 --- a/documentation/usersguide/addons.md +++ b/documentation/usersguide/addons.md @@ -35,7 +35,7 @@ A detailed description is available on a dedicated ### NRPE -NRPE +NRPE NRPE is an addon that allows you to execute plugins on remote Linux/Unix hosts. This is useful if you need to monitor local resources/attributes like disk usage, CPU load, memory usage, @@ -48,7 +48,7 @@ The NRPE addon and documentation can be found at +NSCA NSCA is an addon that allows you to send passive check results from remote Linux/Unix hosts to the Naemon running on the monitoring server. diff --git a/documentation/usersguide/config.md b/documentation/usersguide/config.md index 88087fe..67856b6 100644 --- a/documentation/usersguide/config.md +++ b/documentation/usersguide/config.md @@ -10,7 +10,7 @@ There are several different configuration files that you're going to need to cre {{ site.note }}Sample configuration files are installed in the /etc/naemon/conf.d/ directory when you follow the quickstart installation guide.{{ site.end }} -Config Overview +Config Overview ### Main Configuration File diff --git a/documentation/usersguide/distributed.md b/documentation/usersguide/distributed.md index 4442824..84ae446 100644 --- a/documentation/usersguide/distributed.md +++ b/documentation/usersguide/distributed.md @@ -17,7 +17,7 @@ The goal in the distributed monitoring environment that I will describe is to of The diagram below should help give you a general idea of how distributed monitoring works with Naemon. I'll be referring to the items shown in the diagram as I explain things... - + ### Central Server vs. Distributed Servers diff --git a/documentation/usersguide/faststartup.md b/documentation/usersguide/faststartup.md index 71b038c..1088c80 100644 --- a/documentation/usersguide/faststartup.md +++ b/documentation/usersguide/faststartup.md @@ -53,7 +53,7 @@ have Naemon pre-process and pre-cache your config files for future use.
- Pre-Caching Object Config Files + Pre-Caching Object Config Files
@@ -76,7 +76,7 @@ have Naemon pre-process and pre-cache your config files for future use.
- Pre-Caching Object Config Files + Pre-Caching Object Config Files
diff --git a/documentation/usersguide/images/configoverview.png b/documentation/usersguide/images/configoverview.png deleted file mode 100644 index c571da1..0000000 Binary files a/documentation/usersguide/images/configoverview.png and /dev/null differ diff --git a/documentation/usersguide/images/distributed.png b/documentation/usersguide/images/distributed.png deleted file mode 100644 index 8768e72..0000000 Binary files a/documentation/usersguide/images/distributed.png and /dev/null differ diff --git a/documentation/usersguide/images/fast-startup1.png b/documentation/usersguide/images/fast-startup1.png deleted file mode 100644 index 4a4308b..0000000 Binary files a/documentation/usersguide/images/fast-startup1.png and /dev/null differ diff --git a/documentation/usersguide/images/fast-startup2.png b/documentation/usersguide/images/fast-startup2.png deleted file mode 100644 index 143b677..0000000 Binary files a/documentation/usersguide/images/fast-startup2.png and /dev/null differ diff --git a/documentation/usersguide/images/integrationoverview.png b/documentation/usersguide/images/integrationoverview.png deleted file mode 100644 index 01d0c3e..0000000 Binary files a/documentation/usersguide/images/integrationoverview.png and /dev/null differ diff --git a/documentation/usersguide/images/monitoring-printers.png b/documentation/usersguide/images/monitoring-printers.png deleted file mode 100644 index be781a5..0000000 Binary files a/documentation/usersguide/images/monitoring-printers.png and /dev/null differ diff --git a/documentation/usersguide/images/monitoring-routers.png b/documentation/usersguide/images/monitoring-routers.png deleted file mode 100644 index d346283..0000000 Binary files a/documentation/usersguide/images/monitoring-routers.png and /dev/null differ diff --git a/documentation/usersguide/images/nrpe.png b/documentation/usersguide/images/nrpe.png deleted file mode 100644 index 4c7c4e4..0000000 Binary files a/documentation/usersguide/images/nrpe.png and /dev/null differ diff --git a/documentation/usersguide/images/nsca.png b/documentation/usersguide/images/nsca.png deleted file mode 100644 index 8bb8b96..0000000 Binary files a/documentation/usersguide/images/nsca.png and /dev/null differ diff --git a/documentation/usersguide/images/passivechecks.png b/documentation/usersguide/images/passivechecks.png deleted file mode 100644 index 1078e46..0000000 Binary files a/documentation/usersguide/images/passivechecks.png and /dev/null differ diff --git a/documentation/usersguide/images/svg/configoverview.svg b/documentation/usersguide/images/svg/configoverview.svg new file mode 100644 index 0000000..d0e4a77 --- /dev/null +++ b/documentation/usersguide/images/svg/configoverview.svg @@ -0,0 +1,4 @@ + + + +
Monitoring Server
Naemon
Daemon
Main config file
naemon.cfg
Resource File(s)
Object Definition File(s)
 \ No newline at end of file diff --git a/documentation/usersguide/images/svg/distributed.svg b/documentation/usersguide/images/svg/distributed.svg new file mode 100644 index 0000000..654eb9c --- /dev/null +++ b/documentation/usersguide/images/svg/distributed.svg @@ -0,0 +1,4 @@ + + + +
Central Monitoring Server
Web Interface
Status File
(status.dat)
External
Command
File
(naemon.cmd)
Naemon Process
NSCA Daemon
5
4
Distributed Monitoring Server #1
Naemon Process
NSCA Client
OCSP / OCHP
Command
1
2
3
Distributed Monitoring Server #2
Naemon Process
NSCA Client
OCSP / OCHP
Command
1
2
3
Hosts and services monitored directly by
"Distributed Server #1", and indirectly by central server
Hosts and services monitored directly by
"Distributed Server #2", and indirectly by central server
 \ No newline at end of file diff --git a/documentation/usersguide/images/svg/drawio/configoverview.drawio b/documentation/usersguide/images/svg/drawio/configoverview.drawio new file mode 100644 index 0000000..c44d4a4 --- /dev/null +++ b/documentation/usersguide/images/svg/drawio/configoverview.drawio @@ -0,0 +1,56 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/documentation/usersguide/images/svg/drawio/distributed.drawio b/documentation/usersguide/images/svg/drawio/distributed.drawio new file mode 100644 index 0000000..03174b0 --- /dev/null +++ b/documentation/usersguide/images/svg/drawio/distributed.drawio @@ -0,0 +1,215 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/documentation/usersguide/images/svg/drawio/fast-startup1.drawio b/documentation/usersguide/images/svg/drawio/fast-startup1.drawio new file mode 100644 index 0000000..ea4fcd4 --- /dev/null +++ b/documentation/usersguide/images/svg/drawio/fast-startup1.drawio @@ -0,0 +1,40 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/documentation/usersguide/images/svg/drawio/fast-startup2.drawio b/documentation/usersguide/images/svg/drawio/fast-startup2.drawio new file mode 100644 index 0000000..ef9cd60 --- /dev/null +++ b/documentation/usersguide/images/svg/drawio/fast-startup2.drawio @@ -0,0 +1,28 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/documentation/usersguide/images/svg/drawio/integrationoverview.drawio b/documentation/usersguide/images/svg/drawio/integrationoverview.drawio new file mode 100644 index 0000000..179fd38 --- /dev/null +++ b/documentation/usersguide/images/svg/drawio/integrationoverview.drawio @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/documentation/usersguide/images/svg/drawio/monitoring-printers.drawio b/documentation/usersguide/images/svg/drawio/monitoring-printers.drawio new file mode 100644 index 0000000..f32e8ad --- /dev/null +++ b/documentation/usersguide/images/svg/drawio/monitoring-printers.drawio @@ -0,0 +1,43 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/documentation/usersguide/images/svg/drawio/monitoring-routers.drawio b/documentation/usersguide/images/svg/drawio/monitoring-routers.drawio new file mode 100644 index 0000000..b983dab --- /dev/null +++ b/documentation/usersguide/images/svg/drawio/monitoring-routers.drawio @@ -0,0 +1,58 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/documentation/usersguide/images/svg/drawio/monitoring-windows.drawio b/documentation/usersguide/images/svg/drawio/monitoring-windows.drawio new file mode 100644 index 0000000..1b94261 --- /dev/null +++ b/documentation/usersguide/images/svg/drawio/monitoring-windows.drawio @@ -0,0 +1,67 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/documentation/usersguide/images/svg/drawio/nrpe.drawio b/documentation/usersguide/images/svg/drawio/nrpe.drawio new file mode 100644 index 0000000..c1247ef --- /dev/null +++ b/documentation/usersguide/images/svg/drawio/nrpe.drawio @@ -0,0 +1,61 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/documentation/usersguide/images/svg/drawio/nsca.drawio b/documentation/usersguide/images/svg/drawio/nsca.drawio new file mode 100644 index 0000000..d78561e --- /dev/null +++ b/documentation/usersguide/images/svg/drawio/nsca.drawio @@ -0,0 +1,49 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/documentation/usersguide/images/svg/drawio/passivechecks.drawio b/documentation/usersguide/images/svg/drawio/passivechecks.drawio new file mode 100644 index 0000000..e047ee4 --- /dev/null +++ b/documentation/usersguide/images/svg/drawio/passivechecks.drawio @@ -0,0 +1,39 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/documentation/usersguide/images/svg/drawio/plugins.drawio b/documentation/usersguide/images/svg/drawio/plugins.drawio new file mode 100644 index 0000000..952a865 --- /dev/null +++ b/documentation/usersguide/images/svg/drawio/plugins.drawio @@ -0,0 +1,58 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/documentation/usersguide/images/svg/fast-startup1.svg b/documentation/usersguide/images/svg/fast-startup1.svg new file mode 100644 index 0000000..998c354 --- /dev/null +++ b/documentation/usersguide/images/svg/fast-startup1.svg @@ -0,0 +1,4 @@ + + + +
Generating Cached Configuration
Naemon
Process





Configuration Logic
Object
Config
Files
Object
Precache
File
 \ No newline at end of file diff --git a/documentation/usersguide/images/svg/fast-startup2.svg b/documentation/usersguide/images/svg/fast-startup2.svg new file mode 100644 index 0000000..a511d09 --- /dev/null +++ b/documentation/usersguide/images/svg/fast-startup2.svg @@ -0,0 +1,4 @@ + + + +
Using Cached Configuration
Naemon
Process





Configuration Logic
Object
Precache
File
 \ No newline at end of file diff --git a/documentation/usersguide/images/svg/integrationoverview.svg b/documentation/usersguide/images/svg/integrationoverview.svg new file mode 100644 index 0000000..b52ccec --- /dev/null +++ b/documentation/usersguide/images/svg/integrationoverview.svg @@ -0,0 +1,4 @@ + + + +
Web Interface
External Programs
Log File
Status File
Retention
Config Files
External Command File
Naemon Daemon
(Core Logic)




Monitoring
Logic
Notification
Logic
Event
Logic
Performance
Logic
Plugins
Notification
Commands
Event
Handlers
COxP
Commands
Performance
Processors
Host and
Services
Contacts
External
Applications
 \ No newline at end of file diff --git a/documentation/usersguide/images/svg/monitoring-printers.svg b/documentation/usersguide/images/svg/monitoring-printers.svg new file mode 100644 index 0000000..91364ee --- /dev/null +++ b/documentation/usersguide/images/svg/monitoring-printers.svg @@ -0,0 +1,4 @@ + + + +
Monitoring Server
Naemon
check_hpjd

Router / Switch
SNMP
OID Value,
Port Status,
etc
 \ No newline at end of file diff --git a/documentation/usersguide/images/svg/monitoring-routers.svg b/documentation/usersguide/images/svg/monitoring-routers.svg new file mode 100644 index 0000000..dda7a81 --- /dev/null +++ b/documentation/usersguide/images/svg/monitoring-routers.svg @@ -0,0 +1,4 @@ + + + +
Monitoring Server
Naemon
check_snmp
check_mrtgtraf
MRTG

Router / Switch
SNMP
OID Value,
Port Status,
etc
 \ No newline at end of file diff --git a/documentation/usersguide/images/svg/monitoring-windows.svg b/documentation/usersguide/images/svg/monitoring-windows.svg new file mode 100644 index 0000000..72efa72 --- /dev/null +++ b/documentation/usersguide/images/svg/monitoring-windows.svg @@ -0,0 +1,4 @@ + + + +
Monitoring Server
Naemon
check_nt

Windows Machine
NSClient++
CPU
Memory
Disk Space
Processes
Services
 \ No newline at end of file diff --git a/documentation/usersguide/images/svg/nrpe.svg b/documentation/usersguide/images/svg/nrpe.svg new file mode 100644 index 0000000..ae123b6 --- /dev/null +++ b/documentation/usersguide/images/svg/nrpe.svg @@ -0,0 +1,4 @@ + + + +
Monitoring Server
Naemon
check_nrpe

Remote Linux/Unix Host
NRPE
check_disk
check_load
Local Resources and Services
SSL

 \ No newline at end of file diff --git a/documentation/usersguide/images/svg/nsca.svg b/documentation/usersguide/images/svg/nsca.svg new file mode 100644 index 0000000..8e366a3 --- /dev/null +++ b/documentation/usersguide/images/svg/nsca.svg @@ -0,0 +1,4 @@ + + + +
Monitoring Server
Naemon
External
Command
File
NSCA

Remote Linux/Unix Machine
send_nsca
Program /
Script
 \ No newline at end of file diff --git a/documentation/usersguide/images/svg/passivechecks.svg b/documentation/usersguide/images/svg/passivechecks.svg new file mode 100644 index 0000000..cddf3f3 --- /dev/null +++ b/documentation/usersguide/images/svg/passivechecks.svg @@ -0,0 +1,4 @@ + + + +
Naemon Process
Check Logic
External Command Logic
External
Applications
External
Command
File
(naemon.cmd)
 \ No newline at end of file diff --git a/documentation/usersguide/images/svg/plugins.svg b/documentation/usersguide/images/svg/plugins.svg new file mode 100644 index 0000000..86bba65 --- /dev/null +++ b/documentation/usersguide/images/svg/plugins.svg @@ -0,0 +1,4 @@ + + + +
Naemon Process
Check Logic

Executable binaries and scripts
e.g. Bash, Perl, Python, etc.
Check Plugins

Host and Services
Target
Monitoring Logic
Monitoring Abstraction Layer
Monitoring Entities
 \ No newline at end of file diff --git a/documentation/usersguide/integration.md b/documentation/usersguide/integration.md index f70d310..68e3577 100644 --- a/documentation/usersguide/integration.md +++ b/documentation/usersguide/integration.md @@ -10,7 +10,7 @@ One of the reasons that Naemon is such a popular monitoring application is the f ### Integration Points -Integration Overview +Integration Overview To monitor new hardware, services, or applications, check out the docs on: diff --git a/documentation/usersguide/monitoring-linux.md b/documentation/usersguide/monitoring-linux.md index 76b19ea..a6ab0bc 100644 --- a/documentation/usersguide/monitoring-linux.md +++ b/documentation/usersguide/monitoring-linux.md @@ -33,6 +33,6 @@ The sample configuration entries below reference objects that are defined in the There are several different ways to monitor attributes or remote Linux/Unix servers. One is by using shared SSH keys and the check_by_ssh plugin to execute plugins on remote servers. This method will not be covered here, but can result in high load on your monitoring server if you are monitoring hundreds or thousands of services. The overhead of setting up/destroying SSH connections is the cause of this. -NRPE +NRPE Another common method of monitoring remote Linux/Unix hosts is to use the NRPE addon. NRPE allows you to execute plugins on remote Linux/Unix hosts. This is useful if you need to monitor local resources/attributes like disk usage, CPU load, memory usage, etc. on a remote host. diff --git a/documentation/usersguide/monitoring-printers.md b/documentation/usersguide/monitoring-printers.md index fd2cf7a..66f29bc 100644 --- a/documentation/usersguide/monitoring-printers.md +++ b/documentation/usersguide/monitoring-printers.md @@ -34,7 +34,7 @@ The sample configuration entries below reference objects that are defined in the ### Overview -Monitoring a Network Printer +Monitoring a Network Printer Monitoring the status of a networked printer is pretty simple. JetDirect-enabled printers usually have SNMP enabled, which allows Naemon to monitor their status using the check_hpjd plugin. diff --git a/documentation/usersguide/monitoring-routers.md b/documentation/usersguide/monitoring-routers.md index d5023b8..772cc4f 100644 --- a/documentation/usersguide/monitoring-routers.md +++ b/documentation/usersguide/monitoring-routers.md @@ -27,7 +27,7 @@ You can monitor the following things on managed switches, hubs, and routers: ### Overview -Monitoring a Router or Switch +Monitoring a Router or Switch Monitoring switches and routers can either be easy or more involved - depending on what equipment you have and what you want to monitor. As they are critical infrastructure components, you'll no doubt want to monitor them in at least some basic manner. diff --git a/documentation/usersguide/monitoring-windows.md b/documentation/usersguide/monitoring-windows.md index ed3b76d..bb0194e 100644 --- a/documentation/usersguide/monitoring-windows.md +++ b/documentation/usersguide/monitoring-windows.md @@ -20,7 +20,7 @@ Publicly available services that are provided by Windows machines (HTTP, FTP, PO ### Overview -Monitoring a Windows Machine +Monitoring a Windows Machine Monitoring private services or attributes of a Windows machine requires that you install an agent on it. This agent acts as a proxy between the Naemon plugin that does the monitoring and the actual service or attribute of the Windows machine. Without installing an agent on the Windows box, Naemon would be unable to monitor local services or attributes of the Windows box. diff --git a/documentation/usersguide/passivechecks.md b/documentation/usersguide/passivechecks.md index 5c2ac5b..db81d8c 100644 --- a/documentation/usersguide/passivechecks.md +++ b/documentation/usersguide/passivechecks.md @@ -30,7 +30,7 @@ Passive checks are also used when configuring distrib ### How Passive Checks Work -Passive Checks +Passive Checks Here's how passive checks work in more detail... @@ -115,7 +115,7 @@ Unlike with active host checks, Naemon does not (by default) attempt to determin ### Submitting Passive Check Results From Remote Hosts -NSCA Addon +NSCA Addon If an application that resides on the same host as Naemon is sending passive host or service check results, it can simply write the results directly to the external command file as outlined above. However, applications on remote hosts can't do this so easily. diff --git a/documentation/usersguide/plugins.md b/documentation/usersguide/plugins.md index 0e16a65..89b67e7 100644 --- a/documentation/usersguide/plugins.md +++ b/documentation/usersguide/plugins.md @@ -16,7 +16,7 @@ Naemon will execute a plugin whenever there is a need to check the status of a s ### Plugins As An Abstraction Layer -Plugins +Plugins Plugins act as an abstraction layer between the monitoring logic present in the Naemon daemon and the actual services and hosts that are being monitored.