Network Metrics
Documentation for network performance metrics.
Metrics
net.bytesRX
The total number of bytes received by a network interface.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | MAX_UNSIGNED_LONG |
B | raw | count |
net.bytesTX
The total number of bytes transmitted by a network interface.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | MAX_UNSIGNED_LONG |
B | raw | count |
net.carrierTX
The total number of loss-of-carrier-signal events detected by the device driver. If this value is high, especially when it has only been active for a short time, it means the connection is going up and down a lot. This can be caused by problems either on the device, the device on the other end, or a faulty ethernet cable plugged in to the device.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | MAX_UNSIGNED_LONG |
errors | raw | count |
net.collsTX
The number of packet collisions detected when transmitting. Packet collisions occur when multiple devices use a shared resource (such as an ethernet cable) to transmit a packet at the same time. Frequent packet collisions degrade network performance.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | MAX_UNSIGNED_LONG |
collisions | raw | count |
net.compressedRX
Number of compressed packets received by a network interface.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | MAX_UNSIGNED_LONG |
packets | raw | count |
net.compressedTX
Number of compressed packets sent by a network interface.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | MAX_UNSIGNED_LONG |
packets | raw | count |
net.dropRX
Number of packets dropped and otherwise not received by a network interface. This means that your system is unable to process incoming packets fast enough, overwhelming its buffer, or there is an issue in your cabling leading to packet loss.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | MAX_UNSIGNED_LONG |
packets | raw | count |
net.dropTX
Number of packets dropped by a network interface. This means that your system is unable to process outgoing packets fast enough, overwhelming its buffer.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | MAX_UNSIGNED_LONG |
packets | raw | count |
net.errsRX
Number of malformed packets received by a network interface. Errors are typically caused by bursts of traffic causing overloads, a speed/duplex mismatch with the connecting port on the other end, or a large number of security rules.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | MAX_UNSIGNED_LONG |
errors | raw | count |
net.errsTX
Number of errors detected by a network interface when transmitting. Errors are typically caused by bursts of traffic causing overloads, a speed/duplex mismatch with the connecting port on the other end, or a large number of security rules.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | MAX_UNSIGNED_LONG |
errors | raw | count |
net.fifoRX
The number of receiving queue errors detected by a network interface. This is often caused by receiving more packets than the computer can process, leading to buffer overflows.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | MAX_UNSIGNED_LONG |
errors | raw | count |
net.fifoTX
The number of transmitting queue errors detected by a network interface. This is often caused by trying to send more packets than the network connection can handle, leading to buffer overflows.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | MAX_UNSIGNED_LONG |
errors | raw | count |
net.frameRX
Number of packets received by an interface with framing errors. This is often a physical issue (faulty cables or bad Network Interface Card), though it may be caused by mismatched duplex settings.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | MAX_UNSIGNED_LONG |
errors | raw | count |
net.multicastRX
Number of multicast frames received by a network interface.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | MAX_UNSIGNED_LONG |
frames | raw | count |
net.packetsRX
Number of packets received by a network interface.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | MAX_UNSIGNED_LONG |
packets | raw | count |
net.packetsTX
Number of packets transmitted by a network interface.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | MAX_UNSIGNED_LONG |
packets | raw | count |
net.utilizationRX
Percentage of a network interface's maximum bandwidth being used for receiving packets.
Note: The data received is reported in bytes
while bandwidth is in megabits per second
, so some conversion is necessary to ensure the units match.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | 1 | utilization | derived | percentage |
net.utilizationTX
Percentage of a network interface's maximum bandwidth being used for transmitting packets.
Note: The data transmitted is reported in bytes
while bandwidth is in megabits per second
, so some conversion is necessary to ensure the units match.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | 1 | utilization | derived | percentage |
net.utilizationRXAverage
Average percentage of the maximum bandwidth across all interfaces (except loopback) being used for receiving packets.
Note: The data received is reported in bytes
while bandwidth is in megabits per second
, so some conversion is necessary to ensure the units match.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | 1 | utilization | derived | percentage |
net.utilizationTXAverage
Average percentage of the maximum bandwidth across all interfaces (except loopback) being used for transmitting packets.
Note: The data transmitted is reported in bytes
while bandwidth is in megabits per second
, so some conversion is necessary to ensure the units match.
Min | Max | Units | Metric Type | Data Type |
---|---|---|---|---|
0 | 1 | utilization | derived | percentage |
Contributing
To contribute to this documentation, see the contributing guide. Any updates to the documentation should be tagged.
$ git tag -a <major.minor.patch> -m "[UPDATE] version."
$ git push origin <major.minor.patch>
Use semantic versioning (semvar) for communicating versions.
- Any new metrics should be communicated as
minor
updates. - Any corrections/value modifications should be
patches
. - Any documentation restructuring (changing field names, removing fields, etc) should be communicated as a
major
update.
Usage
The documentation is stored as JSON, a lightweight data-interchange format. Many languages provide JSON support: JavaScript, Python, Go, PHP, Java, Haskell, and others.
You are free to use the JSON documentation, as is. Simply copy the file and use accordingly.
For those using package managers to manage dependencies, we provide package manager support, as outlined below.
Bower
The documentation is registered as a Bower package. Bower provides a straightforward means for managing dependencies.
In order to use Bower, you must first install Node.js and Git. Once the prerequisites are installed,
$ npm install -g bower
To install the latest documentation,
$ bower install doc-metrix-network
Bower will place the documentation in a bower_components/
directory within the current working directory.
To update to the latest documentation,
$ bower update doc-metrix-network
Utilities
List of utilities using this documentation:
License
Copyright
Copyright © 2014. NodePrime.