From 9f39660f50004ca7c49ea171e2a6f199487cd667 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 14 Apr 2024 15:18:42 +0200 Subject: Adding upstream version 1.3.0. Signed-off-by: Daniel Baumann --- doc/02-Configuration.md | 53 +++++++++++++++++++++++++++ doc/03-CustomVars.md | 50 +++++++++++++++++++++++++ doc/09-Security.md | 26 +++++++++++++ doc/10-Screenshots.md | 24 ++++++++++++ doc/screenshots/configuration-backend.png | Bin 0 -> 14171 bytes doc/screenshots/configuration-monitoring.png | Bin 0 -> 20968 bytes doc/screenshots/monitoring-actions.png | Bin 0 -> 26487 bytes doc/screenshots/monitoring-detailview.png | Bin 0 -> 70118 bytes doc/screenshots/overview-filtered.png | Bin 0 -> 122651 bytes doc/screenshots/overview-with-details.png | Bin 0 -> 166770 bytes doc/screenshots/overview.png | Bin 0 -> 149458 bytes 11 files changed, 153 insertions(+) create mode 100644 doc/02-Configuration.md create mode 100644 doc/03-CustomVars.md create mode 100644 doc/09-Security.md create mode 100644 doc/10-Screenshots.md create mode 100644 doc/screenshots/configuration-backend.png create mode 100644 doc/screenshots/configuration-monitoring.png create mode 100644 doc/screenshots/monitoring-actions.png create mode 100644 doc/screenshots/monitoring-detailview.png create mode 100644 doc/screenshots/overview-filtered.png create mode 100644 doc/screenshots/overview-with-details.png create mode 100644 doc/screenshots/overview.png (limited to 'doc') diff --git a/doc/02-Configuration.md b/doc/02-Configuration.md new file mode 100644 index 0000000..0f6b04e --- /dev/null +++ b/doc/02-Configuration.md @@ -0,0 +1,53 @@ +Configuration +============= + +## Database Resource + +To let the module know where the events are stored you have to create an SQL +database resource, with the EventDB schema, and events collected by EventDB. + +Access to the EventDB for the module is handled with normal Icingaweb2 resources. + +Create the resource and go to the config area to select it: + + Configuration -> Modules -> Eventdb -> Backend + +![Configuration Backend](screenshots/configuration-backend.png) + +## Monitoring Integration + +The EventDB module integrates into Icinga Web 2's monitoring module by default, +offering action links in host and service detail views. + +![Configuration Monitoring](screenshots/configuration-monitoring.png) + +### Default actions + +By default, every host and services shows an action link to the event list, +filtered by host name. + +### Custom Variable + +You can configure a custom variable that enables the integration selectively. + +* `_edb` or `vars.edb` will enable the actions only on objects that have the custom var +* `_edb_filter` or `vars.edb_filter` allows you to pre-filter the linked events + +The name of the customvar (`edb`) needs to be configured in the config area of the module. + +Also see [Custom Variables](03-CustomVars.md) documentation. + +### Always show actions + +There are options to always show actions on host or service, even if the custom variable +is not set. + +### Detail view + +Icingaweb adds a new feature in 2.5.0 to allow extra content inside the detail views +of hosts and services. + +By default the view filters for not acknowledged events, and shows you the last, most +critical events first. One can jump to events list or a detail view immediately. + +Custom filters can be added in the config area, also the view can be disabled there. \ No newline at end of file diff --git a/doc/03-CustomVars.md b/doc/03-CustomVars.md new file mode 100644 index 0000000..cfd4b74 --- /dev/null +++ b/doc/03-CustomVars.md @@ -0,0 +1,50 @@ +Custom Variables +================ + +The monitoring integration of this module can use custom variables from the +Icinga context to control display and filtering of the integration. + +Also see [Configuration](02-Configuration.md) on how to configure the features. + +Custom variables control: + +* If the EventDB integration and actions are shown for a host or service +* How the linked results should be filtered + +## Examples + +For Icinga 2: + +```icinga2 +object Host "test" { + import "generic-host" + + address = "127.0.0.1" + + vars.edb = "1" + vars.edb_filter = "priority!=7&priority!=5&priority!=6&ack=0" + // ... +} +``` + +For Icinga 1.x: + +```nagios +define host { + use generic-host + host_name test + + address 127.0.0.1 + + _edb 1 + _edb_filter priority!=7&priority!=5&priority!=6&ack=0 +} +``` + +**Note:** A filter by `host_name` will always be added, unless you have `host_name` as part of your filter. + +## Legacy filters + +The module also supports legacy JSON filters from the icinga-web 1.x EventDB module. + +Please see the `examples` directory of this module for some supported filters. diff --git a/doc/09-Security.md b/doc/09-Security.md new file mode 100644 index 0000000..9aab433 --- /dev/null +++ b/doc/09-Security.md @@ -0,0 +1,26 @@ +Security +============================ + +The EventDB Module provides permissions and restrictions as described below. + +## Permissions + +| Name | Description | +| ---------------- | ----------- | +| eventdb/events | Allow to view events | +| eventdb/comments | Allow to view comments | +| eventdb/interact | Allow to acknowledge and comment events | + +## Restrictions + +| Name | Description | +| ----------------------- | ----------- | +| eventdb/events/filter | Restrict views to the events that match the filter | +| eventdb/comments/filter | Restrict views to the comments that match the filter | + +## Examples + +| eventdb/events/filter | Description | +| -------------------------- | ----------- | +| type!=syslog | Hide the Syslog events from a role | +| type=syslog&program=icinga | Show only Icinga-related Syslog events to a role | diff --git a/doc/10-Screenshots.md b/doc/10-Screenshots.md new file mode 100644 index 0000000..22905d3 --- /dev/null +++ b/doc/10-Screenshots.md @@ -0,0 +1,24 @@ +Screenshots +=========== + +**Overview of Events** + +![Screenshot](screenshots/overview.png) + +**Filtered overview** + +![Screenshot](screenshots/overview-filtered.png) + +**Detail area** + +![Screenshot](screenshots/overview-with-details.png) + +**Monitoring actions** + +![Screenshot](screenshots/monitoring-actions.png) + +**Monitoring detail view** + +For Icinga Web 2 >= 2.5.0 + +![Screenshot](screenshots/monitoring-detailview.png) \ No newline at end of file diff --git a/doc/screenshots/configuration-backend.png b/doc/screenshots/configuration-backend.png new file mode 100644 index 0000000..6de9fba Binary files /dev/null and b/doc/screenshots/configuration-backend.png differ diff --git a/doc/screenshots/configuration-monitoring.png b/doc/screenshots/configuration-monitoring.png new file mode 100644 index 0000000..d6c9e8d Binary files /dev/null and b/doc/screenshots/configuration-monitoring.png differ diff --git a/doc/screenshots/monitoring-actions.png b/doc/screenshots/monitoring-actions.png new file mode 100644 index 0000000..724e0a0 Binary files /dev/null and b/doc/screenshots/monitoring-actions.png differ diff --git a/doc/screenshots/monitoring-detailview.png b/doc/screenshots/monitoring-detailview.png new file mode 100644 index 0000000..e7ceb83 Binary files /dev/null and b/doc/screenshots/monitoring-detailview.png differ diff --git a/doc/screenshots/overview-filtered.png b/doc/screenshots/overview-filtered.png new file mode 100644 index 0000000..d183cd8 Binary files /dev/null and b/doc/screenshots/overview-filtered.png differ diff --git a/doc/screenshots/overview-with-details.png b/doc/screenshots/overview-with-details.png new file mode 100644 index 0000000..53a6008 Binary files /dev/null and b/doc/screenshots/overview-with-details.png differ diff --git a/doc/screenshots/overview.png b/doc/screenshots/overview.png new file mode 100644 index 0000000..99cc82d Binary files /dev/null and b/doc/screenshots/overview.png differ -- cgit v1.2.3