]> granicus.if.org Git - icinga2/commitdiff
Disable feature HA by default (InfluxDB, Graphite, Gelf, Elasticsearch, OpenTSDB... 7052/head
authorMichael Friedrich <michael.friedrich@icinga.com>
Wed, 27 Mar 2019 14:29:03 +0000 (15:29 +0100)
committerMichael Friedrich <michael.friedrich@icinga.com>
Wed, 27 Mar 2019 14:29:47 +0000 (15:29 +0100)
doc/09-object-types.md
doc/16-upgrading-icinga-2.md
lib/perfdata/elasticsearchwriter.ti
lib/perfdata/gelfwriter.ti
lib/perfdata/graphitewriter.ti
lib/perfdata/influxdbwriter.ti
lib/perfdata/opentsdbwriter.ti
lib/perfdata/perfdatawriter.ti

index e56ebd30919bfc8c7f8d5153d92db816eff76983..0e71df3311432725d32975fb156eb781919fd525 100644 (file)
@@ -520,7 +520,7 @@ Configuration Attributes:
   ca\_path                  | String                | **Optional.** Path to CA certificate to validate the remote host. Requires `enable_tls` set to `true`.
   cert\_path                | String                | **Optional.** Path to host certificate to present to the remote host for mutual verification. Requires `enable_tls` set to `true`.
   key\_path                 | String                | **Optional.** Path to host key to accompany the cert\_path. Requires `enable_tls` set to `true`.
-  enable\_ha                | Boolean               | **Optional.** Enable the high availability functionality. Only valid in a [cluster setup](06-distributed-monitoring.md#distributed-monitoring-high-availability-features). Defaults to `true`.
+  enable\_ha                | Boolean               | **Optional.** Enable the high availability functionality. Only valid in a [cluster setup](06-distributed-monitoring.md#distributed-monitoring-high-availability-features). Defaults to `false`.
 
 Note: If `flush_threshold` is set too low, this will force the feature to flush all data to Elasticsearch too often.
 Experiment with the setting, if you are processing more than 1024 metrics per second or similar.
@@ -659,7 +659,7 @@ Configuration Attributes:
   port                      | Number                | **Optional.** GELF receiver port. Defaults to `12201`.
   source                    | String                | **Optional.** Source name for this instance. Defaults to `icinga2`.
   enable\_send\_perfdata    | Boolean               | **Optional.** Enable performance data for 'CHECK RESULT' events.
-  enable\_ha                | Boolean               | **Optional.** Enable the high availability functionality. Only valid in a [cluster setup](06-distributed-monitoring.md#distributed-monitoring-high-availability-features). Defaults to `true`.
+  enable\_ha                | Boolean               | **Optional.** Enable the high availability functionality. Only valid in a [cluster setup](06-distributed-monitoring.md#distributed-monitoring-high-availability-features). Defaults to `false`.
 
 
 ## GraphiteWriter <a id="objecttype-graphitewriter"></a>
@@ -687,7 +687,7 @@ Configuration Attributes:
   service\_name\_template   | String                | **Optional.** Metric prefix for service name. Defaults to `icinga2.$host.name$.services.$service.name$.$service.check_command$`.
   enable\_send\_thresholds  | Boolean               | **Optional.** Send additional threshold metrics. Defaults to `false`.
   enable\_send\_metadata    | Boolean               | **Optional.** Send additional metadata metrics. Defaults to `false`.
-  enable\_ha                | Boolean               | **Optional.** Enable the high availability functionality. Only valid in a [cluster setup](06-distributed-monitoring.md#distributed-monitoring-high-availability-features). Defaults to `true`.
+  enable\_ha                | Boolean               | **Optional.** Enable the high availability functionality. Only valid in a [cluster setup](06-distributed-monitoring.md#distributed-monitoring-high-availability-features). Defaults to `false`.
 
 Additional usage examples can be found [here](14-features.md#graphite-carbon-cache-writer).
 
@@ -962,7 +962,7 @@ Configuration Attributes:
   table\_prefix             | String                | **Optional.** PostgreSQL database table prefix. Defaults to `icinga_`.
   instance\_name            | String                | **Optional.** Unique identifier for the local Icinga 2 instance. Defaults to `default`.
   instance\_description     | String                | **Optional.** Description for the Icinga 2 instance.
-  enable\_ha                | Boolean               | **Optional.** Enable the high availability functionality. Only valid in a [cluster setup](06-distributed-monitoring.md#distributed-monitoring-high-availability-db-ido). Defaults to "true".
+  enable\_ha                | Boolean               | **Optional.** Enable the high availability functionality. Only valid in a [cluster setup](06-distributed-monitoring.md#distributed-monitoring-high-availability-db-ido). Defaults to `true`.
   failover\_timeout         | Duration              | **Optional.** Set the failover timeout in a [HA cluster](06-distributed-monitoring.md#distributed-monitoring-high-availability-db-ido). Must not be lower than 60s. Defaults to `60s`.
   cleanup                   | Dictionary            | **Optional.** Dictionary with items for historical table cleanup.
   categories                | Array                 | **Optional.** Array of information types that should be written to the database.
@@ -1063,7 +1063,7 @@ Configuration Attributes:
   enable\_send\_metadata    | Boolean               | **Optional.** Whether to send check metadata e.g. states, execution time, latency etc.
   flush\_interval           | Duration              | **Optional.** How long to buffer data points before transferring to InfluxDB. Defaults to `10s`.
   flush\_threshold          | Number                | **Optional.** How many data points to buffer before forcing a transfer to InfluxDB.  Defaults to `1024`.
-  enable\_ha                | Boolean               | **Optional.** Enable the high availability functionality. Only valid in a [cluster setup](06-distributed-monitoring.md#distributed-monitoring-high-availability-features). Defaults to `true`.
+  enable\_ha                | Boolean               | **Optional.** Enable the high availability functionality. Only valid in a [cluster setup](06-distributed-monitoring.md#distributed-monitoring-high-availability-features). Defaults to `false`.
 
 Note: If `flush_threshold` is set too low, this will always force the feature to flush all data
 to InfluxDB. Experiment with the setting, if you are processing more than 1024 metrics per second
@@ -1325,7 +1325,7 @@ Configuration Attributes:
   --------------------------|-----------------------|----------------------------------
   host                     | String                | **Optional.** OpenTSDB host address. Defaults to `127.0.0.1`.
   port                     | Number                | **Optional.** OpenTSDB port. Defaults to `4242`.
-  enable\_ha                | Boolean               | **Optional.** Enable the high availability functionality. Only valid in a [cluster setup](06-distributed-monitoring.md#distributed-monitoring-high-availability-features). Defaults to `true`.
+  enable\_ha                | Boolean               | **Optional.** Enable the high availability functionality. Only valid in a [cluster setup](06-distributed-monitoring.md#distributed-monitoring-high-availability-features). Defaults to `false`.
 
 
 ## PerfdataWriter <a id="objecttype-perfdatawriter"></a>
@@ -1360,7 +1360,7 @@ Configuration Attributes:
   host\_format\_template    | String                | **Optional.** Host Format template for the performance data file. Defaults to a template that's suitable for use with PNP4Nagios.
   service\_format\_template | String                | **Optional.** Service Format template for the performance data file. Defaults to a template that's suitable for use with PNP4Nagios.
   rotation\_interval        | Duration              | **Optional.** Rotation interval for the files specified in `{host,service}_perfdata_path`. Defaults to `30s`.
-  enable\_ha                | Boolean               | **Optional.** Enable the high availability functionality. Only valid in a [cluster setup](06-distributed-monitoring.md#distributed-monitoring-high-availability-features). Defaults to `true`.
+  enable\_ha                | Boolean               | **Optional.** Enable the high availability functionality. Only valid in a [cluster setup](06-distributed-monitoring.md#distributed-monitoring-high-availability-features). Defaults to `false`.
 
 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.
index aebbcf51cbbaa0082b81dbb6608df5d014a27085..a4c407f8ce9873ae86d631afda35e704d5209351 100644 (file)
@@ -15,8 +15,9 @@ v2.11 introduces additional HA functionality similar to the DB IDO feature.
 This enables the feature being active only on one endpoint while the other
 endpoint is paused. When one endpoint is shut down, automatic failover happens.
 
-This feature is turned on by default. If you need one of the features twice,
-please use `enable_ha = false` to restore the old behaviour.
+This feature is turned off by default keeping the current behaviour. If you need
+it active on just one endpoint, set `enable_ha = true` on both endpoints in the
+feature configuration.
 
 This affects the following features:
 
index 7cf604fb94a30455fab6260c85a47f549337834d..725187e40de338b121d4126a7955bea1b86fdfde 100644 (file)
@@ -38,7 +38,7 @@ class ElasticsearchWriter : ConfigObject
                default {{{ return 1024; }}}
        };
        [config] bool enable_ha {
-               default {{{ return true; }}}
+               default {{{ return false; }}}
        };
 };
 
index a24c28e1c93d11ee4239315d957a68c55cdd0f64..1d20cc28e7545a82c67e7febd46e2a2e71711733 100644 (file)
@@ -29,7 +29,7 @@ class GelfWriter : ConfigObject
                default {{{ return true; }}}
        };
        [config] bool enable_ha {
-               default {{{ return true; }}}
+               default {{{ return false; }}}
        };
 };
 
index 94f1b185ca5c164113b9fc1032e4d974401158bf..c8db0673b9674b5a3d72b9e76c5ef8e685608e3a 100644 (file)
@@ -31,7 +31,7 @@ class GraphiteWriter : ConfigObject
                default {{{ return true; }}}
        };
        [config] bool enable_ha {
-               default {{{ return true; }}}
+               default {{{ return false; }}}
        };
 };
 
index 30bc071c6256fdedfe19caad0346081715e12440..377c911badfee408c686465afe42913d03759303 100644 (file)
@@ -72,7 +72,7 @@ class InfluxdbWriter : ConfigObject
                default {{{ return 1024; }}}
        };
        [config] bool enable_ha {
-               default {{{ return true; }}}
+               default {{{ return false; }}}
        };
 };
 
index ac6d132d61d5b4984eadf8270c8c49aab6d2c813..bce6a11b5d70f8f0858aae201089b9f243f6bd32 100644 (file)
@@ -18,7 +18,7 @@ class OpenTsdbWriter : ConfigObject
                default {{{ return "4242"; }}}
        };
        [config] bool enable_ha {
-               default {{{ return true; }}}
+               default {{{ return false; }}}
        };
 };
 
index b0dbb64989dc21c2d43cb8b44fe9aa13bba6671a..d6d99e8d3076e734addc4848fa8baeb4114080df 100644 (file)
@@ -54,7 +54,7 @@ class PerfdataWriter : ConfigObject
                default {{{ return 30; }}}
        };
        [config] bool enable_ha {
-               default {{{ return true; }}}
+               default {{{ return false; }}}
        };
 };