---
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.1.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 an 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 the individual EdgeConnect appliances, collects health and performance metrics from each appliance's REST API and minute-stats archives, and reports the topology of the SD-WAN fabric (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-FEC), Mean Opinion Score (MOS) for voice-quality tracking, downtime during the interval, and bidirectional throughput in both bits and packets per second. Allows detection of path degradation and 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.
- **QoS and traffic shaping**: Tracks per-DSCP-class bandwidth and rate counters, shaper drop counts, and drop percentages. Useful for validating QoS policies and spotting classes being starved or over-subscribed.
- **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 drill-down from 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.

To authenticate to the Orchestrator with an API key instead of a username and password, set `orchestrator_api_key` and leave `orchestrator_username` and `orchestrator_password` unset. Create the key in Orchestrator under **Users & Authentication > API Keys**; Read-Only permission is enough. Appliances do not accept API keys, so configure their credentials in `appliance_credentials_overrides`. To use the same credentials for every appliance, add a single entry with `cidr: 0.0.0.0/0`. Appliances that no entry covers are skipped with a warning on every run. If that is intended, exclude them with `appliance_ips`. API keys expire, so rotate the key before its expiration date to avoid collection failures.

It is recommended to configure `appliance_ips` with an explicit include list that matches your known appliance IP ranges. This helps ensure that the check only connects to expected appliances.

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, as described in 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: <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.

**First run.** Each Agent keeps its own record of the last alarm it reported. When an Agent runs the check without that record, such as on its first run or when it takes over collection from another Agent, it sends only the alarms raised during the last collection interval as events. Older outstanding alarms are not sent as events, but the `hpe_aruba_edgeconnect.device.hardware.ok` metric still reflects current hardware alarms.

### 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.d/conf.yaml` to `hpe_aruba_edgeconnect.d/conf.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://docs.datadoghq.com/help/).
