"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/10-icinga-template-library.md" between
icinga2-2.11.5.tar.gz and icinga2-2.12.0.tar.gz

About: Icinga 2 is an enterprise grade monitoring system which keeps watch over networks and any conceivable network resource.

10-icinga-template-library.md  (icinga2-2.11.5):10-icinga-template-library.md  (icinga2-2.12.0)
skipping to change at line 1459 skipping to change at line 1459
Name | Description Name | Description
----------------|-------------- ----------------|--------------
uptime_warning | **Required.** Min. number of uptime to generate warning (-w 30 m). Defaults to 30m. uptime_warning | **Required.** Min. number of uptime to generate warning (-w 30 m). Defaults to 30m.
uptime_critical | **Required.** Min. number of uptime to generate critical alert (-c 15m). Defaults to 15m. uptime_critical | **Required.** Min. number of uptime to generate critical alert (-c 15m). Defaults to 15m.
uptime_for | **Optional.** Show uptime in a pretty format (Running for x we eks, x days, ...). Defaults to false. uptime_for | **Optional.** Show uptime in a pretty format (Running for x we eks, x days, ...). Defaults to false.
uptime_since | **Optional.** Show last boot in yyyy-mm-dd HH:MM:SS format (ou tput from 'uptime -s'). Defaults to false. uptime_since | **Optional.** Show last boot in yyyy-mm-dd HH:MM:SS format (ou tput from 'uptime -s'). Defaults to false.
## Windows Plugins for Icinga 2 <a id="windows-plugins"></a> ## Windows Plugins for Icinga 2 <a id="windows-plugins"></a>
> **Note**
>
> These plugins are DEPRECATED in favor of our
> [PowerShell Plugins](https://github.com/Icinga/icinga-powershell-plugins)
> and will be removed in a future release.
> Check the [roadmap](https://github.com/Icinga/icinga2/milestones).
To allow a basic monitoring of Windows clients Icinga 2 comes with a set of Wind ows only plugins. While trying to mirror the functionalities of their linux cous ins from the monitoring-plugins package, the differences between Windows and Lin ux are too big to be able use the same CheckCommands for both systems. To allow a basic monitoring of Windows clients Icinga 2 comes with a set of Wind ows only plugins. While trying to mirror the functionalities of their linux cous ins from the monitoring-plugins package, the differences between Windows and Lin ux are too big to be able use the same CheckCommands for both systems.
A check-commands-windows.conf comes with Icinga 2, it assumes that the Windows P lugins are installed in the PluginDir set in your constants.conf. To enable them the following include directive is needed in you icinga2.conf: A check-commands-windows.conf comes with Icinga 2, it assumes that the Windows P lugins are installed in the PluginDir set in your constants.conf. To enable them the following include directive is needed in you icinga2.conf:
include <windows-plugins> include <windows-plugins>
One of the differences between the Windows plugins and their linux counterparts is that they consistently do not require thresholds to run, functioning like dum mies without. One of the differences between the Windows plugins and their linux counterparts is that they consistently do not require thresholds to run, functioning like dum mies without.
### Threshold syntax <a id="windows-plugins-thresholds"></a> ### Threshold syntax <a id="windows-plugins-thresholds"></a>
skipping to change at line 1669 skipping to change at line 1676
Check command object for `check_users.exe` plugin. Check command object for `check_users.exe` plugin.
Custom variables: Custom variables:
Name | Description Name | Description
:----------------|:------------ :----------------|:------------
users\_win\_warn | **Optional**. The warning threshold. users\_win\_warn | **Optional**. The warning threshold.
users\_win\_crit | **Optional**. The critical threshold. users\_win\_crit | **Optional**. The critical threshold.
### file-age-windows <a id="windows-plugins-file-age-windows"></a>
Check command object for `check_file_age.cmd` command file and `check_file_age.c
md.ps1` plugin.
Custom variables:
Name | Description
:---------------------|:------------
file_age_win_file | **Required**. File name and location
file_age_win_warning | **Required**. The warning threshold of file age in secon
ds.
file_age_win_critical | **Required**. The critical threshold of file age in seco
nds.
All variables are required and all variables are positional. The variable order
is: file warning critical.
The check_file_age.cmd and the check_file_age.cmd.ps1 files are available for [d
ownload](https://github.com/KAMI911/icinga2-basic/tree/master/plugins).
## Plugin Check Commands for NSClient++ <a id="nscp-plugin-check-commands"></a> ## Plugin Check Commands for NSClient++ <a id="nscp-plugin-check-commands"></a>
There are two methods available for querying NSClient++: There are two methods available for querying NSClient++:
* Query the [HTTP API](06-distributed-monitoring.md#distributed-monitoring-windo ws-nscp-check-api) locally from an Icinga 2 client (requires a running NSClient+ + service) * Query the [HTTP API](06-distributed-monitoring.md#distributed-monitoring-windo ws-nscp-check-api) locally from an Icinga 2 client (requires a running NSClient+ + service)
* Run a [local CLI check](10-icinga-template-library.md#nscp-check-local) (does not require NSClient++ as a service) * Run a [local CLI check](10-icinga-template-library.md#nscp-check-local) (does not require NSClient++ as a service)
Both methods have their advantages and disadvantages. One thing to Both methods have their advantages and disadvantages. One thing to
note: If you rely on performance counter delta calculations such as note: If you rely on performance counter delta calculations such as
CPU utilization, please use the HTTP API instead of the CLI sample call. CPU utilization, please use the HTTP API instead of the CLI sample call.
skipping to change at line 2072 skipping to change at line 2095
snmp_interface | **Optional.** Network interface name. Default to r egex "eth0". snmp_interface | **Optional.** Network interface name. Default to r egex "eth0".
snmp_interface_inverse | **Optional.** Inverse Interface check, down is ok. Defaults to false as it is missing. snmp_interface_inverse | **Optional.** Inverse Interface check, down is ok. Defaults to false as it is missing.
snmp_interface_perf | **Optional.** Check the input/output bandwidth of the interface. Defaults to true. snmp_interface_perf | **Optional.** Check the input/output bandwidth of the interface. Defaults to true.
snmp_interface_label | **Optional.** Add label before speed in output: in =, out=, errors-out=, etc. snmp_interface_label | **Optional.** Add label before speed in output: in =, out=, errors-out=, etc.
snmp_interface_bits_bytes | **Optional.** Output performance data in bits/s or Bytes/s. **Depends** on snmp_interface_kbits set to true. Defaults to true. snmp_interface_bits_bytes | **Optional.** Output performance data in bits/s or Bytes/s. **Depends** on snmp_interface_kbits set to true. Defaults to true.
snmp_interface_percent | **Optional.** Output performance data in % of max speed. Defaults to false. snmp_interface_percent | **Optional.** Output performance data in % of max speed. Defaults to false.
snmp_interface_kbits | **Optional.** Make the warning and critical levels in KBits/s. Defaults to true. snmp_interface_kbits | **Optional.** Make the warning and critical levels in KBits/s. Defaults to true.
snmp_interface_megabytes | **Optional.** Make the warning and critical levels in Mbps or MBps. **Depends** on snmp_interface_kbits set to true. Defaults to t rue. snmp_interface_megabytes | **Optional.** Make the warning and critical levels in Mbps or MBps. **Depends** on snmp_interface_kbits set to true. Defaults to t rue.
snmp_interface_64bit | **Optional.** Use 64 bits counters instead of the standard counters when checking bandwidth & performance data for interface >= 1G bps. Defaults to false. snmp_interface_64bit | **Optional.** Use 64 bits counters instead of the standard counters when checking bandwidth & performance data for interface >= 1G bps. Defaults to false.
snmp_interface_errors | **Optional.** Add error & discard to Perfparse out put. Defaults to true. snmp_interface_errors | **Optional.** Add error & discard to Perfparse out put. Defaults to true.
snmp_interface_extended_checks | **Optional.** Also check the error and discard input/output. When enabled format of `snmp_warn` and `snmp_crit` changes to <In bytes>,<Out bytes>,<In error>,<Out error>,<In disc>,<Out disc>. More options ava ilable in the [snmp interface](http://nagios.manubulon.com/snmp_int.html) docume ntation. Defaults to false.
snmp_interface_noregexp | **Optional.** Do not use regexp to match interface name in description OID. Defaults to false. snmp_interface_noregexp | **Optional.** Do not use regexp to match interface name in description OID. Defaults to false.
snmp_interface_delta | **Optional.** Delta time of perfcheck. Defaults to "300" (5 min). snmp_interface_delta | **Optional.** Delta time of perfcheck. Defaults to "300" (5 min).
snmp_interface_warncrit_percent | **Optional.** Make the warning and critical le vels in % of reported interface speed. If set, **snmp_interface_megabytes** need s to be set to false. Defaults to false. snmp_interface_warncrit_percent | **Optional.** Make the warning and critical le vels in % of reported interface speed. If set, **snmp_interface_megabytes** need s to be set to false. Defaults to false.
snmp_interface_ifname | **Optional.** Switch from IF-MIB::ifDescr to IF-MI B::ifName when looking up the interface's name. snmp_interface_ifname | **Optional.** Switch from IF-MIB::ifDescr to IF-MI B::ifName when looking up the interface's name.
snmp_interface_ifalias | **Optional.** Switch from IF-MIB::ifDescr to IF-MI B::ifAlias when looking up the interface's name. snmp_interface_ifalias | **Optional.** Switch from IF-MIB::ifDescr to IF-MI B::ifAlias when looking up the interface's name.
snmp_interface_weathermap | **Optional.** Output data for ["weathermap" lines] (http://docs.nagvis.org/1.9/en_US/lines_weathermap_style.html) in NagVis. **Depe nds** on `snmp_interface_perf` set to true. Defaults to `false`. **Note**: Avail able in `check_snmp_int.pl v2.1.0`. snmp_interface_weathermap | **Optional.** Output data for ["weathermap" lines] (http://docs.nagvis.org/1.9/en_US/lines_weathermap_style.html) in NagVis. **Depe nds** on `snmp_interface_perf` set to true. Defaults to `false`. **Note**: Avail able in `check_snmp_int.pl v2.1.0`.
snmp_perf | **Optional.** Enable perfdata values. Defaults to true. snmp_perf | **Optional.** Enable perfdata values. Defaults to true.
snmp_timeout | **Optional.** The command timeout in seconds. Defa ults to 5 seconds. snmp_timeout | **Optional.** The command timeout in seconds. Defa ults to 5 seconds.
### snmp-process <a id="plugin-check-command-snmp-process"></a> ### snmp-process <a id="plugin-check-command-snmp-process"></a>
skipping to change at line 2368 skipping to change at line 2392
oracle_health_mode | **Required.** The mode uses predefined keywor ds for the different checks. For example "connection-time", "flash-recovery-area -usage" or "sql". oracle_health_mode | **Required.** The mode uses predefined keywor ds for the different checks. For example "connection-time", "flash-recovery-area -usage" or "sql".
oracle_health_method | **Optional.** How the plugin should connect t o the database (`dbi` for using DBD::Oracle (default), `sqlplus` for using the s qlplus-Tool). oracle_health_method | **Optional.** How the plugin should connect t o the database (`dbi` for using DBD::Oracle (default), `sqlplus` for using the s qlplus-Tool).
oracle_health_name | **Optional.** The tablespace, datafile, wait event, latch, enqueue depending on the mode or SQL statement to be executed with "oracle_health_mode" sql. oracle_health_name | **Optional.** The tablespace, datafile, wait event, latch, enqueue depending on the mode or SQL statement to be executed with "oracle_health_mode" sql.
oracle_health_name2 | **Optional.** If "oracle_health_name" is a sq l statement, "oracle_health_name2" can be used to appear in the output and the p erformance data. oracle_health_name2 | **Optional.** If "oracle_health_name" is a sq l statement, "oracle_health_name2" can be used to appear in the output and the p erformance data.
oracle_health_regexp | **Optional.** If set to true, "oracle_health_ name" will be interpreted as a regular expression. Defaults to false. oracle_health_regexp | **Optional.** If set to true, "oracle_health_ name" will be interpreted as a regular expression. Defaults to false.
oracle_health_units | **Optional.** This is used for a better outpu t of mode=sql and for specifying thresholds for mode=tablespace-free. Possible v alues are "%", "KB", "MB" and "GB". oracle_health_units | **Optional.** This is used for a better outpu t of mode=sql and for specifying thresholds for mode=tablespace-free. Possible v alues are "%", "KB", "MB" and "GB".
oracle_health_ident | **Optional.** If set to true, outputs instanc e and database names. Defaults to false. oracle_health_ident | **Optional.** If set to true, outputs instanc e and database names. Defaults to false.
oracle_health_commit | **Optional.** Set this to true to turn on aut ocommit for the dbd::oracle module. Defaults to false. oracle_health_commit | **Optional.** Set this to true to turn on aut ocommit for the dbd::oracle module. Defaults to false.
oracle_health_noperfdata | **Optional.** Set this to true if you want to disable perfdata. Defaults to false. oracle_health_noperfdata | **Optional.** Set this to true if you want to disable perfdata. Defaults to false.
oracle_health_timeout | **Optional.** Plugin timeout. Defaults to 60s . oracle_health_timeout | **Optional.** Plugin timeout. Defaults to 60s .
oracle_health_report | **Optional.** Select the plugin output format oracle_health_report | **Optional.** Select the plugin output format
. Can be short or long. Default to long. . Can be short or long. Defaults to long.
oracle_health_notemp | **Optional.** Set this to true to hide tempor
ary and system tablespaces. Defaults to false.
Environment Macros: Environment Macros:
Name | Description Name | Description
--------------------|----------------------------------------------------------- ------------------------------------------------------------------------------- --------------------|----------------------------------------------------------- -------------------------------------------------------------------------------
ORACLE\_HOME | **Required.** Specifies the location of the oracle instan t client libraries. Defaults to "/usr/lib/oracle/11.2/client64/lib". Can be over ridden by setting the custom variable `oracle_home`. ORACLE\_HOME | **Required.** Specifies the location of the oracle instan t client libraries. Defaults to "/usr/lib/oracle/11.2/client64/lib". Can be over ridden by setting the custom variable `oracle_home`.
LD\_LIBRARY\_PATH | **Required.** Specifies the location of the oracle instan t client libraries for the run-time shared library loader. Defaults to "/usr/lib /oracle/11.2/client64/lib". Can be overridden by setting the custom variable `or acle_ld_library_path`. LD\_LIBRARY\_PATH | **Required.** Specifies the location of the oracle instan t client libraries for the run-time shared library loader. Defaults to "/usr/lib /oracle/11.2/client64/lib". Can be overridden by setting the custom variable `or acle_ld_library_path`.
TNS\_ADMIN | **Required.** Specifies the location of the tnsnames.ora including the database connection strings. Defaults to "/etc/icinga2/plugin-conf igs". Can be overridden by setting the custom variable `oracle_tns_admin`. TNS\_ADMIN | **Required.** Specifies the location of the tnsnames.ora including the database connection strings. Defaults to "/etc/icinga2/plugin-conf igs". Can be overridden by setting the custom variable `oracle_tns_admin`.
#### postgres <a id="plugin-contrib-command-postgres"></a> #### postgres <a id="plugin-contrib-command-postgres"></a>
 End of changes. 4 change blocks. 
2 lines changed or deleted 33 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)