Actions9
- Host Actions
- Service Actions
Overview
This node integrates with the Centreon Web API (version configurable, e.g., "latest" or "v24.10") to manage monitoring resources such as hosts and services. It supports operations like listing, adding, and acknowledging hosts or services within a Centreon monitoring environment.
Typical use cases include:
- Automating the creation of new monitored hosts or services.
- Retrieving lists of existing hosts or services with optional filtering.
- Sending acknowledgements for hosts or services to suppress alerts temporarily.
For example, you can use this node to add a new host with specific templates and macros, or acknowledge a service issue with a comment and notification preferences.
Properties
| Name | Meaning |
|---|---|
| API Version | The version of the Centreon API to use (e.g., "latest", "v24.10"). |
| Options Avancées | Advanced options collection: • Ignore SSL Errors: Whether to ignore TLS certificate errors. |
Output
The node outputs JSON data representing the response from the Centreon API for each executed operation. The structure depends on the operation performed:
- Add Host/Service: Returns the created resource details as provided by Centreon.
- List Hosts/Services: Returns an array of matching hosts or services with their properties.
- Acknowledge Host/Service: Returns acknowledgement confirmation details.
No binary data output is produced by this node.
Dependencies
- Requires valid credentials for Centreon API access, including base URL, username, and password.
- The node performs authentication via a login endpoint to obtain a token used in subsequent requests.
- Supports ignoring SSL errors if specified in advanced options.
- Uses HTTP requests to interact with Centreon's REST API endpoints.
Troubleshooting
- Authentication Failures: If the node throws an error about failing to authenticate or missing tokens, verify that the provided credentials are correct and that the Centreon API endpoint is reachable.
- Unexpected Response Format: Errors indicating unexpected response formats may suggest API changes or connectivity issues.
- SSL Errors: If connecting to a Centreon instance with self-signed certificates, enable the "Ignore SSL Errors" option to bypass TLS verification.
- Invalid Parameters: Ensure required parameters like host name, address, or service name are provided when adding resources.
- Rate Limits or Pagination: Large list operations might be limited by API pagination; the node handles this internally but very large datasets could cause delays.
Links and References
- Centreon API Documentation
- n8n Expressions Documentation (for using expressions in parameter fields)