]> granicus.if.org Git - icinga2/blobdiff - doc/10-icinga-template-library.md
Merge pull request #5906 from sahnd/feature/check_openmanage
[icinga2] / doc / 10-icinga-template-library.md
index fcca883a39fa75a86391c4315dba5df8201983df..6536709f4c2e20ba60c8df9caf34706c02855fe1 100644 (file)
@@ -607,7 +607,7 @@ http_invertregex                 | **Optional.** Changes behavior of http_expect
 http_warn_time                   | **Optional.** The warning threshold.
 http_critical_time               | **Optional.** The critical threshold.
 http_expect                      | **Optional.** Comma-delimited list of strings, at least one of them is expected in the first (status) line of the server response. Default: HTTP/1.
-http_certificate                 | **Optional.** Minimum number of days a certificate has to be valid. This parameter explicitly sets the port to 443 and ignores the URL if passed.
+http_certificate                 | **Optional.** Minimum number of days a certificate has to be valid. Port defaults to 443. When this option is used the URL is not checked. The first parameter defines the warning threshold (in days), the second parameter the critical threshold (in days). (Example `http_certificate = "30,20"`).
 http_clientcert                  | **Optional.** Name of file contains the client certificate (PEM format).
 http_privatekey                  | **Optional.** Name of file contains the private key (PEM format).
 http_headerstring                | **Optional.** String to expect in the response headers.
@@ -1996,6 +1996,8 @@ snmp_crit               | **Optional.** The critical threshold.
 snmp_is_cisco          | **Optional.** Change OIDs for Cisco switches. Defaults to false.
 snmp_is_hp              | **Optional.** Change OIDs for HP/Procurve switches. Defaults to false.
 snmp_perf               | **Optional.** Enable perfdata values. Defaults to true.
+snmp_memcached          | **Optional.** Include cached memory in used memory, Defaults to false.
+snmp_membuffer          | **Optional.** Exclude buffered memory in used memory, Defaults to false.
 snmp_timeout            | **Optional.** The command timeout in seconds. Defaults to 5 seconds.
 
 ### snmp-storage <a id="plugin-check-command-snmp-storage"></a>
