Centreon
14 min
the centreon connector enables seamless integration with centreon's monitoring tools, allowing users to automate actions and retrieve detailed information about services and hosts centreon is a comprehensive it monitoring solution that enables the tracking of systems, networks, and applications to ensure their availability and performance the centreon turbine connector allows users to integrate centreon's robust monitoring capabilities directly into swimlane turbine's low code security automation platform by leveraging this connector, users can automate the retrieval of host and service details, enhancing incident response and ensuring continuous system monitoring the integration streamlines operations by providing actionable insights and facilitating rapid decision making within the swimlane ecosystem prerequisites to utilize the centreon connector within swimlane turbine, ensure you have the following prerequisites http basic authentication with the following parameters url the endpoint url for the centreon api username your centreon account username password the corresponding password for your centreon account version the version of the centreon api you are targeting capabilities this centreon connector provides the following capabilities get a host get a service api documentation link centreon api documentation link https //docs api centreon com/api/centreon web/ configurations centreon http basic authentication authenticates using username and password configuration parameters parameter description type required url a url to the target host string required username username string required version version string required password password string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions get a host retrieve full details and services of a specified host in centreon by using the provided host id endpoint url /monitoring/hosts/{{host id}} method get input argument name type required description host id number required id of the host output parameter type description status code number http status code of the response reason string response reason phrase id number unique identifier alias string output field alias display name string name of the resource name string name of the resource state number output field state services array output field services id number unique identifier description string output field description display name string name of the resource state number output field state poller id number unique identifier acknowledged boolean output field acknowledged address ip string output field address ip check attempt number output field check attempt checked boolean output field checked execution time number time value icon image string output field icon image icon image alt string output field icon image alt last check string output field last check last hard state change string output field last hard state change last state change string output field last state change last time down string output field last time down last time unreachable string output field last time unreachable example \[ { "status code" 200, "response headers" { "content length" "140", "content type" "application/json", "date" "thu, 2 may 2024 20 37 23 gmt" }, "reason" "ok", "json body" { "id" 12, "alias" "central", "display name" "central", "name" "central", "state" 0, "services" \[], "poller id" 1, "acknowledged" false, "address ip" "127 0 0 1", "check attempt" 1, "checked" true, "execution time" 0 070906, "icon image" "ppm/operatingsystems linux snmp linux 128 png", "icon image alt" "", "last check" "2019 08 24t14 15 22z" } } ] get a service retrieve full details of a specific service on centreon using the provided host and service ids endpoint url /monitoring/hosts/{{host id}}/services/{{service id}} method get input argument name type required description host id number required id of the host service id number required id of the service output parameter type description status code number http status code of the response reason string response reason phrase id number unique identifier description string output field description display name string name of the resource state number output field state check attempt number output field check attempt icon image string output field icon image icon image alt string output field icon image alt last check string output field last check last state change string output field last state change max check attempts number output field max check attempts output string output field output state type number type of the resource criticality number output field criticality status object status value code number output field code name string name of the resource severity code number output field severity code duration string output field duration check command string output field check command check interval number output field check interval check period string output field check period check type number type of the resource command line string output field command line example \[ { "status code" 200, "response headers" { "content length" "140", "content type" "application/json", "date" "thu, 2 may 2024 20 37 23 gmt" }, "reason" "ok", "json body" { "id" 5, "description" "ping", "display name" "ping", "state" 0, "check attempt" 1, "icon image" "", "icon image alt" "", "last check" "2019 08 24t14 15 22z", "last state change" "2019 08 24t14 15 22z", "max check attempts" 3, "output" "ok 127 0 0 1 rta 0 025ms lost 0%\n", "state type" 1, "criticality" 10, "status" {}, "duration" "2h 3m" } } ] response headers header description example content length the length of the response body in bytes 140 content type the media type of the resource application/json date the date and time at which the message was originated thu, 2 may 2024 20 37 23 gmt