<!--startmeta
custom_edit_url: "https://github.com/netdata/netdata/edit/master/src/collectors/network-viewer.plugin/README.md"
meta_yaml: "https://github.com/netdata/netdata/edit/master/src/collectors/network-viewer.plugin/metadata.yaml"
sidebar_label: "Network Connections"
learn_status: "Published"
learn_rel_path: "Collecting Metrics/Collectors/Networking"
keywords: ['network', 'connections', 'sockets', 'tcp', 'udp', 'ports']
message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE COLLECTOR'S metadata.yaml FILE"
endmeta-->

# Network Connections


<img src="https://netdata.cloud/img/network.svg" width="150"/>


Plugin: network-viewer.plugin
Module: network-viewer.plugin

<img src="https://img.shields.io/badge/maintained%20by-Netdata-%2300ab44" />

## Overview



This plugin reads the system's socket tables to enumerate all active network connections,
including TCP and UDP sockets in all states, for both IPv4 and IPv6.


This collector is only supported on the following platforms:

- Linux

This collector only supports collecting metrics from a single instance of this integration.


### Default Behavior

#### Auto-Detection

The plugin automatically detects all active network connections on the system.


#### Limits

The default configuration for this integration does not impose any limits on data collection.

#### Performance Impact

The default configuration for this integration is not expected to impose a significant performance impact on the system.

## Setup


### Prerequisites

No action required.

### Configuration

#### Options



There are no configuration options.



#### via File

There is no configuration file.

##### Examples
There are no configuration examples.



## Alerts

There are no alerts configured by default for this integration.


## Metrics




## Live Data

This plugin exposes a real-time function for viewing active network connections.


### Network Connections

Shows active network connections with protocol details, states, addresses, ports, and performance metrics.

Provides both aggregated and detailed views of TCP and UDP connections for IPv4 and IPv6,
including connection direction (listen, inbound, outbound, local), process information,
and TCP performance metrics (RTT, retransmissions).

Connections are classified as system or container based on network namespace.


| Aspect | Description |
|:-------|:------------|
| Name | `Network-viewer.plugin:network-connections` |
| Require Cloud | no |
| Performance |  |
| Security |  |
| Availability |  |

#### Prerequisites

No additional configuration is required.

#### Parameters

This function has no parameters.

#### Returns



| Column | Type | Unit | Visibility | Description |
|:-------|:-----|:-----|:-----------|:------------|