@@ -2023,6 +2025,7 @@ snmp_crit               | **Optional.** The critical threshold.
 snmp_storage_name       | **Optional.** Storage name. Default to regex "^/$$". More options available in the [snmp storage](http://nagios.manubulon.com/snmp_storage.html) documentation.
 snmp_perf               | **Optional.** Enable perfdata values. Defaults to true.
 snmp_timeout            | **Optional.** The command timeout in seconds. Defaults to 5 seconds.
+snmp_storage_olength   | **Optional.** Max-size of the SNMP message, usefull in case of Too Long responses.
 
 ### snmp-interface <a id="plugin-check-command-snmp-interface"></a>
 
@@ -2464,6 +2467,47 @@ hpasm_servertype         | **Optional.** The type of the server: proliant (default) or
 hpasm_eval-nics                        | **Optional.** Check network interfaces (and groups). Try it and report me whyt you think about it. I need to build up some know how on this subject. If you get an error and think, it is not justified for your configuration, please tell me about it. (always send the output of "snmpwalk -On .... 1.3.6.1.4.1.232" and a description how you setup your nics and why it is correct opposed to the plugins error message.
 hpasm_remote                   | **Optional.** Run remote SNMP checks if enabled. Otherwise checks are executed locally using the `hpasmcli` binary. Defaults to `true`.
 
+#### openmanage <a id="plugin-contrib-command-openmanage"></a>
+
+The [check_openmanage](http://folk.uio.no/trondham/software/check_openmanage.html) plugin
+checks the hardware health of Dell PowerEdge (and some PowerVault) servers.
+It uses the Dell OpenManage Server Administrator (OMSA) software, which must be running on
+the monitored system. check_openmanage can be used remotely with SNMP or locally with icinga2 agent,
+check_by_ssh or similar, whichever suits your needs and particular taste.
+
+The plugin checks the health of the storage subsystem, power supplies, memory modules, 
+temperature probes etc., and gives an alert if any of the components are faulty or operate outside normal parameters.
+
+Custom attributes passed as [command parameters](03-monitoring-basics.md#command-passing-parameters):
+
+Name                           | Description
+--------------------------------|-----------------------------------------------------------------------
+openmanage_all                 | **Optional.** Check everything, even log content
+openmanage_blacklist           | **Optional.** Blacklist missing and/or failed components
+openmanage_check               | **Optional.** Fine-tune which components are checked
+openmanage_community           | **Optional.** SNMP community string [default=public]
+openmanage_config              | **Optional.** Specify configuration file
+openmanage_critical            | **Optional.** Custom temperature critical limits
+openmanage_extinfo             | **Optional.** Append system info to alerts
+openmanage_fahrenheit          | **Optional.** Use Fahrenheit as temperature unit
+openmanage_hostname            | **Optional.** Hostname or IP (required for SNMP)
+openmanage_htmlinfo            | **Optional.** HTML output with clickable links
+openmanage_info                        | **Optional.** Prefix any alerts with the service tag
+openmanage_ipv6                        | **Optional.** Use IPv6 instead of IPv4 [default=no]
+openmanage_legacy_perfdata     | **Optional.** Legacy performance data output
+openmanage_no_storage          | **Optional.** Don't check storage
+openmanage_only                        | **Optional.** Only check a certain component or alert type
+openmanage_perfdata            | **Optional.** Output performance data [default=no]
+openmanage_port                        | **Optional.** SNMP port number [default=161]
+openmanage_protocol            | **Optional.** SNMP protocol version [default=2c]
+openmanage_short_state         | **Optional.** Prefix alerts with alert state abbreviated
+openmanage_show_blacklist      | **Optional.** Show blacklistings in OK output
+openmanage_state               | **Optional.** Prefix alerts with alert state
+openmanage_tcp                 | **Optional.** Use TCP instead of UDP [default=no]
+openmanage_timeout             | **Optional.** Plugin timeout in seconds [default=30]
+openmanage_vdisk_critical      | **Optional.** Make any alerts on virtual disks critical
+openmanage_warning             | **Optional.** Custom temperature warning limits
+
 #### adaptec-raid <a id="plugin-contrib-command-adaptec-raid"></a>
 
 The [check_adaptec_raid](https://github.com/thomas-krenn/check_adaptec_raid) plugin
@@ -2505,6 +2549,8 @@ smart_attributes_device         | **Required.** Device name (e.g. /dev/sda) to m
 
 This category includes all plugins using the icingacli provided by Icinga Web 2.
 
+The user running Icinga 2 needs sufficient permissions to read the Icinga Web 2 configuration directory. e.g. `usermod -a -G icingaweb2 icinga`. You need to restart, not reload Icinga 2 for the new group membership to work.
+
 #### Business Process <a id="plugin-contrib-icingacli-businessprocess"></a>
 
 This subcommand is provided by the [business process module](https://exchange.icinga.com/icinga/Business+Process)
@@ -2519,6 +2565,16 @@ icingacli_businessprocess_config          | **Optional.** Configuration file con
 icingacli_businessprocess_details         | **Optional.** Get details for root cause analysis. Defaults to false.
 icingacli_businessprocess_statetype       | **Optional.** Define which state type to look at, `soft` or `hard`. Overrides the default value inside the businessprocess module, if configured.
 
+#### Director <a id="plugin-contrib-icingacli-director"></a>
+
+This subcommand is provided by the [director module](https://github.com/Icinga/icingaweb2-module-director) > 1.4.2 and executed as `icingacli director health check`. Please refer to the [documentation](https://github.com/Icinga/icingaweb2-module-director/blob/master/doc/60-CLI.md#health-check-plugin) for all available sub-checks.
+
+Custom attributes passed as [command parameters](03-monitoring-basics.md#command-passing-parameters):
+
+Name                                      | Description
+------------------------------------------|-----------------------------------------------------------------------------------------
+icingacli_director_check                  | **Optional.** Run only a specific test suite.
+icingacli_director_db                     | **Optional.** Use a specific Icinga Web DB resource.
 
 ### IPMI Devices <a id="plugin-contrib-ipmi"></a>