Skip to main content
The system metrics and network metrics that you can access in CoPilot are captured by the Aviatrix Controller. The Controller pulls the data from virtual machines (instances/hosts) that Aviatrix Gateways run on and feeds that data to CoPilot. Some metrics can be used for triggering actions such as alerting and Gateway Scaling. You can also use metrics to monitor the performance of Gateway hosts. You can monitor performance in CoPilot from the Monitor > Performance page. In addition, with Aviatrix Network Insights API, you can use APIs to analyze the performance and health of your Aviatrix-managed resources in external monitoring systems. See Monitoring with Network Insights API for information about using Network Insights Metric and Status APIs.

​
About Metrics that are Monitored for Aviatrix Resources

Aviatrix Controller captures system metric and network metric information about the virtual machines (instances/hosts) that Aviatrix Gateways run on. Health-type metric information is also captured for Controller and CoPilot virtual machines. See Global Control Plane Health Alert. Metrics that are monitored by Aviatrix Controller and Aviatrix CoPilot include the following: On the CoPilot Monitor > Performance page, you can select metrics to monitor performance on your resource VMs. On the CoPilot Monitor > Notifications > Alert Configurations page, you can configure how to use the pre-existing set of metrics to send notifications about events that occur in your network, such as performance bottlenecks or other problems. To better understand how notifications and alerts work and how to configure them in CoPilot, see Notifications (Alerts) About Network Events. For more information about integrating Aviatrix metric and status APIs with external monitoring tools, see Monitoring with Network Insights API.

​
Health Metrics for Triggering Notifications or Other Actions

The following health metrics are available in CoPilot. They are listed in alphabetical order, by the name used in the CoPilot UI.
Name (Health Metric)DescriptionInternal Metric NameAccessible by API
BGP Peering StatusAny BGP peering status change triggers an alert.BGPpeeringStatus
Connection StatusAny connection status change on the specified gateways/connections triggers an alert.ConnectionStatus
Gateway StatusAny gateway status change triggers an alert.GatewayStatus
Underlay Connection StatusMonitors the syslog from any connection that includes the host as the source or destination. When syslog data indicates a potential problem from each direction of the connection between that host and another host within 30 seconds of the other, the alert is triggered. On the same connection, if the syslog data later indicates the problem is resolved from either direction, the alert is automatically resolved.UnderlayConnectionStatus

​
System Metrics for Triggering Notifications or Other Actions

For Aviatrix Controller and Aviatrix gateways, you can configure alerts based on the following system metrics. Aviatrix gateways report live Linux system statistics (such as memory, CPU, I/O, processes, and swap) for the instances/virtual machines on which they run. Metrics are listed in alphabetical order, by the name used in the CoPilot UI.
Name (System Metric)DescriptionInternal Metric NameAccessible by API
CPU Idle (%)Of the total CPU time, the percentage of time the CPU(s) spent idle and waiting for tasks from the kernel.cpu_idle20
CPU Kernel Space (%)Of the total kernel space memory on the host (VM/instance), the percentage of time spent running kernel code.cpu_ks20
CPU Steal (%)Of the average CPU wait time on the host (VM/instance), the percentage of time a virtual CPU waits for a real CPU while the hypervisor services another virtual processor.cpu_steal
CPU Used (%)The percentage of CPU used.cpu_used_per
CPU User Space (%)Of the total CPU time, the percentage of time spent running non-kernel code.cpu_us20
CPU Wait (%)Of the total CPU time, the percentage of time spent waiting for IO.cpu_wait20
Disk FreeThe storage space on the disk (volume) that is free/unused.hdisk_free
Disk Free (%)Of the total storage space on the disk (volume), the percentage of storage space that is free/unused.hdisk_free_per
Disk TotalThe total storage space on the disk (volume).hdisk_tot
IO Blocks InThe number of blocks received per second from a block device.io_blk_in
IO Blocks OutThe number of blocks sent per second to a block device.io_blk_out
Memory AvailableThe available amount of memory that can be allocated to new or existing processes.memory_available20
Memory Available (%)Of the total memory, the percentage of the available memory that can be allocated to new or existing processes.memory_available_per
Memory BufferThe amount of memory used as buffers.memory_buf20
Memory CacheThe amount of memory used as cache.memory_cached20
Memory SwappedIf swapped is enabled, the amount of virtual memory used.memory_swpd20
Memory TotalThe total memory.memory_tot
Memory UsedThe amount of memory used.memory_used
Memory Used (%)Of the total memory, the percentage of memory used.memory_used_per
Processes Uninterruptible SleepThe number of processes blocked waiting for I/O to complete.nproc_non_int_sleep
Processes Waiting To Be RunThe number of processes that are running or waiting for run time.nproc_running
Swaps From DiskMemory that is swapped in every second from disk in kilobytes.swap_from_disk
Swaps To DiskMemory that is swapped out every second to disk in kilobytes.swap_to_disk
System Context SwitchesThe number of context switches per second.system_cs
System InterruptsThe number of interrupts per second, including the clock.system_int

