Yoshi Yamaguchi

この記事は英語の原文を日本語に翻訳したものです。原文: https://opentelemetry.io/docs/specs/semconv/dotnet/dotnet-dns-metrics/

翻訳元: open-telemetry/semantic-conventions v1.44.0（コミット e10a930）

.NETが発行するDNSメトリクスに関するセマンティック規約

ステータス: Stable

この記事では、.NETが発行するDNSメトリクスに関するセマンティック規約を定義します。

DNSメトリクス

メトリクス: dns.lookup.duration

このメトリクスは、[ 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 ] のExplicitBucketBoundaries advisoryパラメータを指定すべきです（SHOULD）。

NameInstrument TypeUnit (UCUM)Description
dns.lookup.durationHistogramsDNSルックアップの実行に要した時間を計測します。[1]

[1]: Meterの名前: System.Net.NameResolution; 追加されたバージョン: .NET 8.0

AttributeTypeDescriptionExamplesRequirement Level
dns.question.namestringクエリの対象となる名前。[1]www.example.com; dot.netRequired
error.typestring解決エラーのいずれか、または例外型の完全な名前。[2]host_not_found; no_recovery; System.Net.Sockets.SocketExceptionConditionally Required: if and only if an error has occurred.

[1]: クエリの対象となる名前です。 name フィールドに印字不可能な文字（32未満または126超）が含まれる場合、それらの文字はエスケープされた10進整数（\DDD）として表現されるべきです。バックスラッシュと引用符はエスケープされるべきです。タブ、キャリッジリターン、ラインフィードは、それぞれ\t、\r、\nに変換されるべきです。

[2]: 次のエラーコードが報告されます。

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

詳細はSocketErrorを参照してください。

error.typeには、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければならず、そうでない場合は、独自の値を使用してもかまいません。

ValueDescription
_OTHER計装が独自の値を定義していない場合に使用するフォールバック用のエラー値。