Merge pull request #3309 from gcoeugnet/master

Canopsis transport doc and enhancement

doc/Extensions/Alerting.md

@@ -21,6 +21,7 @@ Table of Content:
     - [Clickatell](#transports-clickatell)
     - [PlaySMS](#transports-playsms)
     - [VictorOps](#transports-victorops)
+    - [Canopsis](#transports-canopsis)
 - [Entities](#entities)
     - [Devices](#entity-devices)
     - [BGP Peers](#entity-bgppeers)
@@ -440,6 +441,28 @@ $config['alert']['transports']['victorops']['url'] = 'https://alert.victorops.co
 ```
 ~~
 
+## <a name="transports-canopsis">Canopsis</a>
+
+Canopsis is a hypervision tool. LibreNMS can send alerts to Canopsis which are then converted to canopsis events. To configure the transport, go to:
+
+Global Settings -> Alerting Settings -> Canopsis Transport.
+
+You will need to fill this paramaters :
+
+~~
+```php
+$config['alert']['transports']['canopsis']['host'] = 'www.xxx.yyy.zzz';
+$config['alert']['transports']['canopsis']['port'] = '5672';
+$config['alert']['transports']['canopsis']['user'] = 'admin';
+$config['alert']['transports']['canopsis']['passwd'] = 'my_password';
+$config['alert']['transports']['canopsis']['vhost'] = 'canopsis';
+```
+~~
+
+For more information about canopsis and its events, take a look here :
+ http://www.canopsis.org/
+ http://www.canopsis.org/wp-content/themes/canopsis/doc/sakura/user-guide/event-spec.html
+
 # <a name="entities">Entities
 
 Entities as described earlier are based on the table and column names within the database, if you are unsure of what the entity is you want then have a browse around inside MySQL using `show tables` and `desc <tablename>`.

html/pages/settings/alerting.inc.php

@@ -840,6 +840,7 @@ echo '
             </div>
         </div>';
 $canopsis_host   = get_config_by_name('alert.transports.canopsis.host');
+$canopsis_port   = get_config_by_name('alert.transports.canopsis.port');
 $canopsis_user   = get_config_by_name('alert.transports.canopsis.user');
 $canopsis_passwd = get_config_by_name('alert.transports.canopsis.passwd');
 $canopsis_vhost  = get_config_by_name('alert.transports.canopsis.vhost');
@@ -859,6 +860,13 @@ echo '
                             <span class="glyphicon form-control-feedback" aria-hidden="true"></span>
                         </div>
                     </div>
+                    <div class="form-group has-feedback">
+                        <label for="canopsis_port" class="col-sm-4 control-label">Canopsis Port number </label>
+                        <div class="col-sm-4">
+                            <input id="canopsis_port" class="form-control" type="text" name="global-config-input" value="'.$canopsis_port['config_value'].'" data-config_id="'.$canopsis_port['config_id'].'">
+                            <span class="glyphicon form-control-feedback" aria-hidden="true"></span>
+                        </div>
+                    </div>
                     <div class="form-group has-feedback">
                         <label for="canopsis_user" class="col-sm-4 control-label">User</label>
                         <div class="col-sm-4">

includes/alerts/transport.canopsis.php

@@ -1,8 +1,8 @@
-require_once "./lib/PhpAmqpLib/autoload.php";
+require_once $config['install_dir']."/lib/PhpAmqpLib/autoload.php";
 
 // Configurations
 $host = $opts["host"];
-$port = 5672;
+$port = $opts["port"];
 $user = $opts["user"];
 $pass = $opts["passwd"];
 $vhost = $opts["vhost"];

sql-schema/111.sql

@@ -0,0 +1 @@
+INSERT INTO config VALUES ('','alert.transports.canopsis.port','','','Canopsis Port number','alerting',0, 'transports', 0, 0, 0);