网络

• 网络属性
• 已弃用的网络属性

网络属性

这些属性可用于任何与网络相关的操作。

Attributes

键	Stability	Value Type	描述	Example Values
network.carrier.icc		字符串	与移动运营商网络关联的 ISO 3166-1 alpha-2 2 位国家/地区代码。	DE
network.carrier.mcc		字符串	移动运营商国家代码。	310
network.carrier.mnc		字符串	移动运营商网络代码。	001
network.carrier.name		字符串	移动运营商的名称。	sprint
network.connection.state		字符串	网络连接状态 [1]	close_wait
network.connection.subtype		字符串	这描述了 connection.type 的更多细节。它可能是蜂窝技术连接的类型，但也可能用于描述 Wi-Fi 连接的详细信息。	LTE
network.connection.type		字符串	互联网连接类型。	wifi
network.interface.name		字符串	网络接口名称。	lo; eth0
network.io.direction		字符串	网络 IO 操作方向。	transmit
network.local.address		字符串	网络连接的本地地址 - IP 地址或 Unix 域套接字名称。	10.1.2.80；/tmp/my.sock
network.local.port		int	网络连接的本地端口号。	65123
network.peer.address		字符串	网络连接的对端地址 - IP 地址或 Unix 域套接字名称。	10.1.2.80；/tmp/my.sock
network.peer.port		int	网络连接的对等端口号。	65123
network.protocol.name		字符串	OSI 应用层或非 OSI 等效层。[2]	amqp; http; mqtt
network.protocol.version		字符串	用于网络通信的协议的实际版本。[3]	1.1; 2
network.transport		字符串	OSI 传输层或进程间通信方法。[4]	tcp；udp
network.type		字符串	OSI 网络层或非 OSI 等效。 [5]	ipv4; ipv6

[1] network.connection.state: 连接状态定义在 rfc9293 中。

[2] network.protocol.name： 值应规范化为小写。

[3] network.protocol.version： 如果协议版本受协商（例如，使用 ALPN），则此属性应设置为协商后的版本。如果实际协议版本未知，则此属性不应设置。

[4] network.transport： 值应规范化为小写。

在设置端口号时，应始终考虑设置传输协议，因为没有传输协议的端口号是模糊的。例如，不同的进程可能正在监听 TCP 端口 12345 和 UDP 端口 12345。

[5] network.type: 值应标准化为小写。

network.connection.state 具有以下预定义值列表。如果其中一个适用，则必须使用相应的值；否则，可以使用自定义值。

值	描述	Stability
close_wait	close_wait
closed	closed
closing	closing
established	established
fin_wait_1	fin_wait_1
fin_wait_2	fin_wait_2
last_ack	last_ack
listen	listen
syn_received	syn_received
syn_sent	syn_sent
time_wait	time_wait

network.connection.subtype 具有以下预定义值列表。如果其中一个适用，则必须使用相应的值；否则，可以使用自定义值。

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

network.connection.type 具有以下预定义值列表。如果其中一个适用，则必须使用相应的值；否则，可以使用自定义值。

值	描述	Stability
cell	cell
unavailable	unavailable
unknown	unknown
wifi	wifi
wired	wired

network.io.direction 具有以下已知值列表。如果其中一个适用，则必须使用相应的值；否则，可以使用自定义值。

值	描述	Stability
receive	receive
transmit	transmit

network.transport 具有以下已知值列表。如果其中一个适用，则必须使用相应的_值_；否则，可以_使用_自定义值。

值	描述	Stability
pipe	命名或匿名管道。
quic	QUIC
tcp	TCP
udp	UDP
unix	Unix 域套接字

network.type 具有以下预定义值列表。如果其中一个适用，则必须使用相应的值；否则，可以使用自定义值。

值	描述	Stability
ipv4	IPv4
ipv6	IPv6

已弃用的网络属性

这些属性可用于任何与网络相关的操作。

Attributes

键	Stability	Value Type	描述	Example Values
net.host.ip	已替换为 network.local.address。	字符串	已弃用，请使用 network.local.address。	192.168.0.1
net.host.name	已替换为 server.address。	字符串	已弃用，请使用 server.address。	example.com
net.host.port	已替换为 server.port。	int	已弃用，请使用 server.port。	8080
net.peer.ip	已替换为 network.peer.address。	字符串	已弃用，请使用 network.peer.address。	127.0.0.1
net.peer.name	在客户端 span 中已替换为 server.address，在服务器 span 中已替换为 client.address。	字符串	已弃用，在客户端 span 中请使用 server.address，在服务器 span 中请使用 client.address。	example.com
net.peer.port	在客户端 span 中已替换为 server.port，在服务器 span 中已替换为 client.port。	int	已弃用，在客户端 span 中请使用 server.port，在服务器 span 中请使用 client.port。	8080
net.protocol.name	已替换为 network.protocol.name。	字符串	已弃用，请使用 network.protocol.name。	amqp; http; mqtt
net.protocol.version	已替换为 network.protocol.version。	字符串	已弃用，请使用 network.protocol.version。	3.1.1
net.sock.family	已拆分为 network.transport 和 network.type。	字符串	已弃用，请使用 network.transport 和 network.type。	inet; inet6; unix
net.sock.host.addr	已替换为 network.local.address。	字符串	已弃用，请使用 network.local.address。	/var/my.sock
net.sock.host.port	已替换为 network.local.port。	int	已弃用，请使用 network.local.port。	8080
net.sock.peer.addr	已替换为 network.peer.address。	字符串	已弃用，请使用 network.peer.address。	192.168.0.1
net.sock.peer.name	已移除。目前没有替代品。	字符串	已弃用，目前没有替代品。	/var/my.sock
net.sock.peer.port	已替换为 network.peer.port。	int	已弃用，请使用 network.peer.port。	65531
net.transport	已替换为 network.transport。	字符串	已弃用，请使用 network.transport。	ip_tcp; ip_udp; pipe

net.sock.family 具有以下预定义值列表。如果其中一个适用，则必须使用相应的值；否则，可以使用自定义值。

值	描述	Stability
inet	IPv4 地址
inet6	IPv6 地址
unix	Unix 域套接字路径

net.transport 具有以下预定义值列表。如果其中一个适用，则必须使用相应的值；否则，可以使用自定义值。

值	描述	Stability
inproc	进程内通信。 [6]
ip_tcp	ip_tcp
ip_udp	ip_udp
other	其他（非 IP 协议）。
pipe	命名或匿名管道。

[6]: 表示存在仅限于进程内的通信，未使用“真实”网络协议，在这种情况下通常会期望网络属性。通常情况下，所有其他网络属性都可以省略。