Actions9
- Host Actions
- Service Actions
Overview
This node integrates with the Centreon Web API to manage and interact with monitoring services and hosts. Specifically, for the Service - List operation, it retrieves a list of monitoring services from Centreon, optionally filtered by service name or associated host, and limited in number.
Common scenarios where this node is beneficial include:
- Automating retrieval of monitored services for reporting or dashboarding.
- Filtering services by name pattern or host to focus on specific subsets.
- Integrating Centreon service data into broader workflows for alerting, auditing, or synchronization.
For example, you could use this node to fetch all services related to a particular host that match a naming pattern, then process or notify based on their status.
Properties
| Name | Meaning |
|---|---|
| API Version | The version of the Centreon API to use (e.g., "latest", "v24.10"). |
| Host Name or ID | Select a host from the list or specify its ID via expression; filters services attached to this host. |
| Service Name (Like Format) | A regex pattern to filter services by their name (supports partial matching). |
| Limit | Maximum number of service results to return (minimum 1). |
| Options Avancées | Advanced options collection: - Ignore SSL Errors: Whether to ignore TLS certificate errors. |
Output
The output is an array of JSON objects representing the retrieved services. Each object corresponds to one service and contains the full response data as returned by the Centreon API for that service.
The structure includes fields such as service ID, name, description, associated host details, and other metadata as provided by Centreon.
No binary data is output by this operation.
Dependencies
- Requires valid credentials for Centreon API access, including base URL, username, and password.
- Uses Centreon API endpoints under
/api/{version}/monitoring/services. - Supports ignoring SSL errors via an advanced option.
- Requires n8n HTTP Request helper for making authenticated API calls.
Troubleshooting
- Authentication failures: If the node cannot authenticate, ensure the provided Centreon API credentials are correct and have sufficient permissions.
- Empty or unexpected responses: Verify that the API version is correct and that the host ID and service name filters are valid.
- SSL errors: If connecting to a Centreon instance with self-signed certificates, enable the "Ignore SSL Errors" option.
- Rate limits or large result sets: The node requests up to the specified limit; very high limits may cause performance issues or API throttling.
Common error messages:
"Failed to authenticate to Centreon": Check credentials and network connectivity."Failed to fetch services": Could indicate API endpoint issues or network problems."Unexpected response format: "result" is not an array": Indicates an unexpected API response, possibly due to version mismatch or server error.
Links and References
- Centreon API Documentation
- n8n Expressions Documentation
- n8n HTTP Request Node (for understanding underlying request mechanics)