Aruba Central Next Gen icon

Aruba Central Next Gen

Consume Aruba Central Next Gen API
Join our community

Actions82

Overview

This node interacts with Aruba Central Next Gen API to retrieve detailed radio information for a specific access point (AP). It is designed primarily for monitoring purposes, allowing users to fetch radio-level metrics and trends such as channel utilization, channel quality, noise floor, and frame statistics. This node is beneficial in network management scenarios where administrators need to analyze the performance and health of wireless radios within APs to optimize coverage, troubleshoot issues, or validate configurations.

Practical examples include:

  • Fetching radio details of an AP to monitor its current operational status.
  • Including channel utilization and quality trends to assess spectrum usage and interference.
  • Retrieving noise floor and frame error trends to diagnose wireless signal problems.

Properties

Name Meaning
Debug Mode Enable detailed debug logs for troubleshooting node execution.
Domain Select the API domain to interact with: "Monitoring" (for device/client/site monitoring) or "Configuration" (for device/group/profile configuration). For this operation, "Monitoring" is used.
Serial Number The unique serial number identifying the access point whose radio details are to be retrieved.
Radio Number The specific radio number within the access point (0 to 5) to get details for.
Options Additional options to include various radio trend data:
- Include Channel Utilization Whether to include radio channel utilization trends in the response.
- Include Channel Quality Whether to include radio channel quality trends in the response.
- Include Noise Floor Whether to include radio noise floor trends in the response.
- Include Frame Trends Whether to include radio frame trends such as drops, errors, and retries.

Output

The node outputs JSON data containing detailed radio information for the specified access point and radio number. The structure includes:

  • Basic radio details such as radio ID, status, frequency band, and other static properties.
  • Optional trend data depending on selected options:
    • Channel utilization trends showing how busy the radio channels are over time.
    • Channel quality trends indicating signal quality metrics.
    • Noise floor trends representing background RF noise levels.
    • Frame trends covering packet drops, errors, and retry counts.

If enabled, these trends provide time-series data useful for performance analysis and troubleshooting.

The node does not output binary data.

Dependencies

  • Requires an active connection to Aruba Central Next Gen API.
  • Needs an API authentication token configured via n8n credentials (an OAuth2 or API key credential).
  • Network connectivity to Aruba Central services.
  • No additional external libraries beyond those bundled with the node.

Troubleshooting

  • Common Issues:

    • Invalid or missing serial number: Ensure the serial number corresponds to a valid AP registered in Aruba Central.
    • Incorrect radio number: Radio numbers must be between 0 and 5; using an out-of-range value will cause errors.
    • Insufficient permissions or expired API token: Verify that the API credentials have proper access rights and are valid.
    • Network connectivity problems: Confirm that n8n can reach Aruba Central endpoints.

  • Error Messages:

    • "Unknown error in node execution": Generic catch-all error; check debug logs if enabled.
    • Credential-related errors: Re-authenticate or update API credentials.
    • Validation errors on input parameters: Correct the inputs according to property requirements.

Enabling "Debug Mode" helps capture detailed logs to diagnose issues.

Links and References

  • Aruba Central Next Gen API Documentation (official Aruba Networks site)
  • Aruba Central Monitoring API guides and best practices
  • n8n documentation on creating and configuring API credential types

Discussion