この記事は英語の原文を日本語に翻訳したものです。原文: https://opentelemetry.io/docs/specs/semconv/nfs/nfs-metrics/
翻訳元: open-telemetry/semantic-conventions v1.44.0（コミット e10a930）
NFSメトリクスに関するセマンティック規約
ステータス: Development
この文書では、NFSおよびNFSDのメトリクスに関するInstrumentと属性を記述します。
NFSメトリクス
メトリクス: nfs.client.net.count
このメトリクスはrecommendedです。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nfs.client.net.count | Counter | {record} | 処理された、カーネルのNFSクライアントTCPセグメントとUDPデータグラムの数を報告します。[1] |  | host |
[1]: Linux: このメトリクスは、Linuxカーネルのsvc_stat.netudpcntとsvc_stat.nettcpcntから取得されます。
Attributes:
| Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|
network.transport |  | Recommended | string | OSIトランスポート層またはプロセス間通信の方式。[1] | tcp; udp |
[1] network.transport: この値は小文字に正規化されるべきです（SHOULD）。
ポート番号を設定する際は、常にトランスポートも設定することを検討してください。トランスポートが分からなければ、ポート番号は曖昧になるためです。たとえば、異なるプロセスがTCPポート12345とUDPポート12345の両方でリスンしている場合があります。
network.transportには、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。
| Value | Description | Stability |
|---|---|---|
pipe | 名前付き、または匿名のパイプ。 | |
quic | QUIC | |
tcp | TCP | |
udp | UDP | |
unix | UNIXドメインソケット | |
メトリクス: nfs.client.net.tcp.connection.accepted
このメトリクスはrecommendedです。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nfs.client.net.tcp.connection.accepted | Counter | {connection} | 受け付けられた、カーネルのNFSクライアントTCP接続数を報告します。[1] | | host |
[1]: Linux: このメトリクスは、Linuxカーネルのsvc_stat.nettcpconnから取得されます。
メトリクス: nfs.client.rpc.count
このメトリクスはrecommendedです。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nfs.client.rpc.count | Counter | {request} | サーバーによって受理・拒否されたかにかかわらず、送信された、カーネルのNFSクライアントRPC数を報告します。[1] | | host |
[1]: Linux: このメトリクスは、Linuxカーネルのsvc_stat.rpccntから取得されます。
メトリクス: nfs.client.rpc.retransmit.count
このメトリクスはrecommendedです。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nfs.client.rpc.retransmit.count | Counter | {retransmit} | カーネルのNFSクライアントRPC再送数を報告します。[1] | | host |
[1]: Linux: このメトリクスは、Linuxカーネルのsvc_stat.rpcretransから取得されます。
メトリクス: nfs.client.rpc.authrefresh.count
このメトリクスはrecommendedです。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nfs.client.rpc.authrefresh.count | Counter | {authrefresh} | カーネルのNFSクライアントRPC認証リフレッシュ数を報告します。[1] | | host |
[1]: Linux: このメトリクスは、Linuxカーネルのsvc_stat.rpcauthrefreshから取得されます。
メトリクス: nfs.client.operation.count
このメトリクスはrecommendedです。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nfs.client.operation.count | Counter | {operation} | カーネルのNFSv4+クライアント操作数を報告します。 | | host |
Attributes:
| Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|
nfs.operation.name | | Recommended | string | NFSv4+の操作名。 | OPEN; READ; GETATTR |
onc_rpc.version | | Recommended | int | ONC/Sun RPCのプログラムバージョン。 |
メトリクス: nfs.client.procedure.count
このメトリクスはrecommendedです。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nfs.client.procedure.count | Counter | {procedure} | カーネルのNFSクライアントプロシージャ数を報告します。 | | host |
Attributes:
| Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|
onc_rpc.procedure.name | | Recommended | string | ONC/Sun RPCのプロシージャ名。 | OPEN; READ; GETATTR |
onc_rpc.version | | Recommended | int | ONC/Sun RPCのプログラムバージョン。 |
NFSDメトリクス
メトリクス: nfs.server.repcache.requests
このメトリクスはrecommendedです。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nfs.server.repcache.requests | Counter | {request} | キャッシュヒットの状態別に、カーネルのNFSサーバーリプライキャッシュのリクエスト数を報告します。 | | host |
Attributes:
| Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|
nfs.server.repcache.status | | Recommended | string | Linux: “hit”（NFSD_STATS_RC_HITS）、“miss”（NFSD_STATS_RC_MISSES）、“nocache”（NFSD_STATS_RC_NOCACHE、キャッシュ不可）のいずれか。 | hit |
メトリクス: nfs.server.fh.stale.count
このメトリクスはrecommendedです。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nfs.server.fh.stale.count | Counter | {fh} | カーネルのNFSサーバーの無効なファイルハンドル数を報告します。[1] | | host |
[1]: Linux: このメトリクスは、nfsd_net構造体内のLinuxカーネルのNFSD_STATS_FH_STALEカウンタから取得されます。
メトリクス: nfs.server.io
このメトリクスはrecommendedです。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nfs.server.io | Counter | By | 受信・送信（読み取り・書き込み）リクエストに対して返された、カーネルのNFSサーバーのバイト数を報告します。[1] | | host |
[1]: Linux: このメトリクスは、nfsd_net構造体内のLinuxカーネルのNFSD_STATS_IO_READカウンタとNFSD_STATS_IO_WRITEカウンタから取得されます。
Attributes:
| Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|
network.io.direction |  | Recommended | string | 観測を行うホストの物理・仮想ネットワークインターフェースの視点から見た通信の方向。ステートフルな接続やネットワークフローの論理的な方向を表すために使用すべきではありません（should not）。 | transmit |
network.io.directionには、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。
| Value | Description | Stability |
|---|---|---|
receive | receive | |
transmit | transmit | |
メトリクス: nfs.server.thread.count
このメトリクスはrecommendedです。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nfs.server.thread.count | UpDownCounter | {thread} | カーネルのNFSサーバーの利用可能なスレッド数を報告します。[1] | | host |
[1]: Linux: このメトリクスは、Linuxカーネルのnfsd_th_cnt変数から取得されます。
メトリクス: nfs.server.net.count
このメトリクスはrecommendedです。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nfs.server.net.count | Counter | {record} | 処理された、カーネルのNFSサーバーTCPセグメントとUDPデータグラムの数を報告します。[1] | | host |
[1]: Linux: このメトリクスは、Linuxカーネルのsvc_stat.nettcpcntとsvc_stat.netudpcntから取得されます。
Attributes:
| Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|
network.transport | | Recommended | string | OSIトランスポート層またはプロセス間通信の方式。[1] | tcp; udp |
[1] network.transport: この値は小文字に正規化されるべきです（SHOULD）。
ポート番号を設定する際は、常にトランスポートも設定することを検討してください。トランスポートが分からなければ、ポート番号は曖昧になるためです。たとえば、異なるプロセスがTCPポート12345とUDPポート12345の両方でリスンしている場合があります。
network.transportには、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。
| Value | Description | Stability |
|---|---|---|
pipe | 名前付き、または匿名のパイプ。 | |
quic | QUIC | |
tcp | TCP | |
udp | UDP | |
unix | UNIXドメインソケット | |
メトリクス: nfs.server.net.tcp.connection.accepted
このメトリクスはrecommendedです。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nfs.server.net.tcp.connection.accepted | Counter | {connection} | 受け付けられた、カーネルのNFSサーバーTCP接続数を報告します。[1] | | host |
[1]: Linux: このメトリクスは、Linuxカーネルのsvc_stat.nettcpconnから取得されます。
メトリクス: nfs.server.rpc.count
このメトリクスはrecommendedです。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nfs.server.rpc.count | Counter | {request} | 処理された、カーネルのNFSサーバーRPC数を報告します。[1] | | host |
[1]: Linux: このメトリクスは、正常なRPC数であるLinuxカーネルのsvc_stat.rpccntから取得されます。このメトリクスは、svc_stat.badfmt、svc_stat.badauth、svc_stat.badclntについて、それぞれ"format"、“auth”、“client"のerror.typeを持つ場合があります。
Attributes:
| Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|
error.type | | Recommended | string | 操作が終了したエラーのクラスを記述します。[1] | timeout; java.net.UnknownHostException; server_certificate_invalid; 500 |
[1] error.type: error.typeは予測可能であるべきであり（SHOULD）、カーディナリティが低いべきです（SHOULD）。
error.typeに型（たとえば例外の型）を設定する場合、そのアーティファクト内でその型を識別する正規のクラス名を使用すべきです（SHOULD）。
記録されたエラー型が、失敗の分類にとって意味を持たないラッパーである場合、計装は内側のエラーの型を代わりに使用してもかまいません（MAY）。たとえばGoでは、ラッパー型が失敗の分類に役立たない場合、%wを使ってfmt.Errorfで作成されたエラーをアンラップしてもかまいません（MAY）。
計装は、報告するエラーの一覧を文書化すべきです（SHOULD）。
1つの計装ライブラリ内におけるerror.typeのカーディナリティは低くあるべきです（SHOULD）。複数の計装ライブラリやアプリケーションからのデータを集約するテレメトリーの利用者は、追加のフィルタが適用されない場合、クエリ実行時にerror.typeが高いカーディナリティを持つことを想定しておくべきです（should）。
操作が正常に完了した場合、計装はerror.typeを設定すべきではありません（SHOULD NOT）。
特定のドメインが独自のエラー識別子の集合（HTTPやRPCのステータスコードなど）を定義している場合、次のことが推奨されます（RECOMMENDED）。
- ドメイン固有の属性を使用する。
- そのドメイン固有の集合に定義されているかどうかにかかわらず、すべてのエラーを捕捉するように
error.typeを設定する。
error.typeには、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。
| Value | Description | Stability |
|---|---|---|
_OTHER | 計装が独自の値を定義していない場合に使用するフォールバック用のエラー値。 | |
メトリクス: nfs.server.operation.count
このメトリクスはrecommendedです。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nfs.server.operation.count | Counter | {operation} | カーネルのNFSv4+サーバー操作数を報告します。 | | host |
Attributes:
| Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|
nfs.operation.name | | Recommended | string | NFSv4+の操作名。 | OPEN; READ; GETATTR |
onc_rpc.version | | Recommended | int | ONC/Sun RPCのプログラムバージョン。 |
メトリクス: nfs.server.procedure.count
このメトリクスはrecommendedです。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nfs.server.procedure.count | Counter | {procedure} | カーネルのNFSサーバープロシージャ数を報告します。 | | host |
Attributes:
| Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|
onc_rpc.procedure.name | | Recommended | string | ONC/Sun RPCのプロシージャ名。 | OPEN; READ; GETATTR |
onc_rpc.version | | Recommended | int | ONC/Sun RPCのプログラムバージョン。 |