Centreon

Overview

This node integrates with Centreon, a monitoring software platform, via its Web API (v2). It allows users to manage and interact with Centreon resources such as hosts, services, and monitoring servers. The node supports operations like listing, adding, deleting, acknowledging alerts, scheduling downtimes, and applying configurations.

Typical use cases include:

• Automating the management of monitored hosts and services.
• Scheduling maintenance windows by setting downtimes.
• Acknowledging alerts programmatically.
• Applying configuration changes to monitoring servers without manual intervention.
• Fetching lists of hosts, services, or monitoring servers for reporting or further automation.

For example, you could use this node to automatically acknowledge a host alert when a related incident is created in your ITSM system, or schedule downtime for a service before planned maintenance.

Properties

Note: Although only the "API Version" property was provided explicitly, the node also supports many other input properties depending on the selected resource and operation, such as:

• Resource: Selects the type of Centreon resource to operate on (Host, Service, Monitoring Server).
• Operation: Defines the action to perform on the selected resource (e.g., list, add, delete, acknowledge, downtime, apply configuration).
• Various parameters specific to each operation, such as host name, address, templates, macros, comments, start/end times for downtime, notification flags, limits for listing, etc.

Output

The node outputs an array of JSON objects representing the results of the performed operations. Each item corresponds to one execution of the operation on an input item.

• For list operations, the output contains arrays of Centreon resources (hosts, services, or monitoring servers) with their details.
• For add, delete, acknowledge, downtime, and apply configuration operations, the output includes success messages or detailed results per resource.
• In case of errors, if "Continue on Fail" is enabled, error messages are included in the output JSON objects.

The node does not output binary data.

Dependencies

• Requires valid credentials for Centreon API access, including base URL, username, password, and SSL verification preference.
• Uses Centreon Web API v2 endpoints; the API version can be specified.
• Requires network connectivity to the Centreon server.
• No additional external dependencies beyond standard HTTP requests.

Troubleshooting

• Authentication failures: Errors like "Cannot authenticate to Centreon" or "Authentication failed" indicate invalid credentials or connectivity issues. Verify API credentials and network access.
• Unexpected response format: If the API returns unexpected data, ensure the correct API version is used and that the Centreon server is functioning properly.
• Invalid time ranges: Downtime operations require the start time to be before the end time; otherwise, an error is thrown.
• Empty or missing tokens: Authentication responses must include a token; absence indicates login failure.
• Operation unknown errors: Selecting unsupported operations for a resource will throw an error indicating "Unknown operation".
• Continue on Fail: Enable this option to allow processing multiple items even if some fail, useful for bulk operations.

Links and References

• Centreon Web API Documentation
• n8n Expressions Documentation
• n8n Node Development Guide