From: Michael Friedrich Date: Thu, 18 Oct 2018 08:38:11 +0000 (+0200) Subject: Enhance the addon chapter in the docs X-Git-Tag: v2.10.1~2^2 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=refs%2Fpull%2F6700%2Fhead;p=icinga2 Enhance the addon chapter in the docs --- diff --git a/doc/13-addons.md b/doc/13-addons.md index 7c9623c4b..f2b2986d4 100644 --- a/doc/13-addons.md +++ b/doc/13-addons.md @@ -2,6 +2,49 @@ ## Graphing +### Graphite + +[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 + +[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 [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 +## Visualization -[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 -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 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 +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 - # 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 - -### Icinga Reporting - -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 -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 + +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 [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 index 000000000..d3e0e42d8 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 index 000000000..7824ded5b 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 index 000000000..0861543f4 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 index 000000000..4147ba5f3 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 index 000000000..5564edabe Binary files /dev/null and b/doc/images/addons/icingaweb2_maps.png differ