Centreon icon

Centreon

Connect and manage Centreon using Centreon Web API (v2)

Actions12

Overview

This node integrates with Centreon, a monitoring solution, to manage monitoring servers and their configurations via the Centreon Web API. Specifically, the "Apply Configuration" operation for the "Monitoring Server" resource triggers the generation and reload of configuration on selected monitoring servers.

Use cases include:

  • Automating the deployment of updated monitoring configurations across one or multiple Centreon monitoring servers.
  • Ensuring that configuration changes made elsewhere (e.g., hosts or services) are applied without manual intervention.
  • Managing large-scale monitoring environments by programmatically applying configurations to specific servers.

For example, after adding or modifying hosts or services in Centreon, you can use this node to apply those changes immediately to selected monitoring servers.

Properties

Name Meaning
API Version Version of the Centreon API to use (e.g., "latest", "v24.10").
Monitoring Servers Names or IDs Select one or more monitoring servers to which the configuration will be applied. You can choose from a list or specify IDs using expressions.
Continue on Fail Whether to continue applying configuration to other monitoring servers if applying to one fails.

Output

The output is a JSON array where each element corresponds to the result of applying the configuration to a monitoring server. Each element contains:

  • monitoring_server_id: The ID of the monitoring server.
  • status: "success" if the configuration was applied successfully, or "error" if it failed.
  • result: The response data from the Centreon API when successful.
  • error: The error message if the operation failed.

Example output structure:

{
  "results": [
    {
      "monitoring_server_id": "123",
      "status": "success",
      "result": { /* API response object */ }
    },
    {
      "monitoring_server_id": "456",
      "status": "error",
      "error": "Error message describing failure"
    }
  ]
}

No binary data is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Centreon Web API.
  • Needs network access to the Centreon API endpoint.
  • The node uses the Centreon API version specified by the user.
  • The node expects the Centreon API to support the /configuration/monitoring-servers/{id}/generate-and-reload endpoint for applying configuration.

Troubleshooting

  • Authentication failures: If the node cannot authenticate, ensure the provided API credentials (username, password, base URL) are correct and that the Centreon API is reachable.
  • Empty or missing monitoring server selection: The operation requires at least one monitoring server ID; otherwise, it throws an error.
  • API errors during configuration application: Errors returned by the Centreon API will be included in the output. If "Continue on Fail" is disabled, the node execution stops on the first failure.
  • Invalid API version: Using an unsupported API version may cause unexpected errors.
  • Network issues: Timeouts or SSL verification problems can occur if the base URL is incorrect or SSL settings do not match the server's configuration.

Links and References

Discussion