Network

These attributes may be used for any network related operation.

Network Attributes

Attribute	Type	Description	Examples	Stability
network.carrier.icc	string	The ISO 3166-1 alpha-2 2-character country code associated with the mobile carrier network.	DE
network.carrier.mcc	string	The mobile carrier country code.	310
network.carrier.mnc	string	The mobile carrier network code.	001
network.carrier.name	string	The name of the mobile carrier.	sprint
network.connection.subtype	string	This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a wifi connection.	LTE
network.connection.type	string	The internet connection type.	wifi
network.io.direction	string	The network IO operation direction.	transmit
network.local.address	string	Local address of the network connection - IP address or Unix domain socket name.	10.1.2.80; /tmp/my.sock
network.local.port	int	Local port number of the network connection.	65123
network.peer.address	string	Peer address of the network connection - IP address or Unix domain socket name.	10.1.2.80; /tmp/my.sock
network.peer.port	int	Peer port number of the network connection.	65123
network.protocol.name	string	OSI application layer or non-OSI equivalent. [1]	amqp; http; mqtt
network.protocol.version	string	The actual version of the protocol used for network communication. [2]	1.1; 2
network.transport	string	OSI transport layer or inter-process communication method. [3]	tcp; udp
network.type	string	OSI network layer or non-OSI equivalent. [4]	ipv4; ipv6

[1]: The value SHOULD be normalized to lowercase.

[2]: If protocol version is subject to negotiation (for example using ALPN), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.

[3]: The value SHOULD be normalized to lowercase.

Consider always setting the transport when setting a port number, since a port number is ambiguous without knowing the transport. For example different processes could be listening on TCP port 12345 and UDP port 12345.

[4]: The value SHOULD be normalized to lowercase.

network.connection.subtype has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

Value	Description	Stability
gprs	GPRS
edge	EDGE
umts	UMTS
cdma	CDMA
evdo_0	EVDO Rel. 0
evdo_a	EVDO Rev. A
cdma2000_1xrtt	CDMA2000 1XRTT
hsdpa	HSDPA
hsupa	HSUPA
hspa	HSPA
iden	IDEN
evdo_b	EVDO Rev. B
lte	LTE
ehrpd	EHRPD
hspap	HSPAP
gsm	GSM
td_scdma	TD-SCDMA
iwlan	IWLAN
nr	5G NR (New Radio)
nrnsa	5G NRNSA (New Radio Non-Standalone)
lte_ca	LTE CA

network.connection.type has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

Value	Description	Stability
wifi	wifi
wired	wired
cell	cell
unavailable	unavailable
unknown	unknown

network.io.direction MUST be one of the following:

Value	Description	Stability
transmit	transmit
receive	receive

network.transport has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

Value	Description	Stability
tcp	TCP
udp	UDP
pipe	Named or anonymous pipe.
unix	Unix domain socket

network.type has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

Value	Description	Stability
ipv4	IPv4
ipv6	IPv6

Deprecated Network Attributes

Attribute	Type	Description	Examples	Stability
net.host.name	string	Deprecated, use server.address.	example.com	Replaced by server.address.
net.host.port	int	Deprecated, use server.port.	8080	Replaced by server.port.
net.peer.name	string	Deprecated, use server.address on client spans and client.address on server spans.	example.com	Replaced by server.address on client spans and client.address on server spans.
net.peer.port	int	Deprecated, use server.port on client spans and client.port on server spans.	8080	Replaced by server.port on client spans and client.port on server spans.
net.protocol.name	string	Deprecated, use network.protocol.name.	amqp; http; mqtt	Replaced by network.protocol.name.
net.protocol.version	string	Deprecated, use network.protocol.version.	3.1.1	Replaced by network.protocol.version.
net.sock.family	string	Deprecated, use network.transport and network.type.	inet	Split to network.transport and network.type.
net.sock.host.addr	string	Deprecated, use network.local.address.	/var/my.sock	Replaced by network.local.address.
net.sock.host.port	int	Deprecated, use network.local.port.	8080	Replaced by network.local.port.
net.sock.peer.addr	string	Deprecated, use network.peer.address.	192.168.0.1	Replaced by network.peer.address.
net.sock.peer.name	string	Deprecated, no replacement at this time.	/var/my.sock	Removed.
net.sock.peer.port	int	Deprecated, use network.peer.port.	65531	Replaced by network.peer.port.
net.transport	string	Deprecated, use network.transport.	ip_tcp	Replaced by network.transport.

net.sock.family has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

Value	Description	Stability
inet	IPv4 address
inet6	IPv6 address
unix	Unix domain socket path

net.transport has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

Value	Description	Stability
ip_tcp	ip_tcp
ip_udp	ip_udp
pipe	Named or anonymous pipe.
inproc	In-process communication. [1]
other	Something else (non IP-based).

[1]: Signals that there is only in-process communication not using a “real” network protocol in cases where network attributes would normally be expected. Usually all other network attributes can be left out in that case.