]> granicus.if.org Git - icinga2/commitdiff
Additional documentation fixes for NotificationCommand example.
authorMichael Friedrich <Michael.Friedrich@netways.de>
Wed, 15 Jan 2014 20:04:01 +0000 (21:04 +0100)
committerMichael Friedrich <Michael.Friedrich@netways.de>
Wed, 15 Jan 2014 20:04:01 +0000 (21:04 +0100)
Fixes #5478

doc/3.04-notifications.md
doc/4.3-object-types.md

index 6d2333f2616bf0c2df53a5c2c1dc99b2608a8bf3..0a453d983c537650be8b4f9fe1ac106a3d56a89e 100644 (file)
@@ -56,35 +56,29 @@ your environment.
 There are various macros available at runtime execution of the `NotificationCommand`.
 The example below may or may not fit your needs.
 
-    object NotificationCommand "mail-notification" inherits "plugin-notification-command" {
-      command = [
-        "/usr/bin/printf",
-        "\"%b\"",
-        {{{\"***** Icinga  *****
-    
-        Notification Type: $NOTIFICATIONTYPE$
-    
-        Service: $SERVICEDESC$
-        Host: $HOSTALIAS$
-        Address: $HOSTADDRESS$
-        State: $SERVICESTATE$
-    
-        Date/Time: $LONGDATETIME$
-    
-        Additional Info: $SERVICEOUTPUT$
-    
-        Comment: [$NOTIFICATIONAUTHORNAME$] $NOTIFICATIONCOMMENT$\"}}},
-        "/bin/mail",
-        "-s",
-        "\"$NOTIFICATIONTYPE$ - $HOSTDISPLAYNAME$ - $SERVICEDISPLAYNAME$ is $SERVICESTATE$\"",
-        "$USEREMAIL$"
+    object NotificationCommand "mail-service-notification" inherits "plugin-notification-command" {
+      command = [ (IcingaSysconfDir + "/icinga2/scripts/mail-notification.sh") ],
+
+      export_macros = [
+        "NOTIFICATIONTYPE",
+        "SERVICEDESC",
+        "HOSTALIAS",
+        "HOSTADDRESS",
+        "SERVICESTATE",
+        "LONGDATETIME",
+        "SERVICEOUTPUT",
+        "NOTIFICATIONAUTHORNAME",
+        "NOTIFICATIONCOMMENT",
+        "HOSTDISPLAYNAME",
+        "SERVICEDISPLAYNAME",
+        "USEREMAIL"
       ]
     }
 
-> **Note** 
->  
-> Alternatively you can use the `export_macros` attributes to export all required
-> macros into the environment.
+The command attribute in the `mail-service-notification` command refers to the
+shell script installed into `/etc/icinga2/scripts/mail-notification.sh`.
+The macros specified in the `export_macros` array are exported as environment
+variables and can be used in the notification script.
 
 You can add all shared attributes to a `Notification` template which is inherited
 to the defined notifications. That way you'll save duplicated attributes in each
index cdf06e71dccfc1430eb109dca3af93e4702d469a..9afc49a85524399d16e5ad20bfa73bbffe8d4616 100644 (file)
@@ -418,24 +418,21 @@ A notification command definition.
 Example:
 
     object NotificationCommand "mail-service-notification" inherits "plugin-notification-command" {
-      command = [
-        "/opt/bin/send-mail-notification",
-        "$USEREMAIL$",
-        "$NOTIFICATIONTYPE$ - $HOSTNAME$ - $SERVICEDESC$ - $SERVICESTATE$",
-        {{{***** Icinga  *****
-
-    Notification Type: $NOTIFICATIONTYPE$
-
-    Service: $SERVICEDESC$
-    Host: $HOSTALIAS$
-    Address: $HOSTADDRESS$
-    State: $SERVICESTATE$
-
-    Date/Time: $LONGDATETIME$
-
-    Additional Info: $SERVICEOUTPUT$
-
-    Comment: [$NOTIFICATIONAUTHORNAME$] $NOTIFICATIONCOMMENT$}}}
+      command = [ (IcingaSysconfDir + "/icinga2/scripts/mail-notification.sh") ],
+
+      export_macros = [
+        "NOTIFICATIONTYPE",
+        "SERVICEDESC",
+        "HOSTALIAS",
+        "HOSTADDRESS",
+        "SERVICESTATE",
+        "LONGDATETIME",
+        "SERVICEOUTPUT",
+        "NOTIFICATIONAUTHORNAME",
+        "NOTIFICATIONCOMMENT",
+        "HOSTDISPLAYNAME",
+        "SERVICEDISPLAYNAME",
+        "USEREMAIL"
       ]
     }