]> 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 77d7aaba81eeebb013a05d59a20cfebf970189e6..6536709f4c2e20ba60c8df9caf34706c02855fe1 100644 (file)
@@ -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>
@@ -2465,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
@@ -2506,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)
@@ -2520,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>