[icinga-checkins] icinga.org: icingaweb2-module-logstash/master: Add README

[git at icinga.org]

Module: icingaweb2-module-logstash
Branch: master
Commit: 67df6e2ea878d502f35fde5c671936217c6ff58a
URL:    https://git.icinga.org/?p=icingaweb2-module-logstash.git;a=commit;h=67df6e2ea878d502f35fde5c671936217c6ff58a

Author: Markus Frosch <markus at lazyfrosch.de>
Date:   Thu Jun 18 18:18:44 2015 +0200

Add README

---

 CONCEPT.md |   40 ++++++++++++++++++++++++++++++++++++++++
 README.md  |   30 ++++++++++++++++++++++++++++++
 2 files changed, 70 insertions(+)

diff --git a/CONCEPT.md b/CONCEPT.md
new file mode 100644
index 0000000..0b68912
--- /dev/null
+++ b/CONCEPT.md
@@ -0,0 +1,40 @@
+Icinga2 Logstash concept
+========================
+
+We want to be able to monitor events.
+
+Events can be quite different, but we want to be able to query for events and alert when they occur.
+
+
+## Icinga2 config
+
+
+``` icinga2
+object CheckCommand "icingaweb2_logstash" {
+    import "plugin-check-command"
+    
+    command = [ '/usr/bin/icingacli', 'logstash', 'check' ]
+    
+    arguments = {
+        "-I" = "$logstash_index$"
+        "-Q" = "$logstash_query$"
+        "-F" = "$logstash_filter$"
+        "-f" = "$logstash_fields$"
+    }
+    
+    vars.logstash_index = "logstash-*"
+}
+```
+
+``` icinga2
+apply Service "apache events" {
+  import "generic-service"
+  
+  check_command = "icingaweb2_logstash"
+  
+  vars.logstash_query = "host:" + host.name
+  vars.logstash_fields = "host,
+
+}
+```
+
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3ae71f4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+Icingaweb2 Logstash Integration
+===============================
+
+This is a very early test module for Icingaweb2, offering Logstash Event integration.
+
+It is planned to have the following features:
+* Event search/display in the web interface
+* CLI check command for Icinga(2)
+* Integration into service details
+* Search configuration coming from icinga2 service.vars
+
+## About
+
+This module was created as part of my consulting work with [NETWAYS](http://www.netways.de).
+
+    Copyright (c) 2015 Markus Frosch <markus at lazyfrosch.de>
+                  2015 NETWAYS GmbH <info at netways.de>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program. If not, see http://www.gnu.org/licenses/