为 .NET 发出的 DNS 指标定义的语义约定

状态: 稳定

本文档定义了 .NET 发出的 DNS 指标的语义约定。

DNS 指标

指标： dns.lookup.duration

此指标 SHOULD 使用 ExplicitBucketBoundaries，其值为 [ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10 ]。

名称Instrument TypeUnit (UCUM)描述
dns.lookup.durationHistograms测量执行 DNS 查询所花费的时间。[1]

[1]: Meter name: System.Net.NameResolution; Added in: .NET 8.0

属性类型描述示例需求级别
dns.question.name字符串正在查询的名称。[1]www.example.com; dot.net必需
error.type字符串解析错误之一或异常类型的完整名称。[2]host_not_found; no_recovery; System.Net.Sockets.SocketException条件要求：如果且仅当发生错误时。

[1]: 要查询的名称。如果名称字段包含不可打印字符（低于 32 或高于 126），则这些字符应表示为转义的十进制整数（\DDD）。反斜杠和引号应进行转义。制表符、回车符和换行符应分别转换为 \t、\r 和 \n。

[2]: 报告以下错误代码

  • “host_not_found”
  • “try_again”
  • “address_family_not_supported”
  • “no_recovery”

有关更多详细信息，请参阅 SocketError。

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

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