]> granicus.if.org Git - icinga2/commitdiff
Revert "Add documentation for the LogstashWriter feature"
authorMichael Friedrich <michael.friedrich@icinga.com>
Tue, 23 May 2017 10:02:32 +0000 (12:02 +0200)
committerMichael Friedrich <michael.friedrich@icinga.com>
Tue, 23 May 2017 10:02:32 +0000 (12:02 +0200)
This reverts commit 71d5ee7d419b937fb471477fe0d725277f285bfc.

refs #4054

doc/14-features.md
doc/9-object-types.md

index 51584b44ea5d098a2b0416cc554ce430e7d2c4f6..88ec898543c39afdc7d20d9ebbb495eafa0a9af2 100644 (file)
@@ -369,82 +369,6 @@ More integrations in development:
 * [Logstash output](https://github.com/Icinga/logstash-output-icinga) for the Icinga 2 API.
 * [Logstash Grok Pattern](https://github.com/Icinga/logstash-grok-pattern) for Icinga 2 logs.
 
-#### <a id="logstash-writer"></a> Logstash Writer
-
-[Logstash](https://www.elastic.co/products/logstash) receives
-and processes event messages sent by Icinga 2 and the [LogstashWriter](9-object-types.md#objecttype-logstashwriter)
-feature. As part of the Elastic Stack it allows you to
-process and modify the messages and forward them to [Elasticsearch](https://www.elastic.co/products/elasticsearch)
-as backed.
-
-Before proceeding with this integration guide please ensure
-that you have Logstash, Elasticsearch and Kibana up and running
-as part of the Elastic Stack.
-
-> **Note**
->
-> The LogstashWriter feature has been tested with Elastic Stack 5.x and therefore Logstash 5.x.
-> Older versions are not supported.
-
-Logstash supports `TCP` and `UDP` as input socket type. You must
-further enable JSON support for input data processing. Logstash 5.x
-comes without any pre-installed plugins and requires you to install
-them separately.
-
-Example on CentOS 7 and UDP as socket type:
-
-```
-/usr/share/logstash/bin/logstash-plugin install logstash-input-udp
-/usr/share/logstash/bin/logstash-plugin install logstash-codec-json
-```
-
-Add the Icinga 2 input and set the output to your running Elasticsearch instance.
-You do not need to reload Logstash since version 5.x supports configuration changes
-without restart.
-
-This example uses port `5555`. You are allowed to use any available port (note it for later).
-
-```
-# vim /etc/logstash/conf.d/icinga2.conf
-
-input {
-  udp {
-    port => 5555
-    codec => "json"
-  }
-}
-output {
-  elasticsearch {
-    hosts => [ "localhost:9200" ]
-  }
-}
-```
-
-Modify the feature configuration and set the
-socket type, host and port attributes. The port must be the same
-as configured in your Logstash input, e.g. `5555`.
-
-```
-# vim /etc/icinga2/features-available/logstash.conf
-
-object LogstashWriter "logstash" {
-  host = "192.168.33.7"
-  port = 5555
-  socket_type = "udp"
-}
-```
-
-Enable the feature and restart Icinga 2.
-
-```
-# icinga2 feature enable logstash
-# systemctl restart icinga2
-```
-
-Open [Kibana](https://www.elastic.co/products/kibana) or your
-favorite Elasticsearch frontend and visualize the messages received
-from Icinga 2.
-
 ### <a id="opentsdb-writer"></a> OpenTSDB Writer
 
 While there are some OpenTSDB collector scripts and daemons like tcollector available for
index d7b53b444772f5608f371af1d82db6b3aa8e4dda..1a8e1123edad5fcf99dc6ce7fc938ab9153d199c 100644 (file)
@@ -1006,31 +1006,6 @@ Configuration Attributes:
 >
 > UNIX sockets are not supported on Windows.
 
-## <a id="objecttype-logstashwriter"></a> LogstashWriter
-
-Writes Icinga 2 event messages to [Logstash](14-features.md#logstash-writer).
-
-Example:
-
-```
-library "perfdata"
-
-object LogstashWriter "logstash" {
-  host = "192.168.33.7"
-  port = 5555
-  socket_type = "udp"
-}
-```
-
-Configuration Attributes:
-
-  Name                 |Description
-  ----------------------|----------------------
-  host                 |**Optional.** Logstash receiver host address. Defaults to `127.0.0.1`.
-  port                 |**Optional.** Logstash receiver port. Defaults to `9201`.
-  socket_type          |**Optional.** Socket type. Can be either `udp` or `tcp`. Defaults to `udp`.
-  source               |**Optional.** Source name for this instance. Defaults to `icinga2`.
-
 
 ## <a id="objecttype-notification"></a> Notification