NFS 指标的语义约定

状态: 开发中

本文档描述了 NFS 和 NFSD 指标的仪器和属性。

NFS 指标

指标：nfs.client.net.count

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nfs.client.net.count	Counter	{record}	报告内核 NFS 客户端 TCP 段和 UDP 数据报的处理计数。 [1]		host

[1]: Linux：此指标取自 Linux 内核的 svc_stat.netudpcnt 和 svc_stat.nettcpcnt。

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
network.transport		推荐	字符串	OSI 传输层或进程间通信方法。[1]	tcp；udp

[1] network.transport: 该值应标准化为小写。

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

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

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

指标：nfs.client.net.tcp.connection.accepted

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nfs.client.net.tcp.connection.accepted	Counter	{connection}	报告内核 NFS 客户端 TCP 连接接受的计数。 [1]		host

[1]: Linux：此指标取自 Linux 内核的 svc_stat.nettcpconn。

指标：nfs.client.rpc.count

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nfs.client.rpc.count	Counter	{request}	报告发送的内核 NFS 客户端 RPC 计数，无论它们是否被服务器接受/拒绝。 [1]		host

[1]: Linux：此指标取自 Linux 内核的 svc_stat.rpccnt。

指标：nfs.client.rpc.retransmit.count

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nfs.client.rpc.retransmit.count	Counter	{retransmit}	报告内核 NFS 客户端 RPC 重传的计数。 [1]		host

[1]: Linux：此指标取自 Linux 内核的 svc_stat.rpcretrans。

指标：nfs.client.rpc.authrefresh.count

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nfs.client.rpc.authrefresh.count	Counter	{authrefresh}	报告内核 NFS 客户端 RPC 身份验证刷新的计数。 [1]		host

[1]: Linux：此指标取自 Linux 内核的 svc_stat.rpcauthrefresh。

指标：nfs.client.operation.count

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nfs.client.operation.count	Counter	{operation}	报告内核 NFSv4+ 客户端操作的计数。		host

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
nfs.operation.name		推荐	字符串	NFSv4+ 操作名称。	OPEN; READ; GETATTR
onc_rpc.version		推荐	int	ONC/Sun RPC 程序版本。

指标：nfs.client.procedure.count

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nfs.client.procedure.count	Counter	{procedure}	报告内核 NFS 客户端过程的计数。		host

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
onc_rpc.procedure.name		推荐	字符串	ONC/Sun RPC 过程名称。	OPEN; READ; GETATTR
onc_rpc.version		推荐	int	ONC/Sun RPC 程序版本。

NFSD 指标

指标：nfs.server.repcache.requests

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nfs.server.repcache.requests	Counter	{request}	根据缓存命中状态报告内核 NFS 服务器应答缓存的请求计数。		host

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
nfs.server.repcache.status		推荐	字符串	Linux：可以是“hit”（NFSD_STATS_RC_HITS）、“miss”（NFSD_STATS_RC_MISSES）或“nocache”（NFSD_STATS_RC_NOCACHE - 不可缓存）之一。	hit

指标：nfs.server.fh.stale.count

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nfs.server.fh.stale.count	Counter	{fh}	报告内核 NFS 服务器陈旧文件句柄的计数。 [1]		host

[1]: Linux：此指标取自 nfsd_net 结构中的 Linux 内核 NFSD_STATS_FH_STALE 计数器。

指标：nfs.server.io

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nfs.server.io	Counter	每个调用的最大内存使用量的分布。	报告内核 NFS 服务器返回给接收和传输（读取和写入）请求的字节计数。 [1]		host

[1]: Linux：此指标取自 nfsd_net 结构中的 Linux 内核 NFSD_STATS_IO_READ 和 NFSD_STATS_IO_WRITE 计数器。

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
network.io.direction		推荐	字符串	网络 IO 操作方向。	transmit

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

值	描述	Stability
receive	receive
transmit	transmit

指标：nfs.server.thread.count

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nfs.server.thread.count	UpDownCounter	{thread}	报告内核 NFS 服务器可用线程的计数。 [1]		host

[1]: Linux：此指标取自 Linux 内核的 nfsd_th_cnt 变量。

指标：nfs.server.net.count

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nfs.server.net.count	Counter	{record}	报告内核 NFS 服务器 TCP 段和 UDP 数据报的处理计数。 [1]		host

[1]: Linux：此指标取自 Linux 内核的 svc_stat.nettcpcnt 和 svc_stat.netudpcnt。

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
network.transport		推荐	字符串	OSI 传输层或进程间通信方法。[1]	tcp；udp

[1] network.transport: 该值应标准化为小写。

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

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

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

指标：nfs.server.net.tcp.connection.accepted

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nfs.server.net.tcp.connection.accepted	Counter	{connection}	报告内核 NFS 服务器 TCP 连接接受的计数。 [1]		host

[1]: Linux：此指标取自 Linux 内核的 svc_stat.nettcpconn。

指标：nfs.server.rpc.count

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nfs.server.rpc.count	Counter	{request}	报告内核 NFS 服务器处理的 RPC 计数。 [1]		host

[1]: Linux：此指标取自 Linux 内核的 svc_stat.rpccnt，即正常 RPC 的计数。此指标的 error.type 可能为“format”、“auth”或“client”，分别对应 svc_stat.badfmt、svc_stat.badauth 和 svc_stat.badclnt。

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
error.type		推荐	字符串	描述操作最终结束的一类错误。[1]	timeout；java.net.UnknownHostException；server_certificate_invalid；500

[1] error.type： error.type 应该可预测，并且应该具有低基数性。

当 error.type 设置为某个类型（例如，异常类型）时，应该使用该工件内识别类型的规范类名。

Instrumentations 应该记录它们报告的错误列表。

一个仪器库内的 error.type 基数性应该低。从多个仪器库和应用程序聚合数据的遥测消费者，在没有额外过滤时，应准备好 error.type 在查询时具有高基数性。

如果操作已成功完成，Instrumentations 不应设置 error.type。

如果特定域定义了自己的一组错误标识符（例如 HTTP 或 gRPC 状态码），则建议

• 使用特定于域的属性
• 设置 error.type 以捕获所有错误，无论它们是否包含在特定于域的集合中。

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

值	描述	Stability
_OTHER	当检测不到自定义值时使用的回退错误值。

指标：nfs.server.operation.count

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nfs.server.operation.count	Counter	{operation}	报告内核 NFSv4+ 服务器操作的计数。		host

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
nfs.operation.name		推荐	字符串	NFSv4+ 操作名称。	OPEN; READ; GETATTR
onc_rpc.version		推荐	int	ONC/Sun RPC 程序版本。

指标：nfs.server.procedure.count

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nfs.server.procedure.count	Counter	{procedure}	报告内核 NFS 服务器过程的计数。		host

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
onc_rpc.procedure.name		推荐	字符串	ONC/Sun RPC 过程名称。	OPEN; READ; GETATTR
onc_rpc.version		推荐	int	ONC/Sun RPC 程序版本。