Skip to main content

Gorgone Restapi


Gorgone daemon is a lightweight, distributed, modular tasks handler (

Monitoring Connector assets​

Monitored objects​

  • Events
  • Nodes

Monitored metrics​

Metric nameDescription instances. e.g. internal external. Number of events on a path instances. e.g. internal~pong, internal~command, ... Number of a specific event


Gorgone configuration​

To use this Monitoring Connector, you must enable Gorgone module httpserver:

- name: httpserver
package: "gorgone::modules::core::httpserver::hooks"
enable: true
address: ""
port: "8085"
ssl: false
enabled: false
enabled: true


  1. Install the Centreon package on every Centreon poller expected to monitor Gorgone ressources:
yum install centreon-plugin-Applications-Gorgone-Restapi
  1. On the Centreon Web interface, install the 'Gorgone Rest API' Centreon Monitoring Connector on the Configuration > Monitoring Connector Manager page


  • Log into Centreon and add a new Host through "Configuration > Hosts".
  • Apply the template App-Gorgone-Restapi-custom and configure all the Macros :
XGORGONEAPIPORTPort used. Default is 8085
XGORGONEAPIPROTOProtocol used. Default is http
GORGONEAPIUSERNAMEUsername to access to the API.
GORGONEAPIPASSWORDPassword to access to the API.
GORGONEAPIEXTRAOPTIONSAny extra option you may want to add to the command (eg. a --verbose flag)


How do I test my configuration through the CLI and what do the main parameters stand for ?​

Once the Centreon plugin installed, you can test it logging with the centreon-engine user:

/usr/lib/centreon/plugins/ \
--plugin=apps::gorgone::restapi::plugin \
--mode=events \
--hostname='' \
--port='8085' \
--proto='http' \

The command above checks Gorgone events. If you have configured the basic authentification in Gorgone configuration. You could use an API username (--api-username='John.doe') and API password (--api-password='6fbadZEJbsLG').

Expected command output is shown below:

OK: All paths are ok | ''=0;;;0; ''=12;;;0; ''=0;;;0; ''=0;;;0; ''=0;;;0; ''=0;;;0; ''=1;;;0; ''=0;;;0; ''=0;;;0; ''=0;;;0; ''=0;;;0; ''=1;;;0; ''=0;;;0; ''=0;;;0; ''=0;;;0; ''=6;;;0; ''=0;;;0; ''=0;;;0; ''=0;;;0; ''=0;;;0; ''=4;;;0; ''=0;;;0;
checking path 'external'
total events: 0
checking path 'internal'
total events: 12
event 'actionready' total: 0

Some thresholds can also be set on metrics with options --warning-* and --critical-*.

The available thresholds as well as all of the options that can be used with this Plugin can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins/ \
--plugin=apps::gorgone::restapi::plugin \
--mode=events \

You can display all of the modes that come with the Plugin with the command below:

/usr/lib/centreon/plugins// \
--plugin=apps::gorgone::restapi::plugin \