Centreon icon

Centreon

Connect and manage Centreon using Centreon Web API (v2)

Actions12

Overview

This node integrates with the Centreon monitoring platform via its Web API, specifically focusing on managing "Host" resources. The "List" operation for Hosts retrieves a list of monitored hosts from Centreon, optionally filtered by a regex pattern on host names and limited to a maximum number of results.

Typical use cases include:

  • Fetching a subset of hosts matching certain naming patterns for further processing or reporting.
  • Integrating Centreon host data into workflows for alerting, auditing, or synchronization with other systems.
  • Automating monitoring dashboards or inventories by dynamically retrieving host information.

For example, you could use this node to get all hosts whose names contain "webserver" and then trigger notifications or updates based on their status.

Properties

Name Meaning
API Version Version of the Centreon API to use (e.g., "latest", "v24.10").
Host Name (Like Format) A regular expression filter to match host names (regex applied to host names).
Limit Maximum number of host results to return (minimum 1).

Output

The output is an array of JSON objects representing hosts retrieved from Centreon. Each object corresponds to a host and includes all properties returned by the Centreon API under the /monitoring/hosts endpoint.

The structure typically contains fields such as:

  • id: Unique identifier of the host.
  • name or display_name: The name of the host.
  • Other metadata as provided by Centreon about each host.

No binary data is output by this operation.

Dependencies

  • Requires valid Centreon API credentials (username, password, base URL).
  • The node authenticates using these credentials to obtain an authentication token before making API requests.
  • The API version parameter must correspond to a supported Centreon API version.
  • Network access to the Centreon server's API endpoint is required.
  • Optionally supports ignoring SSL certificate errors if configured in credentials.

Troubleshooting

  • Authentication failures: If the node cannot authenticate, it throws an error "Cannot authenticate to Centreon". Verify credentials and network connectivity.
  • Invalid API version: Using an unsupported API version may cause request failures.
  • Regex filter issues: Invalid regex syntax in the "Host Name (Like Format)" property may result in no hosts being returned or errors.
  • Limit too high or low: Setting limit below 1 is invalid; very high limits may impact performance.
  • Empty results: Could indicate no hosts match the filter or connectivity issues.
  • SSL errors: If SSL verification fails, consider enabling the option to ignore SSL errors in credentials.

Links and References

Discussion