Actions9
- Host Actions
- Service Actions
Overview
This node integrates with the Centreon Web API 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.
The Acknowledge operation for the Default resource allows users to send acknowledgements for hosts or services, which is useful to mark issues as acknowledged in the monitoring system, optionally notifying contacts and controlling acknowledgement persistence.
Practical examples include:
- Automatically acknowledging a host issue during maintenance windows.
- Acknowledging service alerts programmatically after incident resolution.
- Controlling notification behavior and acknowledgement persistence via options.
Properties
| Name | Meaning |
|---|---|
| API Version | Version of the Centreon API to use (e.g., "latest", "v24.10"). |
| Options Avancées | Advanced options collection: includes "Ignore SSL Errors" to bypass TLS certificate errors. |
For the Default Resource - Acknowledge Operation (Host)
| Name | Meaning |
|---|---|
| Host Name or ID | The host to acknowledge, selected from a list or specified by ID. |
| Comment | Required reason for the acknowledgement. |
| Notify | Whether to send a notification to the host's contacts (boolean). |
| Sticky | Whether to keep the acknowledgement on state change (boolean). |
| Persistent | Whether to keep the acknowledgement after scheduler restart (boolean). |
| Acknowledge Services Attached | Whether to also acknowledge all services attached to the host (boolean). |
Output
The node outputs an array of JSON objects corresponding to the results of the API calls made for each input item. Each output JSON contains the response data returned by the Centreon API for the performed operation.
No binary data output is produced by this node.
Dependencies
- Requires valid credentials for Centreon API access (username, password, base URL).
- Uses the Centreon Web API endpoints, requiring network connectivity to the Centreon server.
- Supports specifying API version and ignoring SSL errors via advanced options.
- No additional external libraries beyond n8n core helpers are required.
Troubleshooting
- Authentication failures: If the node cannot authenticate, it throws an error indicating failure to authenticate to Centreon. Verify credentials and API endpoint correctness.
- Unexpected response format: If the API returns unexpected data, the node may throw errors about response format. Check API version compatibility and server status.
- Network or SSL errors: If ignoring SSL errors is not enabled and the Centreon server uses self-signed certificates, requests may fail. Enable "Ignore SSL Errors" if appropriate.
- Invalid IDs or parameters: Providing invalid host or service IDs will cause API errors. Use the provided dropdowns or ensure correct IDs are used.
- Missing required fields: Required properties like comment for acknowledgement must be provided; otherwise, the node will error.
Links and References
- Centreon Web API Documentation
- n8n Expressions Documentation (for using expressions in property values)