SignalR 服务器指标的语义约定

状态: 稳定

本文档定义了 .NET 组件和运行时发出的 SignalR 指标的语义约定。

指标: signalr.server.connection.duration

此指标应使用 ExplicitBucketBoundaries 指定，值为 [ 0.01, 0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 30, 60, 120, 300 ]。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
signalr.server.connection.duration	Histogram	s	服务器上连接的持续时间。[1]

[1]: Meter 名称: Microsoft.AspNetCore.Http.Connections；添加于：ASP.NET Core 8.0

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
signalr.connection.status		推荐	字符串	SignalR HTTP 连接关闭状态。	app_shutdown；timeout
signalr.transport		推荐	字符串	SignalR 传输类型	web_sockets；long_polling

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

值	描述	Stability
app_shutdown	应用程序正在关闭，连接已关闭。
normal_closure	连接已正常关闭。
timeout	连接因超时而关闭。

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

值	描述	Stability
long_polling	长轮询协议
server_sent_events	服务器发送事件协议
web_sockets	WebSockets 协议

指标: signalr.server.active_connections

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
signalr.server.active_connections	UpDownCounter	{connection}	服务器上当前活动的连接数。[1]

[1]: Meter 名称: Microsoft.AspNetCore.Http.Connections；添加于：ASP.NET Core 8.0

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
signalr.connection.status		推荐	字符串	SignalR HTTP 连接关闭状态。	app_shutdown；timeout
signalr.transport		推荐	字符串	SignalR 传输类型	web_sockets；long_polling

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

值	描述	Stability
app_shutdown	应用程序正在关闭，连接已关闭。
normal_closure	连接已正常关闭。
timeout	连接因超时而关闭。

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

值	描述	Stability
long_polling	长轮询协议
server_sent_events	服务器发送事件协议
web_sockets	WebSockets 协议