​
Network Metrics for Triggering Notifications or Other Actions

For Aviatrix Controller and Aviatrix gateways, you can configure alerts based on the following network metrics. Metrics are listed in alphabetical order, by the name used in the CoPilot UI.
Name (Network Metric)DescriptionInternal Metric NameAccessible by API
Bandwidth Egress Limit ExceededBandwidth Egress Limit Exceededbandwidth_egress_limit_exceeded
Bandwidth Egress Limit Exceeded (%)Bandwidth Egress Limit Exceeded (%)per_bandwidth_egress_limit
Bandwidth Egress Limit Exceeded RateThe number of tx packets dropped because the bandwidth allowance limit was exceeded. This metric is supplied by the Elastic Network Adapter (ENA) driver only on AWS.rate_bandwidth_egress_limit_exceeded
Bandwidth Ingress Limit ExceededBandwidth Ingress Limit Exceededbandwidth_ingress_limit_exceeded
Bandwidth Ingress Limit Exceeded (%)The percentage of dropped rx packets due to exceeding the bandwidth allowance limit. This metric is specific to the ENA driver on AWS.per_bandwidth_ingress_limit_exceeded20
Bandwidth Ingress Limit Exceeded Rate(AWS Only) Bandwidth Ingress Limit Exceeded Rate — The number of rx packets dropped because the bandwidth allowance limit was exceeded. This metric is supplied by the ENA driver only on AWS.rate_bandwidth_ingress_limit_exceeded
Collisions during TransmissionThe count of collisions during packet transmission.tx_colls
Collisions Rate during TransmissionThe number of collisions per second during packet transmission.rate_tx_colls
Compressed Packets ReceivedThe count of compressed packets received.rx_compressed
Compressed Packets Received RateThe number of compressed packets received per second.rate_rx_compressed
Compressed Packets TransmittedThe count of correctly received compressed packets.tx_compressed
Compressed Packets Transmitted RateThe number of correctly received compressed packets per second.rate_tx_compressed
Conntrack Allowance Available(AWS Only) Reports the number of available tracked connections that can be established before an instance’s Connections Tracked allowance is exceeded. This metric is supplied by the Elastic Network Adapter (ENA) driver only on AWS.conntrack_allowance_available
Conntrack Limit ExceededConntrack Limit Exceededconntrack_limit_exceeded
Conntrack Limit Exceeded (%)Conntrack Limit Exceeded (%)per_conntrack_limit_exceeded
Conntrack Limit Exceeded RateConntrack limit exceeded rate.rate_conntrack_limit_exceeded
Conntrack Usage Rate(AWS Only) The rate at which conntrack capacity is being used up in connections per second. The Conntrack Usage Rate metric is only available in AWS where the Conntrack Allowance Available (conntrack_allowance_available) metric is present.conntrack_usage_rate
Drop Rate during TransmissionThe number of packets being dropped per second while sending.rate_tx_drop20
Drop Rate while ReceivingThe number of packets being dropped per second while receiving.rate_rx_drop20
Errored Packets ReceivedThe count of packets received that is flagged by the kernel as errored.rx_errs
Errored Packets Received RateThe number of packets received per second that is flagged by the kernel as errored.rate_rx_errs
Errored Packets TransmittedThe total number of transmit problems.tx_errs
Errored Packets Transmitted RateThe total number of transmit problems per second.rate_tx_errs
Interface Drops during Transmission (%)Interface Drops during Transmission (%)per_tx_drop
Interface Drops while Receiving (%)Interface Drops while Receiving (%)per_rx_drop
Interface Errors during Transmission (%)Interface Errors during Transmission (%)per_tx_errs
Interface Errors while Receiving (%)Interface Errors while Receiving (%)per_rx_errs
Limit Exceeded Rate (PPS) - AWS OnlyThe number of packets that exceed the maximum for the instance type that are processed (bidirectionally) by the Aviatrix gateway per second.rate_pps_limit_exceeded
Linklocal Limit ExceededLinklocal Limit Exceededlinklocal_limit_exceeded
Linklocal Limit Exceeded (%)Linklocal Limit Exceeded (%)per_linklocal_limit_exceeded
Linklocal Limit Exceeded RateLinklocal Limit Exceeded Raterate_linklocal_limit_exceeded
Multicast Packets ReceivedMulticast Packets Receivedrx_multicast
Multicast Packets Received RateThe number of multicast packets per second.rate_rx_multicast
PPS Limit ExceededThe count of bidirectional packets that exceed the maximum for the instance type and are handled by the Aviatrix gateway.pps_limit_exceeded20
PPS Limit Exceeded Drop (%)PPS Limit Exceeded Drop (%)per_pps_limit_exceeded
Packet Drop (%)Packet Drop (%)per_pkt_drop
Packet Drop RateThe rate at which packets are dropped per second.rate_pkt_drop20
Packet Failure (%)Packet Failure (%)per_pkt_fail
Packet Failure RatePacket Failure Raterate_pkt_fail
Packets Dropped during TransmissionThe count of packets that were dropped during transmission, often due to resource constraints.tx_drop20
Packets Dropped while ReceivingThe count of received packets that were not processed, typically due to resource limitations or unsupported protocols.rx_drop20
Peak Received RatePeak Received Raterate_peak_received
Peak Total RatePeak Total Raterate_peak_total
Peak Transmitted RatePeak Transmitted Raterate_peak_sent
Received BytesReceived Bytesrx_bytes
Received Frames RateReceived Frame Rate The number of frame alignment errors per second when receiving packets. On AWS, this may occur due to RX buffer overruns on physical interfaces, which can result in packet drops by the NIC.rate_rx_frame
Received PacketsReceived Packetsrx_packets
Received RateReceived Raterate_received20
Received Rate (PPS)Packets Received Rate — The total (received) transmission in packet level per second.pkt_rx_rate
Receiver FIFO FramesReceiver FIFO Framesrx_fifo
Receiver FIFO Frames RateThe number of overflow events per second when receiving packets.rate_rx_fifo
Received FramesReceived Framesrx_frame
Total Attempted RateTotal Attempted Raterate_pkt_attempted
Total RateThe total (bidirectional) rate of bits processed per second by the interface on the Aviatrix VM/instance.rate_total20
Total Rate (in packets)The total (bidirectional) transmission in packet level per second. Instance size impacts how many packets per second the gateway can handle.pkt_rate_total
Transmission FIFO Frames RateThe number of frame transmission errors per second due to device FIFO underrun/underflow.rate_tx_fifo
Transmission FIFO FramesThe number of frame transmission errors due to device FIFO underrun/underflow.tx_fifo
Transmitted BytesTransmitted Bytestx_bytes
Transmitted Carrier FramesTransmitted Carrier Framestx_carrier
Transmitted Carrier Frames RateTransmitted Carrier Frames Raterate_tx_carrier
Transmitted PacketsTransmitted Packetstx_packets
Transmitted RateThe rate of bits per second that has been transmitted by the interface on the Aviatrix gateway VM/instance.rate_sent20
Transmitted Rate (PPS)Transmitted Rate (PPS)pkt_tx_rate