]> granicus.if.org Git - icinga2/commitdiff
Enhance the addon chapter in the docs 6700/head
authorMichael Friedrich <michael.friedrich@icinga.com>
Thu, 18 Oct 2018 08:38:11 +0000 (10:38 +0200)
committerMichael Friedrich <michael.friedrich@icinga.com>
Thu, 18 Oct 2018 08:38:11 +0000 (10:38 +0200)
doc/13-addons.md
doc/images/addons/dashing_icinga2.png [new file with mode: 0644]
doc/images/addons/icingaweb2_businessprocess.png [new file with mode: 0644]
doc/images/addons/icingaweb2_grafana.png [new file with mode: 0644]
doc/images/addons/icingaweb2_graphite.png [new file with mode: 0644]
doc/images/addons/icingaweb2_maps.png [new file with mode: 0644]

index 7c9623c4bb8d4b6e425a0e26e64ebe4a8c308a31..f2b2986d4fc9589d79623272a6d9b537479b2c89 100644 (file)
@@ -2,6 +2,49 @@
 
 ## Graphing <a id="addons-graphing"></a>
 
+### Graphite <a id="addons-graphing-graphite"></a>
+
+[Graphite](https://graphite.readthedocs.org/en/latest/) is a time-series database
+storing collected metrics and making them available through restful apis
+and web interfaces.
+
+Graphite consists of 3 software components:
+
+* carbon -- a Twisted daemon that listens for time-series data
+* whisper -- a simple database library for storing time-series data (similar in design to RRD)
+* graphite webapp -- a Django webapp that renders graphs on-demand using Cairo
+
+You need to install Graphite first, then proceed with configuring it in Icinga 2.
+
+Use the [GraphiteWriter](14-features.md#graphite-carbon-cache-writer) feature
+for sending real-time metrics from Icinga 2 to Graphite.
+
+    # icinga2 feature enable graphite
+
+A popular alternative frontend for Graphite is for example [Grafana](https://grafana.org).
+
+Integration in Icinga Web 2 is possible by installing the official [graphite module](https://icinga.com/docs/graphite/latest/).
+
+![Icinga Web 2 Detail View with Graphite](images/addons/icingaweb2_graphite.png)
+
+
+### InfluxDB <a id="addons-graphing-influxdb"></a>
+
+[InfluxDB](https://influxdb.com) is a time series, metrics, and analytics database.
+It’s written in Go and has no external dependencies.
+
+Use the [InfluxdbWriter](14-features.md#influxdb-writer) feature
+for sending real-time metrics from Icinga 2 to InfluxDB.
+
+    # icinga2 feature enable influxdb
+
+A popular frontend for InfluxDB is for example [Grafana](https://grafana.org).
+
+Integration in Icinga Web 2 is possible by installing the community [Grafana module](https://github.com/Mikesch-mp/icingaweb2-module-grafana).
+
+![Icinga Web 2 Detail View with Grafana](images/addons/icingaweb2_grafana.png)
+
+
 ### PNP <a id="addons-graphing-pnp"></a>
 
 [PNP](https://www.pnp4nagios.org) is a graphing addon.
@@ -33,50 +76,46 @@ More information on [action_url as attribute](13-addons.md#addons-graphing-pnp-a
 and [graph template names](13-addons.md#addons-graphing-pnp-custom-templates).
 
 
-### Graphite <a id="addons-graphing-graphite"></a>
+## Visualization <a id="addons-visualization"></a>
 
-[Graphite](https://graphite.readthedocs.org/en/latest/) is a time-series database
-storing collected metrics and making them available through restful apis
-and web interfaces.
+### Maps <a id="addons-visualization-maps"></a>
 
-Graphite consists of 3 software components:
+This community module displays host objects as markers on openstreetmap in Icinga Web 2.
+It uses the data provided by the monitoring module and as such the [DB IDO](14-features.md#db-ido)
+from Icinga 2.
 
-* carbon -- a Twisted daemon that listens for time-series data
-* whisper -- a simple database library for storing time-series data (similar in design to RRD)
-* graphite webapp -- a Django webapp that renders graphs on-demand using Cairo
+If you configure multiple hosts with the same coordinates, i.e. servers in a datacenter, a clustered view is rendered.
 
-Use the [GraphiteWriter](14-features.md#graphite-carbon-cache-writer) feature
-for sending real-time metrics from Icinga 2 to Graphite.
+Check the  [Map module docs](https://github.com/nbuchwitz/icingaweb2-module-map) for more details on
+installation, configuration and integration.
 
-    # icinga2 feature enable graphite
+![Icinga Web 2 Maps](images/addons/icingaweb2_maps.png)
 
-There are Graphite addons available for collecting the performance data files too (e.g. `Graphios`).
+### Dashing Dashboard <a id="addons-visualization-dashing-dashboard"></a>
 
-A popular alternative frontend for Graphite is for example [Grafana](https://grafana.org).
+The [Icinga 2 dashboard](https://github.com/dnsmichi/dashing-icinga2) is built
+on top of Dashing and uses the [REST API](#icinga2-api) to visualize what's going
+on with your monitoring. It combines several popular widgets and provides development
+instructions for your own implementation.
 
-### InfluxDB <a id="addons-graphing-influxdb"></a>
+The dashboard also allows to embed the [Icinga Web 2](https://icinga.com/products/icinga-web-2/)
+host and service problem lists as Iframe.
 
-[InfluxDB](https://influxdb.com) is a time series, metrics, and analytics database.
-It’s written in Go and has no external dependencies.
+![Dashing dashboard](images/addons/dashing_icinga2.png)
 
-Use the [InfluxdbWriter](14-features.md#influxdb-writer) feature
-for sending real-time metrics from Icinga 2 to InfluxDB.
+### Business Process <a id="addons-business-process"></a>
 
-    # icinga2 feature enable influxdb
+Create top-level views of your applications in a graphical editor.
+Rules express dependencies between existing hosts and services and
+let you alert on application level. Business processes are displayed
+in a tree or list overview and can be added to any dashboard.
 
-A popular frontend for InfluxDB is for example [Grafana](https://grafana.org).
-
-## Visualization <a id="addons-visualization"></a>
-
-### Icinga Reporting <a id="addons-visualization-reporting"></a>
-
-By enabling the [DB IDO](14-features.md#db-ido) feature you can use the
-[Icinga Reporting package](https://icinga.com/docs/icinga1/latest/en/reporting.html).
+![Icinga Web 2 Business Process](images/addons/icingaweb2_businessprocess.png)
 
 ### NagVis <a id="addons-visualization-nagvis"></a>
 
-By using either [Livestatus](14-features.md#setting-up-livestatus) or
-[DB IDO](14-features.md#db-ido) as a backend you can create your own network maps
+By using the [DB IDO](14-features.md#db-ido) feature
+you can create your own network maps
 based on your monitoring configuration and status data using [NagVis](https://www.nagvis.org).
 
 The configuration in nagvis.ini.php should look like this for Livestatus for example:
@@ -87,6 +126,11 @@ The configuration in nagvis.ini.php should look like this for Livestatus for exa
 
 If you are planning an integration into Icinga Web 2, look at [this module](https://github.com/Icinga/icingaweb2-module-nagvis).
 
+### Icinga Reporting <a id="addons-visualization-reporting"></a>
+
+By enabling the [DB IDO](14-features.md#db-ido) feature you can use the
+[Icinga Reporting package](https://icinga.com/docs/icinga1/latest/en/reporting.html).
+
 ### Thruk <a id="addons-visualization-thruk"></a>
 
 [Thruk](https://www.thruk.org) is an alternative web interface which can be used with Icinga 2
diff --git a/doc/images/addons/dashing_icinga2.png b/doc/images/addons/dashing_icinga2.png
new file mode 100644 (file)
index 0000000..d3e0e42
Binary files /dev/null and b/doc/images/addons/dashing_icinga2.png differ
diff --git a/doc/images/addons/icingaweb2_businessprocess.png b/doc/images/addons/icingaweb2_businessprocess.png
new file mode 100644 (file)
index 0000000..7824ded
Binary files /dev/null and b/doc/images/addons/icingaweb2_businessprocess.png differ
diff --git a/doc/images/addons/icingaweb2_grafana.png b/doc/images/addons/icingaweb2_grafana.png
new file mode 100644 (file)
index 0000000..0861543
Binary files /dev/null and b/doc/images/addons/icingaweb2_grafana.png differ
diff --git a/doc/images/addons/icingaweb2_graphite.png b/doc/images/addons/icingaweb2_graphite.png
new file mode 100644 (file)
index 0000000..4147ba5
Binary files /dev/null and b/doc/images/addons/icingaweb2_graphite.png differ
diff --git a/doc/images/addons/icingaweb2_maps.png b/doc/images/addons/icingaweb2_maps.png
new file mode 100644 (file)
index 0000000..5564eda
Binary files /dev/null and b/doc/images/addons/icingaweb2_maps.png differ