Aruba Central Next Gen icon

Aruba Central Next Gen

Consume Aruba Central Next Gen API

Actions82

Overview

This node integrates with Aruba Central Next Gen API to retrieve monitoring data related to Access Points (APs), specifically focusing on radio channel utilization metrics. It is designed to fetch detailed statistics about how radio channels are being used within a specified access point and radio number, optionally over a defined time range.

Typical use cases include:

  • Network administrators monitoring wireless network performance.
  • Troubleshooting radio channel congestion or interference.
  • Analyzing historical radio channel usage trends for capacity planning.

For example, a user can specify an AP's serial number and a particular radio number to get utilization data, helping identify if certain channels are overloaded or underutilized.

Properties

Name Meaning
Debug Mode Whether to enable detailed debug logs for troubleshooting.
Domain API domain to interact with. Options: "Monitoring" (monitor devices, clients, sites) or "Configuration" (configure devices, groups, profiles). For this operation, "Monitoring" is used.
Serial Number The unique serial number of the access point to query.
Radio Number The specific radio number within the access point for which to retrieve channel utilization data.
Time Range Optional start and end times (ISO 8601 format) defining the period for data retrieval.

Output

The node outputs JSON data containing radio channel utilization metrics for the specified access point and radio number. The structure typically includes time-series data points representing utilization percentages or counts over the requested time range.

If binary data were involved (not indicated here), it would represent raw files or media related to the radio channel data, but this node focuses on JSON-formatted monitoring metrics.

Dependencies

  • Requires an active connection to Aruba Central Next Gen API with appropriate API authentication credentials configured in n8n.
  • The node depends on the "arubaCentralNextGenOAuth2Api" credential for OAuth2-based authentication.
  • No additional external services beyond Aruba Central API are required.

Troubleshooting

  • Common Issues:

    • Invalid or missing serial number or radio number parameters will cause the API call to fail.
    • Incorrect time range formats or invalid date values may result in errors or empty responses.
    • Network connectivity issues or expired API tokens can prevent successful data retrieval.
  • Error Messages:

    • Errors from the API are caught and rethrown as node operation errors with descriptive messages.
    • If debug mode is enabled, detailed logs will be available to help diagnose issues.
  • Resolutions:

    • Verify that the serial number and radio number correspond to existing devices in Aruba Central.
    • Ensure the time range dates are valid ISO 8601 strings and that the end time is after the start time.
    • Refresh or reauthenticate API credentials if authorization errors occur.
    • Enable debug mode to get verbose logging for deeper insight.

Links and References

Discussion