この記事は英語の原文を日本語に翻訳したものです。原文: https://opentelemetry.io/docs/specs/semconv/dns/dns-metrics/
翻訳元: open-telemetry/semantic-conventions v1.44.0（コミット e10a930）
DNSクエリに関するセマンティック規約
ステータス: Development
この文書では、DNSクエリを計装するときに適用するセマンティック規約を定義します。
メトリクス
メトリクス: dns.lookup.duration
このメトリクスはopt-inです。
このメトリクスは、[ 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）。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
dns.lookup.duration | Histogram | s | DNSルックアップの実行に要した時間を計測します。 |  |
Attributes:
| Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|
dns.question.name | | Required | string | クエリの対象となる名前。[1] | www.example.com; dot.net |
error.type |  | Conditionally Required if and only if an error has occurred. | string | DNSルックアップが失敗した原因となったエラーを記述します。[2] | host_not_found; no_recovery; java.net.UnknownHostException |
[1] dns.question.name: この名前は、追加の正規化を行わずDNSクエリに現れる形式のまま、クエリ対象のドメイン名を表します。
[2] error.type: 計装は、getaddrinfo（LinuxなどのPOSIXシステム / Windows）が報告するエラーコード、またはランタイムやクライアントライブラリが報告するエラーコードを使用すべきです（SHOULD）。エラーコードが利用できない場合は、例外型の完全な名前を使用すべきです（SHOULD）。
error.typeには、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。
| Value | Description | Stability |
|---|---|---|
_OTHER | 計装が独自の値を定義していない場合に使用するフォールバック用のエラー値。 | |