Adding upstream version 2.1.0.upstream/2.1.0upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 25 insertions, 0 deletions

diff --git a/doc/03-Configuration.md b/doc/03-Configuration.md
new file mode 100644
index 0000000..84e915c
--- /dev/null
+++ b/doc/03-Configuration.md
@@ -0,0 +1,25 @@
+# Configuration
+
+After enabling `generictts`,
+you can access its configuration in Icinga Web via the module's configuration tab.
+But you can also change its configuration manually.
+`generictts` maintains a configuration file that is normally located under the following path:
+
+```
+/etc/icingaweb2/modules/generictts/config.ini
+```
+
+## Example Configuration
+
+You need to understand regular expressions for the configuration.
+A pattern has to be specified that captures a ticket reference for use in a link to your ticket system.
+
+In the following example, every time we encounter an acknowledgement, downtime, or comment
+that contains a hash `#` followed by digits, that number is stored in the capturing group `$1`
+and replaced with a link that references that specific ticket in your ticket system.
+
+```ini
+[my-ticket-system]
+pattern = "/#([0-9]+)/"
+url = "https://my.ticket.system/tickets/id=$1"
+```