# Configuring Icinga 2 ## Global Constants Icinga 2 provides a number of special global constants. Some of them can be overridden using the `--define` command line parameter: Variable |Description --------------------|------------------- PrefixDir |**Read-only.** Contains the installation prefix that was specified with cmake -DCMAKE_INSTALL_PREFIX. Defaults to "/usr/local". SysconfDir |**Read-only.** Contains the path of the sysconf directory. Defaults to PrefixDir + "/etc". ZonesDir |**Read-only.** Contains the path of the zones.d directory. Defaults to SysconfDir + "/zones.d". LocalStateDir |**Read-only.** Contains the path of the local state directory. Defaults to PrefixDir + "/var". RunDir |**Read-only.** Contains the path of the run directory. Defaults to LocalStateDir + "/run". PkgDataDir |**Read-only.** Contains the path of the package data directory. Defaults to PrefixDir + "/share/icinga2". StatePath |**Read-write.** Contains the path of the Icinga 2 state file. Defaults to LocalStateDir + "/lib/icinga2/icinga2.state". ObjectsPath |**Read-write.** Contains the path of the Icinga 2 objects file. Defaults to LocalStateDir + "/cache/icinga2/icinga2.debug". PidPath |**Read-write.** Contains the path of the Icinga 2 PID file. Defaults to RunDir + "/icinga2/icinga2.pid". Vars |**Read-write.** Contains a dictionary with global custom attributes. Not set by default. NodeName |**Read-write.** Contains the cluster node name. Set to the local hostname by default. ApplicationType |**Read-write.** Contains the name of the Application type. Defaults to "icinga/IcingaApplication". EnableNotifications |**Read-write.** Whether notifications are globally enabled. Defaults to true. EnableEventHandlers |**Read-write.** Whether event handlers are globally enabled. Defaults to true. EnableFlapping |**Read-write.** Whether flap detection is globally enabled. Defaults to true. EnableHostChecks |**Read-write.** Whether active host checks are globally enabled. Defaults to true. EnableServiceChecks |**Read-write.** Whether active service checks are globally enabled. Defaults to true. EnablePerfdata |**Read-write.** Whether performance data processing is globally enabled. Defaults to true. UseVfork |**Read-write.** Whether to use vfork(). Only available on *NIX. Defaults to true. RunAsUser |**Read-write.** Defines the user the Icinga 2 daemon is running as. Used in [init.conf](#init-conf). RunAsGroup |**Read-write.** Defines the group the Icinga 2 daemon is running as. Used in [init.conf](#init-conf). ## Reserved Keywords These keywords are reserved by the configuration parser and must not be used as constants or custom attributes. object template include include_recursive library null partial true false const apply to where import assign ignore zone in You can escape reserved keywords using the `@` character. The following example will try to set `vars.include` which references a reserved keyword and generates the following error: [2014-09-15 17:24:00 +0200] critical/config: Location: /etc/icinga2/conf.d/hosts/localhost.conf(13): vars.sla = "24x7" /etc/icinga2/conf.d/hosts/localhost.conf(14): /etc/icinga2/conf.d/hosts/localhost.conf(15): vars.include = "some cmdb export field" ^^^^^^^ /etc/icinga2/conf.d/hosts/localhost.conf(16): } /etc/icinga2/conf.d/hosts/localhost.conf(17): Config error: in /etc/icinga2/conf.d/hosts/localhost.conf: 15:8-15:14: syntax error, unexpected include (T_INCLUDE), expecting T_IDENTIFIER [2014-09-15 17:24:00 +0200] critical/config: 1 errors, 0 warnings. You can escape the `include` key with an additional `@` character becoming `vars.@include`: object Host "localhost" { import "generic-host" address = "127.0.0.1" address6 = "::1" vars.os = "Linux" vars.sla = "24x7" vars.@include = "some cmdb export field" } ## Configuration Syntax ### Object Definition Icinga 2 features an object-based configuration format. You can define new objects using the `object` keyword: object Host "host1.example.org" { display_name = "host1" address = "192.168.0.1" address6 = "::1" } In general you need to write each statement on a new line. Expressions started with `{`, `(` and `[` extend until the matching closing character and can be broken up into multiple lines. Alternatively you can write multiple statements on a single line by separating them with a semicolon: object Host "host1.example.org" { display_name = "host1" address = "192.168.0.1"; address6 = "::1" } Each object is uniquely identified by its type (`Host`) and name (`host1.example.org`). Some types have composite names, e.g. the `Service` type which uses the `host_name` attribute and the name you specified to generate its object name. Exclamation marks (!) are not permitted in object names. Objects can contain a comma-separated list of property declarations. Instead of commas semicolons may also be used. The following data types are available for property values: ### Expressions The following expressions can be used on the right-hand side of dictionary values. #### Numeric Literals A floating-point number. Example: -27.3 #### Duration Literals Similar to floating-point numbers except for the fact that they support suffixes to help with specifying time durations. Example: 2.5m Supported suffixes include ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Duration literals are converted to seconds by the config parser and are treated like numeric literals. #### String Literals A string. Example: "Hello World!" Certain characters need to be escaped. The following escape sequences are supported: Character | Escape sequence --------------------------|------------------------------------ " | \\" \\ | \\\\ <TAB> | \\t <CARRIAGE-RETURN> | \\r <LINE-FEED> | \\n <BEL> | \\b <FORM-FEED> | \\f In addition to these pre-defined escape sequences you can specify arbitrary ASCII characters using the backslash character (\\) followed by an ASCII character in octal encoding. #### Multi-line String Literals Strings spanning multiple lines can be specified by enclosing them in {{{ and }}}. Example: {{{This is a multi-line string.}}} Unlike in ordinary strings special characters do not have to be escaped in multi-line string literals. #### Boolean Literals The keywords `true` and `false` are equivalent to 1 and 0 respectively. #### Null Value The `null` keyword can be used to specify an empty value. #### Dictionary An unordered list of key-value pairs. Keys must be unique and are compared in a case-insensitive manner. Individual key-value pairs must either be comma-separated or on separate lines. The comma after the last key-value pair is optional. Example: { address = "192.168.0.1" port = 443 } Identifiers may not contain certain characters (e.g. space) or start with certain characters (e.g. digits). If you want to use a dictionary key that is not a valid identifier you can enclose the key in double quotes. Setting a dictionary key to null causes the key and its value to be removed from the dictionary. #### Array An ordered list of values. Individual array elements must be comma-separated. The comma after the last element is optional. Example: [ "hello", 42 ] An array may simultaneously contain values of different types, such as strings and numbers. #### Operators The following operators are supported in expressions: Operator | Examples (Result) | Description ---------|-----------------------------------------------|-------------------------------- ! | !"Hello" (false), !false (true) | Logical negation of the operand ~ | ~true (false) | Bitwise negation of the operand + | 1 + 3 (4), "hello " + "world" ("hello world") | Adds two numbers; concatenates strings - | 3 - 1 (2) | Subtracts two numbers * | 5m * 10 (3000) | Multiplies two numbers / | 5m / 5 (60) | Divides two numbers & | 7 & 3 (3) | Binary AND | | 2 | 3 (3) | Binary OR && | true && false (false) | Logical AND || | true || false (true) | Logical OR < | 3 < 5 (true) | Less than > | 3 > 5 (false) | Greater than <= | 3 <= 3 (true) | Less than or equal >= | 3 >= 3 (true) | Greater than or equal << | 4 << 8 (1024) | Left shift >> | 1024 >> 4 (64) | Right shift == | "hello" == "hello" (true), 3 == 5 (false) | Equal to != | "hello" != "world" (true), 3 != 3 (false) | Not equal to in | "foo" in [ "foo", "bar" ] (true) | Element contained in array !in | "foo" !in [ "bar", "baz" ] (true) | Element not contained in array () | (3 + 3) * 5 | Groups sub-expressions Constants may be used in expressions: const MyCheckInterval = 10m ... { check_interval = MyCheckInterval / 2.5 } #### Function Calls Functions can be called using the `()` operator: const MyGroups = [ "test1", "test" ] { check_interval = len(MyGroups) * 1m } > **Tip** > > Use these functions in [apply](#using-apply) rule expressions. assign where match("192.168.*", host.address) Function | Description --------------------------------|----------------------- regex(pattern, text) | Returns true if the regex pattern matches the text, false otherwise. match(pattern, text) | Returns true if the wildcard pattern matches the text, false otherwise. len(value) | Returns the length of the value, i.e. the number of elements for an array or dictionary, or the length of the string in bytes. union(array, array, ...) | Returns an array containing all unique elements from the specified arrays. intersection(array, array, ...) | Returns an array containing all unique elements which are common to all specified arrays. keys(dict) | Returns an array containing the dictionary's keys. string(value) | Converts the value to a string. number(value) | Converts the value to a number. bool(value) | Converts the value to a bool. random() | Returns a random value between 0 and RAND_MAX (as defined in stdlib.h). log(value) | Writes a message to the log. Non-string values are converted to a JSON string. log(severity, facility, value) | Writes a message to the log. `severity` can be one of `LogDebug`, `LogNotice`, `LogInformation`, `LogWarning`, and `LogCritical`. Non-string values are converted to a JSON string. exit(integer) | Terminates the application. ### Dictionary Operators In addition to the `=` operator shown above a number of other operators to manipulate dictionary elements are supported. Here's a list of all available operators: #### Operator = Sets a dictionary element to the specified value. Example: { a = 5 a = 7 } In this example `a` has the value `7` after both instructions are executed. #### Operator += The += operator is a shortcut. The following expression: { a = [ "hello" ] a += [ "world" ] } is equivalent to: { a = [ "hello" ] a = a + [ "world" ] } #### Operator -= The -= operator is a shortcut. The following expression: { a = 10 a -= 5 } is equivalent to: { a = 10 a = a - 5 } #### Operator \*= The *= operator is a shortcut. The following expression: { a = 60 a *= 5 } is equivalent to: { a = 60 a = a * 5 } #### Operator /= The /= operator is a shortcut. The following expression: { a = 300 a /= 5 } is equivalent to: { a = 300 a = a / 5 } ### Indexer The indexer syntax provides a convenient way to set dictionary elements. Example: { hello.key = "world" } Example (alternative syntax): { hello["key"] = "world" } This is equivalent to writing: { hello += { key = "world" } } ### Template Imports Objects can import attributes from other objects. Example: template Host "default-host" { vars.colour = "red" } template Host "test-host" { import "default-host" vars.colour = "blue" } object Host "localhost" { import "test-host" address = "127.0.0.1" address6 = "::1" } The `default-host` and `test-host` objects are marked as templates using the `template` keyword. Unlike ordinary objects templates are not instantiated at run-time. Parent objects do not necessarily have to be templates, however in general they are. The `vars` dictionary for the `localhost` object contains all three custom attributes and the custom attribute `colour` has the value `"blue"`. Parent objects are resolved in the order they're specified using the `import` keyword. ### Constants Global constants can be set using the `const` keyword: const VarName = "some value" Once defined a constant can be accessed from any file. Constants cannot be changed once they are set. There is a defined set of [global constants](#global-constants) which allow you to specify application settings. ### Apply The `apply` keyword can be used to create new objects which are associated with another group of objects. apply Service "ping" to Host { import "generic-service" check_command = "ping4" assign where host.name == "localhost" } In this example the `assign where` condition is a boolean expression which is evaluated for all objects of type `Host` and a new service with name "ping" is created for each matching host. [Expression operators](#expression-operators) may be used in `assign where` conditions. The `to` keyword and the target type may be omitted if there is only one target type, e.g. for the `Service` type. Depending on the object type used in the `apply` expression additional local variables may be available for use in the `where` condition: Source Type | Target Type | Variables ------------------|-------------|-------------- Service | Host | host Dependency | Host | host Dependency | Service | host, service Notification | Host | host Notification | Service | host, service ScheduledDowntime | Host | host ScheduledDowntime | Service | host, service Any valid config attribute can be accessed using the `host` and `service` variables. For example, `host.address` would return the value of the host's "address" attribute - or null if that attribute isn't set. ### Group Assign Group objects can be assigned to specific member objects using the `assign where` and `ignore where` conditions. object HostGroup "linux-servers" { display_name = "Linux Servers" assign where host.vars.os == "Linux" } In this example the `assign where` condition is a boolean expression which is evaluated for all objects of the type `Host`. Each matching host is added as member to the host group with the name "linux-servers". Membership exclusion can be controlled using the `ignore where` condition. [Expression operators](#expression-operators) may be used in `assign where` and `ignore where` conditions. Source Type | Variables ------------------|-------------- HostGroup | host ServiceGroup | host, service UserGroup | user ### Boolean Values The `assign where` and `ignore where` statements, the `!`, `&&` and `||` operators as well as the `bool()` function convert their arguments to a boolean value based on the following rules: Description | Example Value | Boolean Value ---------------------|-------------------|-------------- Empty value | null | false Zero | 0 | false Non-zero integer | -23945 | true Empty string | "" | false Non-empty string | "Hello" | true Empty array | [] | false Non-empty array | [ "Hello" ] | true Empty dictionary | {} | false Non-empty dictionary | { key = "value" } | true For a list of supported expression operators for `assign where` and `ignore where` statements, see [expression operators](#expression-operators). ### Comments The Icinga 2 configuration format supports C/C++-style and shell-style comments. Example: /* This is a comment. */ object Host "localhost" { check_interval = 30 // this is also a comment. retry_interval = 15 # yet another comment } ### Includes Other configuration files can be included using the `include` directive. Paths must be relative to the configuration file that contains the `include` directive. Example: include "some/other/file.conf" include "conf.d/*.conf" Wildcard includes are not recursive. Icinga also supports include search paths similar to how they work in a C/C++ compiler: include Note the use of angle brackets instead of double quotes. This causes the config compiler to search the include search paths for the specified file. By default $PREFIX/share/icinga2 is included in the list of search paths. Additional include search paths can be added using [command-line options](#cmdline). Wildcards are not permitted when using angle brackets. ### Recursive Includes The `include_recursive` directive can be used to recursively include all files in a directory which match a certain pattern. Example: include_recursive "conf.d", "*.conf" include_recursive "templates" The first parameter specifies the directory from which files should be recursively included. The file names need to match the pattern given in the second parameter. When no pattern is specified the default pattern "*.conf" is used. ### Library directive The `library` directive can be used to manually load additional libraries. Libraries can be used to provide additional object types and functions. Example: library "snmphelper" ## Object Types ### Host A host. Example: object Host "localhost" { display_name = "The best host there is" address = "127.0.0.1" address6 = "::1" groups = [ "all-hosts" ] check_command = "hostalive" } Attributes: Name |Description ----------------|---------------- display_name |**Optional.** A short description of the host. address |**Optional.** The host's address. Available as command runtime macro `$address$` if set. address6 |**Optional.** The host's address. Available as command runtime macro `$address6$` if set. groups |**Optional.** A list of host groups this host belongs to. vars |**Optional.** A dictionary containing custom attributes that are specific to this host. check\_command |**Required.** The name of the check command. max\_check\_attempts|**Optional.** The number of times a host is re-checked before changing into a hard state. Defaults to 3. check\_period |**Optional.** The name of a time period which determines when this host should be checked. Not set by default. check\_interval |**Optional.** The check interval (in seconds). This interval is used for checks when the host is in a `HARD` state. Defaults to 5 minutes. retry\_interval |**Optional.** The retry interval (in seconds). This interval is used for checks when the host is in a `SOFT` state. Defaults to 1 minute. enable\_notifications|**Optional.** Whether notifications are enabled. Defaults to true. enable\_active\_checks|**Optional.** Whether active checks are enabled. Defaults to true. enable\_passive\_checks|**Optional.** Whether passive checks are enabled. Defaults to true. enable\_event\_handler|**Optional.** Enables event handlers for this host. Defaults to true. enable\_flapping|**Optional.** Whether flap detection is enabled. Defaults to true. enable\_perfdata|**Optional.** Whether performance data processing is enabled. Defaults to true. event\_command |**Optional.** The name of an event command that should be executed every time the host's state changes or the host is in a `SOFT` state. flapping\_threshold|**Optional.** The flapping threshold in percent when a host is considered to be flapping. volatile |**Optional.** The volatile setting enables always `HARD` state types if `NOT-OK` state changes occur. zone |**Optional.** The zone this object is a member of. command\_endpoint|**Optional.** The endpoint where commands are executed on. notes |**Optional.** Notes for the host. notes\_url |**Optional.** Url for notes for the host (for example, in notification commands). action\_url |**Optional.** Url for actions for the host (for example, an external graphing tool). icon\_image |**Optional.** Icon image for the host. Used by external interfaces only. icon\_image\_alt|**Optional.** Icon image description for the host. Used by external interface only. > **Best Practice** > > The `address` and `address6` attributes are required for running commands using > the `$address$` and `$address6$` runtime macros. ### HostGroup A group of hosts. > **Best Practice** > > Assign host group members using the [group assign](#group-assign) rules. Example: object HostGroup "my-hosts" { display_name = "My hosts" } Attributes: Name |Description ----------------|---------------- display_name |**Optional.** A short description of the host group. groups |**Optional.** An array of nested group names. ### Service Service objects describe network services and how they should be checked by Icinga 2. > **Best Practice** > > Rather than creating a `Service` object for a specific host it is usually easier > to just create a `Service` template and use the `apply` keyword to assign the > service to a number of hosts. > Check the [apply](#using-apply) chapter for details. Example: object Service "uptime" { host_name = "localhost" display_name = "localhost Uptime" check_command = "check_snmp" vars.community = "public" vars.oid = "DISMAN-EVENT-MIB::sysUpTimeInstance" check_interval = 60s retry_interval = 15s groups = [ "all-services", "snmp" ] } Attributes: Name |Description ----------------|---------------- display_name |**Optional.** A short description of the service. host_name |**Required.** The host this service belongs to. There must be a `Host` object with that name. name |**Required.** The service name. Must be unique on a per-host basis (Similar to the service_description attribute in Icinga 1.x). groups |**Optional.** The service groups this service belongs to. vars |**Optional.** A dictionary containing custom attributes that are specific to this service. check\_command |**Required.** The name of the check command. max\_check\_attempts|**Optional.** The number of times a service is re-checked before changing into a hard state. Defaults to 3. check\_period |**Optional.** The name of a time period which determines when this service should be checked. Not set by default. check\_interval |**Optional.** The check interval (in seconds). This interval is used for checks when the service is in a `HARD` state. Defaults to 5 minutes. retry\_interval |**Optional.** The retry interval (in seconds). This interval is used for checks when the service is in a `SOFT` state. Defaults to 1 minute. enable\_notifications|**Optional.** Whether notifications are enabled. Defaults to true. enable\_active\_checks|**Optional.** Whether active checks are enabled. Defaults to true. enable\_passive\_checks|**Optional.** Whether passive checks are enabled. Defaults to true. enable\_event\_handler|**Optional.** Enables event handlers for this host. Defaults to true. enable\_flapping|**Optional.** Whether flap detection is enabled. Defaults to true. enable\_perfdata|**Optional.** Whether performance data processing is enabled. Defaults to true. event\_command |**Optional.** The name of an event command that should be executed every time the service's state changes or the service is in a `SOFT` state. flapping\_threshold|**Optional.** The flapping threshold in percent when a service is considered to be flapping. volatile |**Optional.** The volatile setting enables always `HARD` state types if `NOT-OK` state changes occur. zone |**Optional.** The zone this object is a member of. command\_endpoint|**Optional.** The endpoint where commands are executed on. notes |**Optional.** Notes for the service. notes\_url |**Optional.** Url for notes for the service (for example, in notification commands). action_url |**Optional.** Url for actions for the service (for example, an external graphing tool). icon\_image |**Optional.** Icon image for the service. Used by external interfaces only. icon\_image\_alt|**Optional.** Icon image description for the service. Used by external interface only. Service objects have composite names, i.e. their names are based on the host_name attribute and the name you specified. This means you can define more than one object with the same (short) name as long as the `host_name` attribute has a different value. ### ServiceGroup A group of services. > **Best Practice** > > Assign service group members using the [group assign](#group-assign) rules. Example: object ServiceGroup "snmp" { display_name = "SNMP services" } Attributes: Name |Description ----------------|---------------- display_name |**Optional.** A short description of the service group. groups |**Optional.** An array of nested group names. ### User A user. Example: object User "icingaadmin" { display_name = "Icinga 2 Admin" groups = [ "icingaadmins" ] email = "icinga@localhost" pager = "icingaadmin@localhost.localdomain" period = "24x7" states = [ OK, Warning, Critical, Unknown ] types = [ Problem, Recovery ] vars.additional_notes = "This is the Icinga 2 Admin account." } Available notification state filters: OK Warning Critical Unknown Up Down Available notification type filters: DowntimeStart DowntimeEnd DowntimeRemoved Custom Acknowledgement Problem Recovery FlappingStart FlappingEnd Attributes: Name |Description ----------------|---------------- display_name |**Optional.** A short description of the user. email |**Optional.** An email string for this user. Useful for notification commands. pager |**Optional.** A pager string for this user. Useful for notification commands. vars |**Optional.** A dictionary containing custom attributes that are specific to this user. groups |**Optional.** An array of group names. enable_notifications|**Optional.** Whether notifications are enabled for this user. period |**Optional.** The name of a time period which determines when a notification for this user should be triggered. Not set by default. types |**Optional.** A set of type filters when this notification should be triggered. By default everything is matched. states |**Optional.** A set of state filters when this notification should be triggered. By default everything is matched. zone |**Optional.** The zone this object is a member of. ### UserGroup A user group. > **Best Practice** > > Assign user group members using the [group assign](#group-assign) rules. Example: object UserGroup "icingaadmins" { display_name = "Icinga 2 Admin Group" } Attributes: Name |Description ----------------|---------------- display_name |**Optional.** A short description of the user group. groups |**Optional.** An array of nested group names. zone |**Optional.** The zone this object is a member of. ### CheckCommand A check command definition. Additional default command custom attributes can be defined here. Example: object CheckCommand "check_http" { import "plugin-check-command" command = [ PluginDir + "/check_http" ] arguments = { "-H" = "$http_vhost$" "-I" = "$http_address$" "-u" = "$http_uri$" "-p" = "$http_port$" "-S" = { set_if = "$http_ssl$" } "--sni" = { set_if = "$http_sni$" } "-a" = { value = "$http_auth_pair$" description = "Username:password on sites with basic authentication" } "--no-body" = { set_if = "$http_ignore_body$" } "-r" = "$http_expect_body_regex$" "-w" = "$http_warn_time$" "-c" = "$http_critical_time$" "-e" = "$http_expect$" } vars.http_address = "$address$" vars.http_ssl = false vars.http_sni = false } Attributes: Name |Description ----------------|---------------- methods |**Required.** The "execute" script method takes care of executing the check. In virtually all cases you should import the "plugin-check-command" template to take care of this setting. command |**Required.** The command. This can either be an array of individual command arguments. Alternatively a string can be specified in which case the shell interpreter (usually /bin/sh) takes care of parsing the command. When using the "arguments" attribute this must be an array. env |**Optional.** A dictionary of macros which should be exported as environment variables prior to executing the command. vars |**Optional.** A dictionary containing custom attributes that are specific to this command. timeout |**Optional.** The command timeout in seconds. Defaults to 60 seconds. zone |**Optional.** The zone this object is a member of. arguments |**Optional.** A dictionary of command arguments. #### CheckCommand Arguments Command arguments can be defined as key-value-pairs in the `arguments` dictionary. If the argument requires additional configuration for example a `description` attribute or an optional condition, the value can be defined as dictionary specifying additional options. Service: vars.x_val = "My command argument value." vars.have_x = "true" CheckCommand: arguments = { "-X" = { value = "$x_val$" key = "-Xnew" /* optional, set a new key identifier */ description = "My plugin requires this argument for doing X." required = false /* optional, no error if not set */ skip_key = false /* always use "-X " */ set_if = "$have_x$" /* only set if variable defined and resolves to a numeric value. String values are not supported */ order = -1 /* first position */ repeat_key = true /* if `value` is an array, repeat the key as parameter: ... 'key' 'value[0]' 'key' 'value[1]' 'key' 'value[2]' ... */ } "-Y" = { value = "$y_val$" description = "My plugin requires this argument for doing Y." required = false /* optional, no error if not set */ skip_key = true /* don't prefix "-Y" only use "" */ set_if = "$have_y$" /* only set if variable defined and resolves to a numeric value. String values are not supported */ order = 0 /* second position */ repeat_key = false /* if `value` is an array, do not repeat the key as parameter: ... 'key' 'value[0]' 'value[1]' 'value[2]' ... */ } } Option | Description ------------|-------------- value | Optional argument value. key | Optional argument key overriding the key identifier. description | Optional argument description. required | Required argument. Execution error if not set. Defaults to false (optional). skip_key | Use the value as argument and skip the key. set_if | Argument is added if the macro resolves to a defined numeric value. String values are not supported. order | Set if multiple arguments require a defined argument order. repeat_key | If the argument value is an array, repeat the argument key, or not. Defaults to true (repeat). Argument order: `..., -3, -2, -1, , 1, 2, 3, ...` Argument array `repeat_key = true`: `'key' 'value[0]' 'key' 'value[1]' 'key' 'value[2]'` Argument array `repeat_key = false`: `'key' 'value[0]' 'value[1]' 'value[2]'` ### NotificationCommand A notification command definition. Example: object NotificationCommand "mail-service-notification" { import "plugin-notification-command" command = [ SysconfDir + "/icinga2/scripts/mail-notification.sh" ] env = { NOTIFICATIONTYPE = "$notification.type$" SERVICEDESC = "$service.name$" HOSTALIAS = "$host.display_name$" HOSTADDRESS = "$address$" SERVICESTATE = "$service.state$" LONGDATETIME = "$icinga.long_date_time$" SERVICEOUTPUT = "$service.output$" NOTIFICATIONAUTHORNAME = "$notification.author$" NOTIFICATIONCOMMENT = "$notification.comment$" HOSTDISPLAYNAME = "$host.display_name$" SERVICEDISPLAYNAME = "$service.display_name$" USEREMAIL = "$user.email$" } } Attributes: Name |Description ----------------|---------------- methods |**Required.** The "execute" script method takes care of executing the notification. In virtually all cases you should import the "plugin-notification-command" template to take care of this setting. command |**Required.** The command. This can either be an array of individual command arguments. Alternatively a string can be specified in which case the shell interpreter (usually /bin/sh) takes care of parsing the command. env |**Optional.** A dictionary of macros which should be exported as environment variables prior to executing the command. vars |**Optional.** A dictionary containing custom attributes that are specific to this command. timeout |**Optional.** The command timeout in seconds. Defaults to 60 seconds. zone |**Optional.** The zone this object is a member of. arguments |**Optional.** A dictionary of command arguments. Command arguments can be used the same way as for [CheckCommand objects](#objecttype-checkcommand-arguments). ### EventCommand An event command definition. Example: object EventCommand "restart-httpd-event" { import "plugin-event-command" command = "/opt/bin/restart-httpd.sh" } Attributes: Name |Description ----------------|---------------- methods |**Required.** The "execute" script method takes care of executing the event handler. In virtually all cases you should import the "plugin-event-command" template to take care of this setting. command |**Required.** The command. This can either be an array of individual command arguments. Alternatively a string can be specified in which case the shell interpreter (usually /bin/sh) takes care of parsing the command. env |**Optional.** A dictionary of macros which should be exported as environment variables prior to executing the command. vars |**Optional.** A dictionary containing custom attributes that are specific to this command. timeout |**Optional.** The command timeout in seconds. Defaults to 60 seconds. arguments |**Optional.** A dictionary of command arguments. Command arguments can be used the same way as for [CheckCommand objects](#objecttype-checkcommand-arguments). ### Notification Notification objects are used to specify how users should be notified in case of host and service state changes and other events. > **Best Practice** > > Rather than creating a `Notification` object for a specific host or service it is > usually easier to just create a `Notification` template and use the `apply` keyword > to assign the notification to a number of hosts or services. Use the `to` keyword > to set the specific target type for `Host` or `Service`. > Check the [notifications](#notifications) chapter for detailed examples. Example: object Notification "localhost-ping-notification" { host_name = "localhost" service_name = "ping4" command = "mail-notification" users = [ "user1", "user2" ] types = [ Problem, Recovery ] } Attributes: Name | Description --------------------------|---------------- host_name | **Required.** The name of the host this notification belongs to. service_name | **Optional.** The short name of the service this notification belongs to. If omitted this notification object is treated as host notification. vars | **Optional.** A dictionary containing custom attributes that are specific to this notification object. users | **Optional.** A list of user names who should be notified. user_groups | **Optional.** A list of user group names who should be notified. times | **Optional.** A dictionary containing `begin` and `end` attributes for the notification. command | **Required.** The name of the notification command which should be executed when the notification is triggered. interval | **Optional.** The notification interval (in seconds). This interval is used for active notifications. Defaults to 30 minutes. If set to 0, [re-notifications](#disable-renotification) are disabled. period | **Optional.** The name of a time period which determines when this notification should be triggered. Not set by default. zone |**Optional.** The zone this object is a member of. types | **Optional.** A list of type filters when this notification should be triggered. By default everything is matched. states | **Optional.** A list of state filters when this notification should be triggered. By default everything is matched. Available notification state filters: OK Warning Critical Unknown Up Down Available notification type filters: DowntimeStart DowntimeEnd DowntimeRemoved Custom Acknowledgement Problem Recovery FlappingStart FlappingEnd ### TimePeriod Time periods can be used to specify when hosts/services should be checked or to limit when notifications should be sent out. Example: object TimePeriod "24x7" { import "legacy-timeperiod" display_name = "Icinga 2 24x7 TimePeriod" ranges = { monday = "00:00-24:00" tuesday = "00:00-24:00" wednesday = "00:00-24:00" thursday = "00:00-24:00" friday = "00:00-24:00" saturday = "00:00-24:00" sunday = "00:00-24:00" } } Attributes: Name |Description ----------------|---------------- display_name |**Optional.** A short description of the time period. methods |**Required.** The "update" script method takes care of updating the internal representation of the time period. In virtually all cases you should import the "legacy-timeperiod" template to take care of this setting. zone |**Optional.** The zone this object is a member of. ranges |**Required.** A dictionary containing information which days and durations apply to this timeperiod. The `/etc/icinga2/conf.d/timeperiods.conf` file is usually used to define timeperiods including this one. ### ScheduledDowntime ScheduledDowntime objects can be used to set up recurring downtimes for hosts/services. > **Best Practice** > > Rather than creating a `ScheduledDowntime` object for a specific host or service it is usually easier > to just create a `ScheduledDowntime` template and use the `apply` keyword to assign the > scheduled downtime to a number of hosts or services. Use the `to` keyword to set the specific target > type for `Host` or `Service`. > Check the [recurring downtimes](#recurring-downtimes) example for details. Example: object ScheduledDowntime "some-downtime" { host_name = "localhost" service_name = "ping4" author = "icingaadmin" comment = "Some comment" fixed = false duration = 30m ranges = { "sunday" = "02:00-03:00" } } Attributes: Name |Description ----------------|---------------- host_name |**Required.** The name of the host this scheduled downtime belongs to. service_name |**Optional.** The short name of the service this scheduled downtime belongs to. If omitted this downtime object is treated as host downtime. author |**Required.** The author of the downtime. comment |**Required.** A comment for the downtime. fixed |**Optional.** Whether this is a fixed downtime. Defaults to true. duration |**Optional.** How long the downtime lasts. Only has an effect for flexible (non-fixed) downtimes. zone |**Optional.** The zone this object is a member of. ranges |**Required.** A dictionary containing information which days and durations apply to this timeperiod. ScheduledDowntime objects have composite names, i.e. their names are based on the `host_name` and `service_name` attributes and the name you specified. This means you can define more than one object with the same (short) name as long as one of the `host_name` and `service_name` attributes has a different value. ### Dependency Dependency objects are used to specify dependencies between hosts and services. Dependencies can be defined as Host-to-Host, Service-to-Service, Service-to-Host, or Host-to-Service relations. > **Best Practice** > > Rather than creating a `Dependency` object for a specific host or service it is usually easier > to just create a `Dependency` template and use the `apply` keyword to assign the > dependency to a number of hosts or services. Use the `to` keyword to set the specific target > type for `Host` or `Service`. > Check the [dependencies](#dependencies) chapter for detailed examples. Service-to-Service Example: object Dependency "webserver-internet" { parent_host_name = "internet" parent_service_name = "ping4" child_host_name = "webserver" child_service_name = "ping4" states = [ OK, Warning ] disable_checks = true } Host-to-Host Example: object Dependency "webserver-internet" { parent_host_name = "internet" child_host_name = "webserver" states = [ Up ] disable_checks = true } Attributes: Name |Description ----------------------|---------------- parent_host_name |**Required.** The parent host. parent_service_name |**Optional.** The parent service. If omitted this dependency object is treated as host dependency. child_host_name |**Required.** The child host. child_service_name |**Optional.** The child service. If omitted this dependency object is treated as host dependency. disable_checks |**Optional.** Whether to disable checks when this dependency fails. Defaults to false. disable_notifications |**Optional.** Whether to disable notifications when this dependency fails. Defaults to true. period |**Optional.** Time period during which this dependency is enabled. zone |**Optional.** The zone this object is a member of. states |**Optional.** A list of state filters when this dependency should be OK. Defaults to [ OK, Warning ] for services and [ Up ] for hosts. Available state filters: OK Warning Critical Unknown Up Down When using [apply rules](#using-apply) for dependencies, you can leave out certain attributes which will be automatically determined by Icinga 2. Service-to-Host Dependency Example: apply Dependency "internet" to Service { parent_host_name = "dsl-router" disable_checks = true assign where host.name != "dsl-router" } This example sets all service objects matching the assign condition into a dependency relation to the parent host object `dsl-router` as implicit child services. Service-to-Service-on-the-same-Host Dependency Example: apply Dependency "disable-nrpe-checks" to Service { parent_service_name = "nrpe-health" assign where service.check_command == "nrpe" ignore where service.name == "nrpe-health" } This example omits the `parent_host_name` attribute and Icinga 2 automatically sets its value to the name of the host object matched by the apply rule condition. All services where apply matches are made implicit child services in this dependency relation. Dependency objects have composite names, i.e. their names are based on the `child_host_name` and `child_service_name` attributes and the name you specified. This means you can define more than one object with the same (short) name as long as one of the `child_host_name` and `child_service_name` attributes has a different value. ### PerfdataWriter Writes check result performance data to a defined path using macro pattern consisting of custom attributes and runtime macros. Example: library "perfdata" object PerfdataWriter "pnp" { host_perfdata_path = "/var/spool/icinga2/perfdata/host-perfdata" service_perfdata_path = "/var/spool/icinga2/perfdata/service-perfdata" host_format_template = "DATATYPE::HOSTPERFDATA\tTIMET::$icinga.timet$\tHOSTNAME::$host.name$\tHOSTPERFDATA::$host.perfdata$\tHOSTCHECKCOMMAND::$host.check_command$\tHOSTSTATE::$host.state$\tHOSTSTATETYPE::$host.state_type$" service_format_template = "DATATYPE::SERVICEPERFDATA\tTIMET::$icinga.timet$\tHOSTNAME::$host.name$\tSERVICEDESC::$service.name$\tSERVICEPERFDATA::$service.perfdata$\tSERVICECHECKCOMMAND::$service.check_command$\tHOSTSTATE::$host.state$\tHOSTSTATETYPE::$host.state_type$\tSERVICESTATE::$service.state$\tSERVICESTATETYPE::$service.state_type$" rotation_interval = 15s } Attributes: Name |Description ------------------------|---------------- host_perfdata\_path |**Optional.** Path to the host performance data file. Defaults to LocalStateDir + "/spool/icinga2/perfdata/host-perfdata". service_perfdata\_path |**Optional.** Path to the service performance data file. Defaults to LocalStateDir + "/spool/icinga2/perfdata/service-perfdata". host_temp\_path |**Optional.** Path to the temporary host file. Defaults to LocalStateDir + "/spool/icinga2/tmp/host-perfdata". service_temp\_path |**Optional.** Path to the temporary service file. Defaults to LocalStateDir + "/spool/icinga2/tmp/service-perfdata". host_format\_template |**Optional.** Host Format template for the performance data file. Defaults to a template that's suitable for use with PNP4Nagios. service_format\_template|**Optional.** Service Format template for the performance data file. Defaults to a template that's suitable for use with PNP4Nagios. rotation\_interval |**Optional.** Rotation interval for the files specified in `{host,service}_perfdata_path`. Defaults to 30 seconds. When rotating the performance data file the current UNIX timestamp is appended to the path specified in `host_perfdata_path` and `service_perfdata_path` to generate a unique filename. ### GraphiteWriter Writes check result metrics and performance data to a defined Graphite Carbon host. Example: library "perfdata" object GraphiteWriter "graphite" { host = "127.0.0.1" port = 2003 } Attributes: Name |Description ----------------------|---------------------- host |**Optional.** Graphite Carbon host address. Defaults to '127.0.0.1'. port |**Optional.** Graphite Carbon port. Defaults to 2003. host_name_template |**Optional.** Metric prefix for host name. Defaults to "icinga.$host.name$". service_name_template |**Optional.** Metric prefix for service name. Defaults to "icinga.$host.name$.$service.name$". Metric prefix names can be modified using [runtime macros](#runtime-macros). Example with your custom [global constant](#global-constants) `GraphiteEnv`: const GraphiteEnv = "icinga.env1" host_name_template = GraphiteEnv + ".$host.name$" service_name_template = GraphiteEnv + ".$host.name$.$service.name$" ### GelfWriter Writes event log entries to a defined GELF receiver host (Graylog2, Logstash). Example: library "perfdata" object GelfWriter "gelf" { host = "127.0.0.1" port = 12201 } Attributes: Name |Description ----------------------|---------------------- host |**Optional.** GELF receiver host address. Defaults to '127.0.0.1'. port |**Optional.** GELF receiver port. Defaults to `12201`. source |**Optional.** Source name for this instance. Defaults to `icinga2`. ### IdoMySqlConnection IDO database adapter for MySQL. Example: library "db_ido_mysql" object IdoMysqlConnection "mysql-ido" { host = "127.0.0.1" port = 3306 user = "icinga" password = "icinga" database = "icinga" table_prefix = "icinga_" instance_name = "icinga2" instance_description = "icinga2 instance" cleanup = { downtimehistory_age = 48h logentries_age = 31d } categories = DbCatConfig | DbCatState } Attributes: Name |Description ----------------|---------------- host |**Optional.** MySQL database host address. Defaults to "localhost". port |**Optional.** MySQL database port. Defaults to 3306. socket_path |**Optional.** MySQL socket path. user |**Optional.** MySQL database user with read/write permission to the icinga database. Defaults to "icinga". password |**Optional.** MySQL database user's password. Defaults to "icinga". database |**Optional.** MySQL database name. Defaults to "icinga". table\_prefix |**Optional.** MySQL database table prefix. Defaults to "icinga\_". instance\_name |**Optional.** Unique identifier for the local Icinga 2 instance. Defaults to "default". instance\_description|**Optional.** Description for the Icinga 2 instance. enable_ha |**Optional.** Enable the high availability functionality. Only valid in a [cluster setup](#high-availability-db-ido). Defaults to "true". failover_timeout | **Optional.** Set the failover timeout in a [HA cluster](#high-availability-db-ido). Must not be lower than 60s. Defaults to "60s". cleanup |**Optional.** Dictionary with items for historical table cleanup. categories |**Optional.** The types of information that should be written to the database. Cleanup Items: Name | Description ----------------|---------------- acknowledgements_age |**Optional.** Max age for acknowledgements table rows (entry_time). Defaults to 0 (never). commenthistory_age |**Optional.** Max age for commenthistory table rows (entry_time). Defaults to 0 (never). contactnotifications_age |**Optional.** Max age for contactnotifications table rows (start_time). Defaults to 0 (never). contactnotificationmethods_age |**Optional.** Max age for contactnotificationmethods table rows (start_time). Defaults to 0 (never). downtimehistory_age |**Optional.** Max age for downtimehistory table rows (entry_time). Defaults to 0 (never). eventhandlers_age |**Optional.** Max age for eventhandlers table rows (start_time). Defaults to 0 (never). externalcommands_age |**Optional.** Max age for externalcommands table rows (entry_time). Defaults to 0 (never). flappinghistory_age |**Optional.** Max age for flappinghistory table rows (event_time). Defaults to 0 (never). hostchecks_age |**Optional.** Max age for hostalives table rows (start_time). Defaults to 0 (never). logentries_age |**Optional.** Max age for logentries table rows (logentry_time). Defaults to 0 (never). notifications_age |**Optional.** Max age for notifications table rows (start_time). Defaults to 0 (never). processevents_age |**Optional.** Max age for processevents table rows (event_time). Defaults to 0 (never). statehistory_age |**Optional.** Max age for statehistory table rows (state_time). Defaults to 0 (never). servicechecks_age |**Optional.** Max age for servicechecks table rows (start_time). Defaults to 0 (never). systemcommands_age |**Optional.** Max age for systemcommands table rows (start_time). Defaults to 0 (never). Data Categories: Name | Description | Required by ---------------------|------------------------|-------------------- DbCatConfig | Configuration data | Icinga Web/Reporting DbCatState | Current state data | Icinga Web/Reporting DbCatAcknowledgement | Acknowledgements | Icinga Web/Reporting DbCatComment | Comments | Icinga Web/Reporting DbCatDowntime | Downtimes | Icinga Web/Reporting DbCatEventHandler | Event handler data | Icinga Web/Reporting DbCatExternalCommand | External commands | Icinga Web/Reporting DbCatFlapping | Flap detection data | Icinga Web/Reporting DbCatCheck | Check results | -- DbCatLog | Log messages | Icinga Web/Reporting DbCatNotification | Notifications | Icinga Web/Reporting DbCatProgramStatus | Program status data | Icinga Web/Reporting DbCatRetention | Retention data | Icinga Web/Reporting DbCatStateHistory | Historical state data | Icinga Web/Reporting Multiple categories can be combined using the `|` operator. In addition to the category flags listed above the `DbCatEverything` flag may be used as a shortcut for listing all flags. External interfaces like Icinga Web require everything except `DbCatCheck` which is the default value if `categories` is not set. ### IdoPgSqlConnection IDO database adapter for PostgreSQL. Example: library "db_ido_pgsql" object IdoMysqlConnection "pgsql-ido" { host = "127.0.0.1" port = 5432 user = "icinga" password = "icinga" database = "icinga" table_prefix = "icinga_" instance_name = "icinga2" instance_description = "icinga2 instance" cleanup = { downtimehistory_age = 48h logentries_age = 31d } categories = DbCatConfig | DbCatState } Attributes: Name |Description ----------------|---------------- host |**Optional.** PostgreSQL database host address. Defaults to "localhost". port |**Optional.** PostgreSQL database port. Defaults to "5432". user |**Optional.** PostgreSQL database user with read/write permission to the icinga database. Defaults to "icinga". password |**Optional.** PostgreSQL database user's password. Defaults to "icinga". database |**Optional.** PostgreSQL database name. Defaults to "icinga". table\_prefix |**Optional.** PostgreSQL database table prefix. Defaults to "icinga\_". instance\_name |**Optional.** Unique identifier for the local Icinga 2 instance. Defaults to "default". instance\_description|**Optional.** Description for the Icinga 2 instance. enable_ha |**Optional.** Enable the high availability functionality. Only valid in a [cluster setup](#high-availability-db-ido). Defaults to "true". failover_timeout | **Optional.** Set the failover timeout in a [HA cluster](#high-availability-db-ido). Must not be lower than 60s. Defaults to "60s". cleanup |**Optional.** Dictionary with items for historical table cleanup. categories |**Optional.** The types of information that should be written to the database. Cleanup Items: Name | Description ----------------|---------------- acknowledgements_age |**Optional.** Max age for acknowledgements table rows (entry_time). Defaults to 0 (never). commenthistory_age |**Optional.** Max age for commenthistory table rows (entry_time). Defaults to 0 (never). contactnotifications_age |**Optional.** Max age for contactnotifications table rows (start_time). Defaults to 0 (never). contactnotificationmethods_age |**Optional.** Max age for contactnotificationmethods table rows (start_time). Defaults to 0 (never). downtimehistory_age |**Optional.** Max age for downtimehistory table rows (entry_time). Defaults to 0 (never). eventhandlers_age |**Optional.** Max age for eventhandlers table rows (start_time). Defaults to 0 (never). externalcommands_age |**Optional.** Max age for externalcommands table rows (entry_time). Defaults to 0 (never). flappinghistory_age |**Optional.** Max age for flappinghistory table rows (event_time). Defaults to 0 (never). hostchecks_age |**Optional.** Max age for hostalives table rows (start_time). Defaults to 0 (never). logentries_age |**Optional.** Max age for logentries table rows (logentry_time). Defaults to 0 (never). notifications_age |**Optional.** Max age for notifications table rows (start_time). Defaults to 0 (never). processevents_age |**Optional.** Max age for processevents table rows (event_time). Defaults to 0 (never). statehistory_age |**Optional.** Max age for statehistory table rows (state_time). Defaults to 0 (never). servicechecks_age |**Optional.** Max age for servicechecks table rows (start_time). Defaults to 0 (never). systemcommands_age |**Optional.** Max age for systemcommands table rows (start_time). Defaults to 0 (never). Data Categories: Name | Description | Required by ---------------------|------------------------|-------------------- DbCatConfig | Configuration data | Icinga Web/Reporting DbCatState | Current state data | Icinga Web/Reporting DbCatAcknowledgement | Acknowledgements | Icinga Web/Reporting DbCatComment | Comments | Icinga Web/Reporting DbCatDowntime | Downtimes | Icinga Web/Reporting DbCatEventHandler | Event handler data | Icinga Web/Reporting DbCatExternalCommand | External commands | Icinga Web/Reporting DbCatFlapping | Flap detection data | Icinga Web/Reporting DbCatCheck | Check results | -- DbCatLog | Log messages | Icinga Web/Reporting DbCatNotification | Notifications | Icinga Web/Reporting DbCatProgramStatus | Program status data | Icinga Web/Reporting DbCatRetention | Retention data | Icinga Web/Reporting DbCatStateHistory | Historical state data | Icinga Web/Reporting Multiple categories can be combined using the `|` operator. In addition to the category flags listed above the `DbCatEverything` flag may be used as a shortcut for listing all flags. External interfaces like Icinga Web require everything except `DbCatCheck` which is the default value if `categories` is not set. ### LiveStatusListener Livestatus API interface available as TCP or UNIX socket. Historical table queries require the `CompatLogger` feature enabled pointing to the log files using the `compat_log_path` configuration attribute. Example: library "livestatus" object LivestatusListener "livestatus-tcp" { socket_type = "tcp" bind_host = "127.0.0.1" bind_port = "6558" } object LivestatusListener "livestatus-unix" { socket_type = "unix" socket_path = "/var/run/icinga2/cmd/livestatus" } Attributes: Name |Description ----------------|---------------- socket\_type |**Optional.** Specifies the socket type. Can be either "tcp" or "unix". Defaults to "unix". bind\_host |**Optional.** Only valid when socket\_type is "tcp". Host address to listen on for connections. Defaults to "127.0.0.1". bind\_port |**Optional.** Only valid when `socket_type` is "tcp". Port to listen on for connections. Defaults to 6558. socket\_path |**Optional.** Only valid when `socket_type` is "unix". Specifies the path to the UNIX socket file. Defaults to RunDir + "/icinga2/cmd/livestatus". compat\_log\_path |**Optional.** Required for historical table queries. Requires `CompatLogger` feature enabled. Defaults to LocalStateDir + "/log/icinga2/compat" > **Note** > > UNIX sockets are not supported on Windows. ### StatusDataWriter Periodically writes status data files which are used by the Classic UI and other third-party tools. Example: library "compat" object StatusDataWriter "status" { status_path = "/var/cache/icinga2/status.dat" objects_path = "/var/cache/icinga2/objects.path" update_interval = 30s } Attributes: Name |Description ----------------|---------------- status\_path |**Optional.** Path to the status.dat file. Defaults to LocalStateDir + "/cache/icinga2/status.dat". objects\_path |**Optional.** Path to the objects.cache file. Defaults to LocalStateDir + "/cache/icinga2/objects.cache". update\_interval|**Optional.** The interval in which the status files are updated. Defaults to 15 seconds. ### ExternalCommandListener Implements the Icinga 1.x command pipe which can be used to send commands to Icinga. Example: library "compat" object ExternalCommandListener "external" { command_path = "/var/run/icinga2/cmd/icinga2.cmd" } Attributes: Name |Description ----------------|---------------- command\_path |**Optional.** Path to the command pipe. Defaults to RunDir + "/icinga2/cmd/icinga2.cmd". ### CompatLogger Writes log files in a format that's compatible with Icinga 1.x. Example: library "compat" object CompatLogger "my-log" { log_dir = "/var/log/icinga2/compat" rotation_method = "HOURLY" } Attributes: Name |Description ----------------|---------------- log\_dir |**Optional.** Path to the compat log directory. Defaults to LocalStateDir + "/log/icinga2/compat". rotation\_method|**Optional.** Specifies when to rotate log files. Can be one of "HOURLY", "DAILY", "WEEKLY" or "MONTHLY". Defaults to "HOURLY". ### CheckResultReader Reads Icinga 1.x check results from a directory. This functionality is provided to help existing Icinga 1.x users and might be useful for certain cluster scenarios. Example: library "compat" object CheckResultReader "reader" { spool_dir = "/data/check-results" } Attributes: Name |Description ----------------|---------------- spool\_dir |**Optional.** The directory which contains the check result files. Defaults to LocalStateDir + "/lib/icinga2/spool/checkresults/". ### CheckerComponent The checker component is responsible for scheduling active checks. There are no configurable options. Example: library "checker" object CheckerComponent "checker" { } Can be enabled/disabled using # icinga2 feature enable checker ### NotificationComponent The notification component is responsible for sending notifications. There are no configurable options. Example: library "notification" object NotificationComponent "notification" { } Attributes: Name |Description ----------------|---------------- enable_ha |**Optional.** Enable the high availability functionality. Only valid in a [cluster setup](#high-availability). Defaults to "true". Can be enabled/disabled using # icinga2 feature enable notification ### FileLogger Specifies Icinga 2 logging to a file. Example: object FileLogger "debug-file" { severity = "debug" path = "/var/log/icinga2/debug.log" } Attributes: Name |Description ----------------|---------------- path |**Required.** The log path. severity |**Optional.** The minimum severity for this log. Can be "debug", "notice", "information", "warning" or "critical". Defaults to "information". ### SyslogLogger Specifies Icinga 2 logging to syslog. Example: object SyslogLogger "crit-syslog" { severity = "critical" } Attributes: Name |Description ----------------|---------------- severity |**Optional.** The minimum severity for this log. Can be "debug", "notice", "information", "notice", "warning" or "critical". Defaults to "warning". ### IcingaStatusWriter The IcingaStatusWriter feature periodically dumps the current status and performance data from Icinga 2 and all registered features into a defined JSON file. Example: object IcingaStatusWriter "status" { status_path = LocalStateDir + "/cache/icinga2/status.json" update_interval = 15s } Attributes: Name |Description --------------------------|-------------------------- status\_path |**Optional.** Path to cluster status file. Defaults to LocalStateDir + "/cache/icinga2/status.json" update\_interval |**Optional.** The interval in which the status files are updated. Defaults to 15 seconds. ### ApiListener ApiListener objects are used for distributed monitoring setups specifying the certificate files used for ssl authorization. The `NodeName` constant must be defined in [constants.conf](#constants-conf). Example: object ApiListener "api" { cert_path = SysconfDir + "/icinga2/pki/" + NodeName + ".crt" key_path = SysconfDir + "/icinga2/pki/" + NodeName + ".key" ca_path = SysconfDir + "/icinga2/pki/ca.crt" } Attributes: Name |Description --------------------------|-------------------------- cert\_path |**Required.** Path to the public key. key\_path |**Required.** Path to the private key. ca\_path |**Required.** Path to the CA certificate file. crl\_path |**Optional.** Path to the CRL file. bind\_host |**Optional.** The IP address the api listener should be bound to. Defaults to `0.0.0.0`. bind\_port |**Optional.** The port the api listener should be bound to. Defaults to `5665`. accept\_config |**Optional.** Accept zone configuration. Defaults to `false`. accept\_commands |**Optional.** Accept remote commands. Defaults to `false`. ### Endpoint Endpoint objects are used to specify connection information for remote Icinga 2 instances. Example: object Endpoint "icinga2b" { host = "192.168.5.46" port = 5665 } Attributes: Name |Description ----------------|---------------- host |**Required.** The hostname/IP address of the remote Icinga 2 instance. port |**Optional.** The service name/port of the remote Icinga 2 instance. Defaults to `5665`. log_duration |**Optional.** Duration for keeping replay logs on connection loss. Defaults to `1d`. ### Zone Zone objects are used to specify which Icinga 2 instances are located in a zone. All zone endpoints elect one active master instance among them (required for High-Availability setups). Example: object Zone "config-ha-master" { endpoints = [ "icinga2a", "icinga2b" ] } object Zone "check-satellite" { endpoints = [ "icinga2c" ] parent = "config-ha-master" } Attributes: Name |Description ----------------|---------------- endpoints |**Optional.** Dictionary with endpoints located in this zone. parent |**Optional.** Parent zone. ## Icinga Template Library ### Overview The Icinga Template Library (ITL) implements standard templates and object definitions for commonly used services. You can include the ITL by using the `include` directive in your configuration file: include ### Generic Templates These templates are imported by the provided example configuration. #### plugin-check-command Command template for check plugins executed by Icinga 2. The `plugin-check-command` command does not support any vars. #### plugin-notification-command Command template for notification scripts executed by Icinga 2. The `plugin-notification-command` command does not support any vars. #### plugin-event-command Command template for event handler scripts executed by Icinga 2. The `plugin-event-command` command does not support any vars. ### Check Commands These check commands are embedded into Icinga 2 and do not require any external plugin scripts. #### icinga Check command for the built-in `icinga` check. This check returns performance data for the current Icinga instance. The `icinga` check command does not support any vars. #### cluster Check command for the built-in `cluster` check. This check returns performance data for the current Icinga instance and connected endpoints. The `cluster` check command does not support any vars. #### cluster-zone Check command for the built-in `cluster-zone` check. Cluster Attributes: Name | Description -------------|--------------- cluster_zone | **Optional.** The zone name. Defaults to "$host.name$". ## Plugin Check Commands ### Overview The Plugin Check Commands provides example configuration for plugin check commands provided by the Monitoring Plugins project. You can include the plugin check command definitions by using the `include` directive in your configuration file: include The plugin check commands assume that there's a global constant named `PluginDir` which contains the path of the plugins from the Monitoring Plugins project. #### ping4 Check command object for the `check_ping` plugin. Custom Attributes: Name | Description ----------------|-------------- ping_address | **Optional.** The host's IPv4 address. Defaults to "$address$". ping_wrta | **Optional.** The RTA warning threshold in milliseconds. Defaults to 100. ping_wpl | **Optional.** The packet loss warning threshold in %. Defaults to 5. ping_crta | **Optional.** The RTA critical threshold in milliseconds. Defaults to 200. ping_cpl | **Optional.** The packet loss critical threshold in %. Defaults to 15. ping_packets | **Optional.** The number of packets to send. Defaults to 5. ping_timeout | **Optional.** The plugin timeout in seconds. Defaults to 0 (no timeout). #### ping6 Check command object for the `check_ping` plugin. Custom Attributes: Name | Description ----------------|-------------- ping_address | **Optional.** The host's IPv6 address. Defaults to "$address6$". ping_wrta | **Optional.** The RTA warning threshold in milliseconds. Defaults to 100. ping_wpl | **Optional.** The packet loss warning threshold in %. Defaults to 5. ping_crta | **Optional.** The RTA critical threshold in milliseconds. Defaults to 200. ping_cpl | **Optional.** The packet loss critical threshold in %. Defaults to 15. ping_packets | **Optional.** The number of packets to send. Defaults to 5. ping_timeout | **Optional.** The plugin timeout in seconds. Defaults to 0 (no timeout). #### hostalive Check command object for the `check_ping` plugin with host check default values. Custom Attributes: Name | Description ----------------|-------------- ping_address | **Optional.** The host's IPv4 address. Defaults to "$address$". ping_wrta | **Optional.** The RTA warning threshold in milliseconds. Defaults to 3000. ping_wpl | **Optional.** The packet loss warning threshold in %. Defaults to 80. ping_crta | **Optional.** The RTA critical threshold in milliseconds. Defaults to 5000. ping_cpl | **Optional.** The packet loss critical threshold in %. Defaults to 100. ping_packets | **Optional.** The number of packets to send. Defaults to 5. ping_timeout | **Optional.** The plugin timeout in seconds. Defaults to 0 (no timeout). #### fping4 Check command object for the `check_fping` plugin. Custom Attributes: Name | Description ----------------|-------------- fping_address | **Optional.** The host's IPv4 address. Defaults to "$address$". fping_wrta | **Optional.** The RTA warning threshold in milliseconds. Defaults to 100. fping_wpl | **Optional.** The packet loss warning threshold in %. Defaults to 5. fping_crta | **Optional.** The RTA critical threshold in milliseconds. Defaults to 200. fping_cpl | **Optional.** The packet loss critical threshold in %. Defaults to 15. fping_number | **Optional.** The number of packets to send. Defaults to 5. fping_interval | **Optional.** The interval between packets in milli-seconds. Defaults to 500. fping_bytes | **Optional.** The size of ICMP packet. fping_target_timeout | **Optional.** The target timeout in milli-seconds. fping_source_ip | **Optional.** The name or ip address of the source ip. fping_source_interface | **Optional.** The source interface name. #### fping6 Check command object for the `check_fping` plugin. Custom Attributes: Name | Description ----------------|-------------- fping_address | **Optional.** The host's IPv6 address. Defaults to "$address6$". fping_wrta | **Optional.** The RTA warning threshold in milliseconds. Defaults to 100. fping_wpl | **Optional.** The packet loss warning threshold in %. Defaults to 5. fping_crta | **Optional.** The RTA critical threshold in milliseconds. Defaults to 200. fping_cpl | **Optional.** The packet loss critical threshold in %. Defaults to 15. fping_number | **Optional.** The number of packets to send. Defaults to 5. fping_interval | **Optional.** The interval between packets in milli-seconds. Defaults to 500. fping_bytes | **Optional.** The size of ICMP packet. fping_target_timeout | **Optional.** The target timeout in milli-seconds. fping_source_ip | **Optional.** The name or ip address of the source ip. fping_source_interface | **Optional.** The source interface name. #### dummy Check command object for the `check_dummy` plugin. Custom Attributes: Name | Description ----------------|-------------- dummy_state | **Optional.** The state. Can be one of 0 (ok), 1 (warning), 2 (critical) and 3 (unknown). Defaults to 0. dummy_text | **Optional.** Plugin output. Defaults to "Check was successful.". #### passive Specialised check command object for passive checks executing the `check_dummy` plugin with appropriate default values. Custom Attributes: Name | Description ----------------|-------------- dummy_state | **Optional.** The state. Can be one of 0 (ok), 1 (warning), 2 (critical) and 3 (unknown). Defaults to 3. dummy_text | **Optional.** Plugin output. Defaults to "No Passive Check Result Received.". #### tcp Check command object for the `check_tcp` plugin. Custom Attributes: Name | Description ----------------|-------------- tcp_address | **Optional.** The host's address. Defaults to "$address$". tcp_port | **Required.** The port that should be checked. #### ssl Check command object for the `check_tcp` plugin, using ssl-related options. Custom Attributes: Name | Description ------------------------------|-------------- ssl_address | **Optional.** The host's address. Defaults to "$address$". ssl_port | **Required.** The port that should be checked. ssl_timeout | **Optional.** Timeout in seconds for the connect and handshake. The plugin default is 10 seconds. ssl_cert_valid_days_warn | **Optional.** Warning threshold for days before the certificate will expire. When used, ssl_cert_valid_days_critical must also be set. ssl_cert_valid_days_critical | **Optional.** Critical threshold for days before the certificate will expire. When used, ssl_cert_valid_days_warn must also be set. #### udp Check command object for the `check_udp` plugin. Custom Attributes: Name | Description ----------------|-------------- udp_address | **Optional.** The host's address. Defaults to "$address$". udp_port | **Required.** The port that should be checked. #### http Check command object for the `check_http` plugin. Custom Attributes: Name | Description -------------------------|-------------- http_address | **Optional.** The host's address. Defaults to "$address". http_vhost | **Optional.** The virtual host that should be sent in the "Host" header. http_uri | **Optional.** The request URI. http_port | **Optional.** The TCP port. Defaults to 80 when not using SSL, 443 otherwise. http_ssl | **Optional.** Whether to use SSL. Defaults to false. http_sni | **Optional.** Whether to use SNI. Defaults to false. http_auth_pair | **Optional.** Add 'username:password' authorization pair. http_proxy_auth_pair | **Optional.** Add 'username:password' authorization pair for proxy. http_ignore_body | **Optional.** Don't download the body, just the headers. http_linespan | **Optional.** Allow regex to span newline. http_expect_body_regex | **Optional.** A regular expression which the body must match against. Incompatible with http_ignore_body. http_expect_body_eregi | **Optional.** A case-insensitive expression which the body must match against. Incompatible with http_ignore_body. http_invertregex | **Optional.** Changes behaviour of http_expect_body_regex and http_expect_body_eregi to return CRITICAL if found, OK if not. 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. Port defaults to 443. 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. http_string | **Optional.** String to expect in the content. http_post | **Optional.** URL encoded http POST data. http_method | **Optional.** Set http method (for example: HEAD, OPTIONS, TRACE, PUT, DELETE). http_maxage | **Optional.** Warn if document is more than seconds old. http_contenttype | **Optional.** Specify Content-Type header when POSTing. http_useragent | **Optional.** String to be sent in http header as User Agent. http_header | **Optional.** Any other tags to be sent in http header. http_extendedperfdata | **Optional.** Print additional perfdata. Defaults to "false". http_onredirect | **Optional.** How to handle redirect pages. Possible values: "ok" (default), "warning", "critical", "follow", "sticky" (like follow but stick to address), "stickyport" (like sticky but also to port) http_pagesize | **Optional.** Minimum page size required:Maximum page size required. http_timeout | **Optional.** Seconds before connection times out. #### ftp Check command object for the `check_ftp` plugin. Custom Attributes: Name | Description -------------------|-------------- ftp_address | **Optional.** The host's address. Defaults to "$address$". #### smtp Check command object for the `check_smtp` plugin. Custom Attributes: Name | Description ---------------------|-------------- smtp_address | **Optional.** The host's address. Defaults to "$address$". smtp_port | **Optional.** The port that should be checked. Defaults to 25. smtp_mail_from | **Optional.** Test a MAIL FROM command with the given email address. #### ssmtp Check command object for the `check_ssmtp` plugin. Custom Attributes: Name | Description ----------------|-------------- ssmtp_address | **Required.** The host's address. Defaults to "$address$". ssmtp_port | **Optional.** The port that should be checked. Defaults to 465. ssmtp_mail_from | **Optional.** Test a MAIL FROM command with the given email address. #### imap Check command object for the `check_imap` plugin. Custom Attributes: Name | Description ----------------|-------------- imap_address | **Optional.** The host's address. Defaults to "$address$". imap_port | **Optional.** The port that should be checked. Defaults to 143. #### simap Check command object for the `check_simap` plugin. Custom Attributes: Name | Description ----------------|-------------- simap_address | **Optional.** The host's address. Defaults to "$address$". simap_port | **Optional.** The host's port. #### pop Check command object for the `check_pop` plugin. Custom Attributes: Name | Description ----------------|-------------- pop_address | **Optional.** The host's address. Defaults to "$address$". pop_port | **Optional.** The port that should be checked. Defaults to 110. #### spop Check command object for the `check_spop` plugin. Custom Attributes: Name | Description ----------------|-------------- spop_address | **Optional.** The host's address. Defaults to "$address$". spop_port | **Optional.** The host's port. #### ntp_time Check command object for the `check_ntp_time` plugin. Custom Attributes: Name | Description ----------------|-------------- ntp_address | **Optional.** The host's address. Defaults to "$address$". #### ssh Check command object for the `check_ssh` plugin. Custom Attributes: Name | Description ----------------|-------------- ssh_address | **Optional.** The host's address. Defaults to "$address$". ssh_port | **Optional.** The port that should be checked. Defaults to 22. ssh_timeout | **Optional.** Seconds before connection times out. Defaults to 10. #### disk Check command object for the `check_disk` plugin. Custom Attributes: Name | Description ------------------------|------------------------ disk_wfree | **Optional.** The free space warning threshold in %. Defaults to 20. disk_cfree | **Optional.** The free space critical threshold in %. Defaults to 10. disk_inode_wfree | **Optional.** The free inode warning threshold. disk_inode_cfree | **Optional.** The free inode critical threshold. disk_partition | **Optional.** The partition. **Deprecated in 2.3.** disk_partition_excluded | **Optional.** The excluded partition. **Deprecated in 2.3.** disk_partitions | **Optional.** The partition(s). Multiple partitions must be defined as array. disk_partitions_excluded | **Optional.** The excluded partition(s). Multiple partitions must be defined as array. #### users Check command object for the `check_users` plugin. Custom Attributes: Name | Description ----------------|-------------- users_wgreater | **Optional.** The user count warning threshold. Defaults to 20. users_cgreater | **Optional.** The user count critical threshold. Defaults to 50. #### procs Check command object for the `check_procs` plugin. Custom Attributes: Name | Description ---------------------|-------------- procs_warning | **Optional.** The process count warning threshold. Defaults to 250. procs_critical | **Optional.** The process count critical threshold. Defaults to 400. procs_metric | **Optional.** Check thresholds against metric. procs_timeout | **Optional.** Seconds before plugin times out. procs_traditional | **Optional.** Filter own process the traditional way by PID instead of /proc/pid/exe. Defaults to "false". procs_state | **Optional.** Only scan for processes that have one or more of the status flags you specify. procs_ppid | **Optional.** Only scan for children of the parent process ID indicated. procs_vsz | **Optional.** Only scan for processes with VSZ higher than indicated. procs_rss | **Optional.** Only scan for processes with RSS higher than indicated. procs_pcpu | **Optional.** Only scan for processes with PCPU higher than indicated. procs_user | **Optional.** Only scan for processes with user name or ID indicated. procs_argument | **Optional.** Only scan for processes with args that contain STRING. procs_argument_regex | **Optional.** Only scan for processes with args that contain the regex STRING. procs_command | **Optional.** Only scan for exact matches of COMMAND (without path). procs_nokthreads | **Optional.** Only scan for non kernel threads. Defaults to "false". #### swap Check command object for the `check_swap` plugin. Custom Attributes: Name | Description ----------------|-------------- swap_wfree | **Optional.** The free swap space warning threshold in %. Defaults to 50. swap_cfree | **Optional.** The free swap space critical threshold in %. Defaults to 25. #### load Check command object for the `check_load` plugin. Custom Attributes: Name | Description ----------------|-------------- load_wload1 | **Optional.** The 1-minute warning threshold. Defaults to 5. load_wload5 | **Optional.** The 5-minute warning threshold. Defaults to 4. load_wload15 | **Optional.** The 15-minute warning threshold. Defaults to 3. load_cload1 | **Optional.** The 1-minute critical threshold. Defaults to 10. load_cload5 | **Optional.** The 5-minute critical threshold. Defaults to 6. load_cload15 | **Optional.** The 15-minute critical threshold. Defaults to 4. #### snmp Check command object for the `check_snmp` plugin. Custom Attributes: Name | Description --------------------|-------------- snmp_address | **Optional.** The host's address. Defaults to "$address$". snmp_oid | **Required.** The SNMP OID. snmp_community | **Optional.** The SNMP community. Defaults to "public". snmp_warn | **Optional.** The warning threshold. snmp_crit | **Optional.** The critical threshold. snmp_string | **Optional.** Return OK state if the string matches exactly with the output value snmp_ereg | **Optional.** Return OK state if extended regular expression REGEX matches with the output value snmp_eregi | **Optional.** Return OK state if case-insensitive extended REGEX matches with the output value snmp_label | **Optional.** Prefix label for output value snmp_invert_search | **Optional.** Invert search result and return CRITICAL state if found snmp_units | **Optional.** Units label(s) for output value (e.g., 'sec.'). #### snmpv3 Check command object for the `check_snmp` plugin, using SNMPv3 authentication and encryption options. Custom Attributes: Name | Description ------------------|-------------- snmpv3_address | **Optional.** The host's address. Defaults to "$address$". snmpv3_user | **Required.** The username to log in with. snmpv3_auth_alg | **Optional.** The authentication algorithm. Defaults to SHA. snmpv3_auth_key | **Required.** The authentication key. snmpv3_priv_alg | **Optional.** The encryption algorithm. Defaults to AES. snmpv3_priv_key | **Required.** The encryption key. snmpv3_oid | **Required.** The SNMP OID. snmpv3_warn | **Optional.** The warning threshold. snmpv3_crit | **Optional.** The critical threshold. snmpv3_label | **Optional.** Prefix label for output value. #### snmp-uptime Check command object for the `check_snmp` plugin. Custom Attributes: Name | Description ----------------|-------------- snmp_address | **Optional.** The host's address. Defaults to "$address$". snmp_oid | **Optional.** The SNMP OID. Defaults to "1.3.6.1.2.1.1.3.0". snmp_community | **Optional.** The SNMP community. Defaults to "public". #### dns Check command object for the `check_dns` plugin. Custom Attributes: Name | Description ---------------------|-------------- dns_lookup | **Optional.** The hostname or IP to query the DNS for. Defaults to $host_name$. dns_server | **Optional.** The DNS server to query. Defaults to the server configured in the OS. dns_expected_answer | **Optional.** The answer to look for. A hostname must end with a dot. **Deprecated in 2.3.** dns_expected_answers | **Optional.** The answer(s) to look for. A hostname must end with a dot. Multiple answers must be defined as array. dns_authoritative | **Optional.** Expect the server to send an authoritative answer. #### dig Check command object for the `check_dig` plugin. Custom Attributes: Name | Description ---------------------|-------------- dig_server | **Optional.** The DNS server to query. Defaults to "127.0.0.1". dig_lookup | **Optional.** The address that should be looked up. #### dhcp Check command object for the `check_dhcp` plugin. Custom Attributes: Name | Description ----------------|-------------- dhcp_serverip | **Optional.** The IP address of the DHCP server which we should get a response from. dhcp_requestedip| **Optional.** The IP address which we should be offered by a DHCP server. dhcp_timeout | **Optional.** The timeout in seconds. dhcp_interface | **Optional.** The interface to use. dhcp_mac | **Optional.** The MAC address to use in the DHCP request. dhcp_unicast | **Optional.** Whether to use unicast requests. Defaults to false. #### nscp Check command object for the `check_nt` plugin. Custom Attributes: Name | Description ----------------|-------------- nscp_address | **Optional.** The host's address. Defaults to "$address$". nscp_port | **Optional.** The NSClient++ port. Defaults to 12489. nscp_password | **Optional.** The NSClient++ password. nscp_variable | **Required.** The variable that should be checked. nscp_params | **Optional.** Parameters for the query. Multiple parameters must be defined as array. nscp_warn | **Optional.** The warning threshold. nscp_crit | **Optional.** The critical threshold. nscp_timeout | **Optional.** The query timeout in seconds. #### by_ssh Check command object for the `check_by_ssh` plugin. Custom Attributes: Name | Description ----------------|-------------- by_ssh_address | **Optional.** The host's address. Defaults to "$address$". by_ssh_port | **Optional.** The SSH port. Defaults to 22. by_ssh_command | **Optional.** The command that should be executed. by_ssh_logname | **Optional.** The SSH username. by_ssh_identity | **Optional.** The SSH identity. by_ssh_quiet | **Optional.** Whether to suppress SSH warnings. Defaults to false. by_ssh_warn | **Optional.** The warning threshold. by_ssh_crit | **Optional.** The critical threshold. by_ssh_timeout | **Optional.** The timeout in seconds. #### ups Check command object for the `check_ups` plugin. Custom Attributes: Name | Description ----------------|-------------- ups_address | **Optional.** The host's address. Defaults to "$address$". ups_name | **Optional.** The UPS name. Defaults to `ups`. #### nrpe Check command object for the `check_nrpe` plugin. Custom Attributes: Name | Description ----------------|-------------- nrpe_address | **Optional.** The host's address. Defaults to "$address$". nrpe_port | **Optional.** The NRPE port. Defaults to 5668. nrpe_command | **Optional.** The command that should be executed. nrpe_no_ssl | **Optional.** Whether to disable SSL or not. Defaults to `false`. nrpe_timeout_unknown | **Optional.** Whether to set timeouts to unknown instead of critical state. Defaults to `false`. nrpe_timeout | **Optional.** The timeout in seconds. nrpe_arguments | **Optional.** Arguments that should be passed to the command. Multiple arguments must be defined as array. #### apt Check command for the `check_apt` plugin. The `apt` check command does not support any vars. #### running_kernel Check command object for the `check_running_kernel` plugin provided by the `nagios-plugins-contrib` package on Debian. The `running_kernel` check command does not support any vars. ## SNMP Manubulon Plugin Check Commands ### Overview The `SNMP Manubulon Plugin Check Commands` provide example configuration for plugin check commands provided by the [SNMP Manubulon project](http://nagios.manubulon.com/index_snmp.html). The SNMP manubulon plugin check commands assume that the global constant named `ManubulonPluginDir` is set to the path where the Manubublon SNMP plugins are installed. You can enable these plugin check commands by adding the following the include directive in your configuration [icinga2.conf](#icinga2-conf) file: include ### Checks by Host Type **N/A** : Not available for this type. **SNMP** : Available for simple SNMP query. **??** : Untested. **Specific** : Script name for platform specific checks. Host type | Interface | storage | load/cpu | mem | process | env | specific ------------------------|------------|----------|-----------|-----|----------|-----|------------------------- Linux | Yes | Yes | Yes | Yes | Yes | No | Windows | Yes | Yes | Yes | Yes | Yes | No | check_snmp_win.pl Cisco router/switch | Yes | N/A | Yes | Yes | N/A | Yes | HP router/switch | Yes | N/A | Yes | Yes | N/A | No | Bluecoat proxy | Yes | SNMP | Yes | SNMP| No | Yes | CheckPoint on SPLAT | Yes | Yes | Yes | Yes | Yes | No | check_snmp_cpfw.pl CheckPoint on Nokia IP | Yes | Yes | Yes | No | ?? | No | check_snmp_vrrp.pl Boostedge | Yes | Yes | Yes | Yes | ?? | No | check_snmp_boostedge.pl AS400 | Yes | Yes | Yes | Yes | No | No | NetsecureOne Netbox | Yes | Yes | Yes | ?? | Yes | No | Radware Linkproof | Yes | N/A | SNMP | SNMP| No | No | check_snmp_linkproof_nhr
check_snmp_vrrp.pl IronPort | Yes | SNMP | SNMP | SNMP| No | Yes | Cisco CSS | Yes | ?? | Yes | Yes | No | ?? | check_snmp_css.pl #### snmp-load Check command object for the [check_snmp_load.pl](http://nagios.manubulon.com/snmp_load.html) plugin. Custom Attributes: Name | Description ------------------------|-------------- snmp_address | **Optional.** The host's address. Defaults to "$address$". snmp_nocrypt | **Optional.** Define SNMP encryption. If set **snmp_v3** needs to be set. Defaults to "false". snmp_community | **Optional.** The SNMP community. Defaults to "public". snmp_port | **Optional.** The SNMP port connection. snmp_v2 | **Optional.** SNMP version to 2c. Defaults to "false". snmp_v3 | **Optional.** SNMP version to 3. Defaults to "false". snmp_login | **Optional.** SNMP version 3 username. Defaults to "snmpuser". snmp_password | **Required.** SNMP version 3 password. No value defined as default. snmp_v3_use_privpass | **Optional.** Define to use SNMP version 3 priv password. Defaults to "false". snmp_authprotocol | **Optional.** SNMP version 3 authentication protocol. Defaults to "md5,des". snmp_privpass | **Required.** SNMP version 3 priv password. No value defined as default. snmp_warn | **Optional.** The warning threshold. Change the `snmp_load_type` var to "netsl" for using 3 values. snmp_crit | **Optional.** The critical threshold. Change the `snmp_load_type` var to "netsl" for using 3 values. snmp_load_type | **Optional.** Load type. Defaults to "stand". Check all available types in the [snmp load](http://nagios.manubulon.com/snmp_load.html) documentation. snmp_perf | **Optional.** Enable perfdata values. Defaults to "true". #### snmp-memory Check command object for the [check_snmp_mem.pl](http://nagios.manubulon.com/snmp_mem.html) plugin. Custom Attributes: Name | Description ------------------------|-------------- snmp_address | **Optional.** The host's address. Defaults to "$address$". snmp_nocrypt | **Optional.** Define SNMP encryption. If set **snmp_v3** needs to be set. Defaults to "false". snmp_community | **Optional.** The SNMP community. Defaults to "public". snmp_port | **Optional.** The SNMP port connection. snmp_v2 | **Optional.** SNMP version to 2c. Defaults to "false". snmp_v3 | **Optional.** SNMP version to 3. Defaults to "false". snmp_login | **Optional.** SNMP version 3 username. Defaults to "snmpuser". snmp_password | **Required.** SNMP version 3 password. No value defined as default. snmp_v3_use_privpass | **Optional.** Define to use SNMP version 3 priv password. Defaults to "false". snmp_authprotocol | **Optional.** SNMP version 3 authentication protocol. Defaults to "md5,des". snmp_privpass | **Required.** SNMP version 3 priv password. No value defined as default. snmp_warn | **Optional.** The warning threshold. snmp_crit | **Optional.** The critical threshold. snmp_perf | **Optional.** Enable perfdata values. Defaults to "true". #### snmp-storage Check command object for the [check_snmp_storage.pl](http://nagios.manubulon.com/snmp_storage.html) plugin. Custom Attributes: Name | Description ------------------------|-------------- snmp_address | **Optional.** The host's address. Defaults to "$address$". snmp_nocrypt | **Optional.** Define SNMP encryption. If set **snmp_v3** needs to be set. Defaults to "false". snmp_community | **Optional.** The SNMP community. Defaults to "public". snmp_port | **Optional.** The SNMP port connection. snmp_v2 | **Optional.** SNMP version to 2c. Defaults to "false". snmp_v3 | **Optional.** SNMP version to 3. Defaults to "false". snmp_login | **Optional.** SNMP version 3 username. Defaults to "snmpuser". snmp_password | **Required.** SNMP version 3 password. No value defined as default. snmp_v3_use_privpass | **Optional.** Define to use SNMP version 3 priv password. Defaults to "false". snmp_authprotocol | **Optional.** SNMP version 3 authentication protocol. Defaults to "md5,des". snmp_privpass | **Required.** SNMP version 3 priv password. No value defined as default. snmp_warn | **Optional.** The warning threshold. 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-interface Check command object for the [check_snmp_int.pl](http://nagios.manubulon.com/snmp_int.html) plugin. Custom Attributes: Name | Description ----------------------------|-------------- snmp_address | **Optional.** The host's address. Defaults to "$address$". snmp_nocrypt | **Optional.** Define SNMP encryption. If set **snmp_v3** needs to be set. Defaults to "false". snmp_community | **Optional.** The SNMP community. Defaults to "public". snmp_port | **Optional.** The SNMP port connection. snmp_v2 | **Optional.** SNMP version to 2c. Defaults to "false". snmp_v3 | **Optional.** SNMP version to 3. Defaults to "false". snmp_login | **Optional.** SNMP version 3 username. Defaults to "snmpuser". snmp_password | **Required.** SNMP version 3 password. No value defined as default. snmp_v3_use_privpass | **Optional.** Define to use SNMP version 3 priv password. Defaults to "false". snmp_authprotocol | **Optional.** SNMP version 3 authentication protocol. Defaults to "md5,des". snmp_privpass | **Required.** SNMP version 3 priv password. No value defined as default. snmp_warn | **Optional.** The warning threshold. snmp_crit | **Optional.** The critical threshold. snmp_interface | **Optional.** Network interface name. Default to regex "eth0". snmp_interface_perf | **Optional.** Check the input/ouput bandwidth of the interface. Defaults to "true". 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_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_megabytes | **Optional.** Make the warning and critical levels in Mbps or MBps. **Depends** on snmp_interface_kbits set to "true". Defaults to "true". snmp_interface_64bit | **Optional.** Use 64 bits counters instead of the standard counters when checking bandwidth & performance data for interface >= 1Gbps. Defaults to "false". snmp_interface_errors | **Optional.** Add error & discard to Perfparse output. Defaults to "true". 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_warncrit_percent | **Optional.** Make the warning and critical levels in % of reported interface speed. If set **snmp_interface_megabytes** needs to be set to "false". Defaults to "false". snmp_perf | **Optional.** Enable perfdata values. Defaults to "true". #### snmp-process Check command object for the [check_snmp_process.pl](http://nagios.manubulon.com/snmp_process.html) plugin. Custom Attributes: Name | Description ------------------------|-------------- snmp_address | **Optional.** The host's address. Defaults to "$address$". snmp_nocrypt | **Optional.** Define SNMP encryption. If set **snmp_v3** needs to be set. Defaults to "false". snmp_community | **Optional.** The SNMP community. Defaults to "public". snmp_port | **Optional.** The SNMP port connection. snmp_v2 | **Optional.** SNMP version to 2c. Defaults to "false". snmp_v3 | **Optional.** SNMP version to 3. Defaults to "false". snmp_login | **Optional.** SNMP version 3 username. Defaults to "snmpuser". snmp_password | **Required.** SNMP version 3 password. No value defined as default. snmp_v3_use_privpass | **Optional.** Define to use SNMP version 3 priv password. Defaults to "false". snmp_authprotocol | **Optional.** SNMP version 3 authentication protocol. Defaults to "md5,des". snmp_privpass | **Required.** SNMP version 3 priv password. No value defined as default.. snmp_warn | **Optional.** The warning threshold. snmp_crit | **Optional.** The critical threshold. snmp_process_name | **Optional.** Name of the process (regexp). No trailing slash!. Defaults to ".*". snmp_perf | **Optional.** Enable perfdata values. Defaults to "true".