--- title: HPE Aruba EdgeConnect description: >- A secure SD-WAN platform for resilient connectivity, app performance, and network visibility. breadcrumbs: Docs > Integrations > HPE Aruba EdgeConnect --- > For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt). # HPE Aruba EdgeConnect Supported OS Integration version1.0.0 {% callout %} # Important note for users on the following Datadog sites: us2.ddog-gov.com {% alert level="info" %} To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator. To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com). {% /alert %} {% /callout %} HPE Aruba EdgeConnect dashboard (light mode)HPE Aruba EdgeConnect dashboard (dark mode) ## Overview{% #overview %} This check monitors [HPE Aruba EdgeConnect](https://www.hpe.com/us/en/aruba-edgeconnect-sd-wan.html) through the Datadog Agent. HPE Aruba EdgeConnect is a Software-Defined Wide Area Network (SD-WAN) platform used to connect branch offices, data centers, and cloud environments through an overlay of secure tunnels managed centrally by an Orchestrator. `This integration authenticates against the Orchestrator and individual EdgeConnect appliances to collect health and performance metrics from each appliance's REST API and minute-stats archives. It also reports the SD-WAN fabric topology (devices, interfaces, and tunnels) to Network Device Monitoring (NDM).` ### What this integration monitors{% #what-this-integration-monitors %} The integration collects metrics across multiple layers of the EdgeConnect SD-WAN fabric, including: - **Orchestrator and appliance inventory**: Discovers all EdgeConnect appliances managed by the Orchestrator. Surfaces reachability status, uptime, hostname, site, model, and software version. - **Appliance health**: Reports CPU, memory, and disk usage percentages, as well as hardware alarm state, to detect overloaded or failing devices. - **Network interfaces**: Provides administrative and operational status, configured speed, RX/TX bandwidth and rate, peak and average utilization, and forward-drop counters per interface. - **SD-WAN tunnels**: Reports per-tunnel latency, jitter, packet loss (pre- and post-Forward Error Correction (FEC)), Mean Opinion Score (MOS) for voice-quality tracking, downtime during the interval, and bidirectional throughput in both bits and packets per second. Detects path degradation and Service Level Agreement (SLA) violations across the overlay. - **Internet breakout tunnels**: Monitors RX/TX bandwidth, peak rates, and configured maximum throughput on local-internet breakout tunnels to observe direct-to-cloud traffic. - **Quality of Service (QoS) and traffic shaping**: Tracks per-Differentiated Services Code Point (DSCP) class bandwidth and rate counters, shaper drop counts, and drop percentages. Useful for validating QoS policies and spotting classes being starved or oversubscribed. - **Circuit SLA probes**: Reports average latency, jitter, and packet loss from SLA probes, plus next-hop administrative and operational status, to monitor underlay link quality independently of the overlay. - **Application performance**: Provides per-application latency, enabling you to trace tunnel or interface issues to the specific affected applications. - **Network Device Monitoring topology**: Pushes device, interface, and tunnel metadata to NDM, enabling visualization of the SD-WAN fabric and correlation with the rest of the network. ## Setup{% #setup %} Follow the instructions below to install and configure this check for an Agent running on a host. For containerized environments, see the [Autodiscovery Integration Templates](https://docs.datadoghq.com/containers/kubernetes/integrations.md) for guidance on applying these instructions. #### Installation{% #installation %} The HPE Aruba EdgeConnect check is included in the [Datadog Agent](https://app.datadoghq.com/account/settings/agent/latest) package. No additional installation is needed on your server. #### Configuration{% #configuration %} 1. Edit the `hpe_aruba_edgeconnect.d/conf.yaml` file, in the `conf.d/` folder at the root of your Agent's configuration directory to start collecting your HPE Aruba EdgeConnect performance data. See the [sample hpe_aruba_edgeconnect.d/conf.yaml](https://github.com/DataDog/integrations-core/blob/master/hpe_aruba_edgeconnect/datadog_checks/hpe_aruba_edgeconnect/data/conf.yaml.example) for all available configuration options. **Note**: Monitor permissions are enough to collect most metrics. Admin permissions are required to collect the `hpe_aruba_edgeconnect.device.cpu.usage` metric on the appliances. If the configured credentials do not have admin access, the Agent skips this metric, but collects the rest of the metrics. 1. [Restart the Agent](https://docs.datadoghq.com/agent/configuration/agent-commands.md#start-stop-and-restart-the-agent). #### Validation{% #validation %} [Run the Agent's status subcommand](https://docs.datadoghq.com/agent/configuration/agent-commands.md#agent-status-and-information) and look for `hpe_aruba_edgeconnect` under the Checks section. ### Data Collected{% #data-collected %} #### Metrics{% #metrics %} | | | | | **hpe_aruba_edgeconnect.application.latency**(gauge) | Application latency.*Shown as millisecond* | | **hpe_aruba_edgeconnect.circuit.sla.jitter**(gauge) | Average SLA probe jitter.*Shown as millisecond* | | **hpe_aruba_edgeconnect.circuit.sla.latency**(gauge) | Average SLA probe latency.*Shown as millisecond* | | **hpe_aruba_edgeconnect.circuit.sla.loss**(gauge) | Average SLA probe packet loss.*Shown as percent* | | **hpe_aruba_edgeconnect.device.cpu.usage**(gauge) | CPU usage percentage on the appliance broken down by state (user, system, IRQ, and nice).*Shown as percent* | | **hpe_aruba_edgeconnect.device.disk.usage**(gauge) | Disk usage percentage on the appliance per mount.*Shown as percent* | | **hpe_aruba_edgeconnect.device.hardware.ok**(gauge) | Hardware alarm status of the appliance (1 = ok, 0 = alarm active). | | **hpe_aruba_edgeconnect.device.memory.usage**(gauge) | Memory usage percentage on the appliance.*Shown as percent* | | **hpe_aruba_edgeconnect.device.reachability**(gauge) | Whether the appliance is reachable from the Orchestrator (1 = reachable, 0 = not reachable). | | **hpe_aruba_edgeconnect.device.uptime**(gauge) | Uptime of the appliance in seconds.*Shown as second* | | **hpe_aruba_edgeconnect.interface.bandwidth.rx.count**(gauge) | Bytes received on the interface. Cumulative across recovered minutes after Agent restart backfill.*Shown as byte* | | **hpe_aruba_edgeconnect.interface.bandwidth.rx.max**(gauge) | Peak bytes received on the interface.*Shown as byte* | | **hpe_aruba_edgeconnect.interface.bandwidth.rx.rate**(gauge) | Receive rate on the interface in bytes per second.*Shown as byte* | | **hpe_aruba_edgeconnect.interface.bandwidth.tx.count**(gauge) | Bytes transmitted on the interface. Cumulative across recovered minutes after Agent restart backfill.*Shown as byte* | | **hpe_aruba_edgeconnect.interface.bandwidth.tx.max**(gauge) | Peak bytes transmitted on the interface.*Shown as byte* | | **hpe_aruba_edgeconnect.interface.bandwidth.tx.rate**(gauge) | Transmit rate on the interface in bytes per second.*Shown as byte* | | **hpe_aruba_edgeconnect.interface.drops.bytes.rx.count**(gauge) | Forward drop bytes received on the interface. Cumulative across recovered minutes after Agent restart backfill.*Shown as byte* | | **hpe_aruba_edgeconnect.interface.drops.bytes.rx.max**(gauge) | Peak forward drop bytes received on the interface.*Shown as byte* | | **hpe_aruba_edgeconnect.interface.drops.bytes.rx.rate**(gauge) | Forward drop bytes received per second on the interface.*Shown as byte* | | **hpe_aruba_edgeconnect.interface.drops.bytes.tx.count**(gauge) | Forward drop bytes transmitted on the interface. Cumulative across recovered minutes after Agent restart backfill.*Shown as byte* | | **hpe_aruba_edgeconnect.interface.drops.bytes.tx.max**(gauge) | Peak forward drop bytes transmitted on the interface.*Shown as byte* | | **hpe_aruba_edgeconnect.interface.drops.bytes.tx.rate**(gauge) | Forward drop bytes transmitted per second on the interface.*Shown as byte* | | **hpe_aruba_edgeconnect.interface.drops.packets.rx.count**(gauge) | Forward drop packets received on the interface. Cumulative across recovered minutes after Agent restart backfill.*Shown as packet* | | **hpe_aruba_edgeconnect.interface.drops.packets.rx.max**(gauge) | Peak forward drop packets received on the interface.*Shown as packet* | | **hpe_aruba_edgeconnect.interface.drops.packets.rx.rate**(gauge) | Forward drop packets received per second on the interface.*Shown as packet* | | **hpe_aruba_edgeconnect.interface.drops.packets.tx.count**(gauge) | Forward drop packets transmitted on the interface. Cumulative across recovered minutes after Agent restart backfill.*Shown as packet* | | **hpe_aruba_edgeconnect.interface.drops.packets.tx.max**(gauge) | Peak forward drop packets transmitted on the interface.*Shown as packet* | | **hpe_aruba_edgeconnect.interface.drops.packets.tx.rate**(gauge) | Forward drop packets transmitted per second on the interface.*Shown as packet* | | **hpe_aruba_edgeconnect.interface.speed**(gauge) | Configured speed of the interface in bits per second.*Shown as bit* | | **hpe_aruba_edgeconnect.interface.status**(gauge) | Administrative or operational status of the interface (1 = up, 0 = down). | | **hpe_aruba_edgeconnect.interface.utilization.rx.avg**(gauge) | Average receive utilization percentage of the interface.*Shown as percent* | | **hpe_aruba_edgeconnect.interface.utilization.rx.max**(gauge) | Peak receive utilization percentage of the interface.*Shown as percent* | | **hpe_aruba_edgeconnect.interface.utilization.tx.avg**(gauge) | Average transmit utilization percentage of the interface.*Shown as percent* | | **hpe_aruba_edgeconnect.interface.utilization.tx.max**(gauge) | Peak transmit utilization percentage of the interface.*Shown as percent* | | **hpe_aruba_edgeconnect.nexthop.status**(gauge) | Number of times per minute that the IP SLA next-hop's administrative or operational status is up. | | **hpe_aruba_edgeconnect.orchestrator.reachability**(gauge) | Whether the Orchestrator is reachable and returning appliance data (1 = reachable, 0 = not reachable). | | **hpe_aruba_edgeconnect.qos.class.bandwidth.rx.count**(gauge) | Bytes received for the DSCP class. Cumulative across recovered minutes after Agent restart backfill.*Shown as byte* | | **hpe_aruba_edgeconnect.qos.class.bandwidth.rx.max**(gauge) | Peak receive bandwidth for the DSCP class in bytes.*Shown as byte* | | **hpe_aruba_edgeconnect.qos.class.bandwidth.rx.rate**(gauge) | Receive rate for the DSCP class in bytes per second.*Shown as byte* | | **hpe_aruba_edgeconnect.qos.class.bandwidth.tx.count**(gauge) | Bytes transmitted for the DSCP class. Cumulative across recovered minutes after Agent restart backfill.*Shown as byte* | | **hpe_aruba_edgeconnect.qos.class.bandwidth.tx.max**(gauge) | Peak transmit bandwidth for the DSCP class in bytes.*Shown as byte* | | **hpe_aruba_edgeconnect.qos.class.bandwidth.tx.rate**(gauge) | Transmit rate for the DSCP class in bytes per second.*Shown as byte* | | **hpe_aruba_edgeconnect.qos.class.drop.percentage**(gauge) | Percentage of packets shaped that were dropped by QoS.*Shown as percent* | | **hpe_aruba_edgeconnect.qos.class.drops**(gauge) | QoS or other dropped packets by the traffic shaper. Cumulative across recovered minutes after Agent restart backfill.*Shown as packet* | | **hpe_aruba_edgeconnect.tunnel.availability**(gauge) | Percentage of time the tunnel was up during the interval.*Shown as percent* | | **hpe_aruba_edgeconnect.tunnel.internet_breakout.bandwidth.rx.count**(gauge) | Bytes received on the internet breakout tunnel. Cumulative across recovered minutes after Agent restart backfill.*Shown as byte* | | **hpe_aruba_edgeconnect.tunnel.internet_breakout.bandwidth.rx.max**(gauge) | Maximum configured receive bandwidth on the internet breakout tunnel.*Shown as byte* | | **hpe_aruba_edgeconnect.tunnel.internet_breakout.bandwidth.rx.rate**(gauge) | Receive rate on the internet breakout tunnel in bytes per second.*Shown as byte* | | **hpe_aruba_edgeconnect.tunnel.internet_breakout.bandwidth.tx.count**(gauge) | Bytes transmitted on the internet breakout tunnel. Cumulative across recovered minutes after Agent restart backfill.*Shown as byte* | | **hpe_aruba_edgeconnect.tunnel.internet_breakout.bandwidth.tx.max**(gauge) | Maximum configured transmit bandwidth on the internet breakout tunnel.*Shown as byte* | | **hpe_aruba_edgeconnect.tunnel.internet_breakout.bandwidth.tx.rate**(gauge) | Transmit rate on the internet breakout tunnel in bytes per second.*Shown as byte* | | **hpe_aruba_edgeconnect.tunnel.jitter**(gauge) | Jitter on the tunnel.*Shown as millisecond* | | **hpe_aruba_edgeconnect.tunnel.jitter.max**(gauge) | Peak jitter on the tunnel.*Shown as millisecond* | | **hpe_aruba_edgeconnect.tunnel.latency**(gauge) | Average latency on the tunnel.*Shown as millisecond* | | **hpe_aruba_edgeconnect.tunnel.latency.max**(gauge) | Peak latency on the tunnel.*Shown as millisecond* | | **hpe_aruba_edgeconnect.tunnel.latency.min**(gauge) | Minimum latency on the tunnel.*Shown as millisecond* | | **hpe_aruba_edgeconnect.tunnel.loss**(gauge) | Packet loss on the tunnel.*Shown as percent* | | **hpe_aruba_edgeconnect.tunnel.qoe.mos**(gauge) | Mean Opinion Score on the tunnel. | | **hpe_aruba_edgeconnect.tunnel.qoe.mos.min**(gauge) | Minimum Mean Opinion Score on the tunnel. | | **hpe_aruba_edgeconnect.tunnel.throughput.rx.bytes.count**(gauge) | Bytes received on the tunnel. Cumulative across recovered minutes after Agent restart backfill.*Shown as byte* | | **hpe_aruba_edgeconnect.tunnel.throughput.rx.bytes.max**(gauge) | Peak bytes received on the tunnel.*Shown as byte* | | **hpe_aruba_edgeconnect.tunnel.throughput.rx.bytes.rate**(gauge) | Receive throughput rate on the tunnel in bytes per second.*Shown as byte* | | **hpe_aruba_edgeconnect.tunnel.throughput.rx.packets.count**(gauge) | Packets received on the tunnel. Cumulative across recovered minutes after Agent restart backfill.*Shown as packet* | | **hpe_aruba_edgeconnect.tunnel.throughput.rx.packets.max**(gauge) | Peak packets received on the tunnel.*Shown as packet* | | **hpe_aruba_edgeconnect.tunnel.throughput.rx.packets.rate**(gauge) | Receive packet rate on the tunnel in packets per second.*Shown as packet* | | **hpe_aruba_edgeconnect.tunnel.throughput.tx.bytes.count**(gauge) | Bytes transmitted on the tunnel. Cumulative across recovered minutes after Agent restart backfill.*Shown as byte* | | **hpe_aruba_edgeconnect.tunnel.throughput.tx.bytes.max**(gauge) | Peak bytes transmitted on the tunnel.*Shown as byte* | | **hpe_aruba_edgeconnect.tunnel.throughput.tx.bytes.rate**(gauge) | Transmit throughput rate on the tunnel in bytes per second.*Shown as byte* | | **hpe_aruba_edgeconnect.tunnel.throughput.tx.packets.count**(gauge) | Packets transmitted on the tunnel. Cumulative across recovered minutes after Agent restart backfill.*Shown as packet* | | **hpe_aruba_edgeconnect.tunnel.throughput.tx.packets.max**(gauge) | Peak packets transmitted on the tunnel.*Shown as packet* | | **hpe_aruba_edgeconnect.tunnel.throughput.tx.packets.rate**(gauge) | Transmit packet rate on the tunnel in packets per second.*Shown as packet* | #### Logs{% #logs %} The recommended way to collect logs from HPE Aruba EdgeConnect is to configure the appliance to forward logs through syslog. For more information, see the [HPE Aruba Networking documentation](https://arubanetworking.hpe.com/techdocs/sdwan/docs/orch/support/tech-assistance/remote-log-msgs/). 1. Enable log collection in your `datadog.yaml` file: ```yaml logs_enabled: true ``` 1. Uncomment and edit the logs configuration block in your `hpe_aruba_edgeconnect.d/conf.yaml` file. For example: ```yaml logs: - type: tcp port: 10514 source: hpe_aruba_edgeconnect service: ``` #### Events{% #events %} The HPE Aruba EdgeConnect integration includes alarm event support. Events are disabled by default; to enable them, set `collect_events` to `true` in the configuration. ### Service Checks{% #service-checks %} The HPE Aruba EdgeConnect integration does not include any service checks. ## Uninstallation{% #uninstallation %} To disable the integration, rename the configuration file from `hpe_aruba_edgeconnect.yaml` to `hpe_aruba_edgeconnect.yaml.example`. Alternatively, if you are running a containerized environment, you can remove the annotation used to enable the integration. ## Support{% #support %} Need help? Contact [Datadog Support](https://app.datadoghq.com/help).