Centreon
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
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 |
|---|---|---|---|
path_parameters.host_id | number | Required | ID of the host. |
Input Example
{"path_parameters":{"host_id":12}}
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 |
services.id | number | Unique identifier |
services.description | string | Output field: services.description |
services.display_name | string | Name of the resource |
services.state | number | Output field: services.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 |
Output 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 |
|---|---|---|---|
path_parameters.host_id | number | Required | ID of the host. |
path_parameters.service_id | number | Required | ID of the service. |
Input Example
{"path_parameters":{"host_id":12,"service_id":5}}
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 |
status.code | number | Status value |
status.name | string | Name of the resource |
status.severity_code | number | Status value |
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 |
Output 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":{"code":0,"name":"UP","severity_c...
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 |