OTEP-0010: メトリクスAPIにおける「Cumulative」から「Counter」への名称変更

「Cumulative」ではなく「Counter」という名前を優先します。

動機

非公式な言い方をすれば、OpenTelemetryコミュニティのメンバーは、Cumulativeメトリクスインストルメントを「カウンター（Counter）」と呼ぶことを好んでいるようです。この点は、（たとえば8/21のワーキングセッションでの）議論の中で明らかになってきました。

Counterは、他の種類であるGaugeやMeasureと同じく名詞です。 Cumulativeは形容詞なので、「Cumulative instrument」は意味が通りますが、それが表しているのは「Counter」です。

これにより、これらのAPIについて話すときに「cumulative」を「counter」に読み替えるという認知コストがなくなります。

これは累積型のメトリクスインストルメントに対して使われている用語であり、たとえばStatsdやPrometheusがその例です。

しかし、私たちはCounterの重要なサブケースを特定しており、それらは次のように扱われます。カウンターにはオプションがあります。

ゲージは、（たとえばCPU使用率のような）非減少の量を監視するために使われることがあり、オプションとして次のように扱われます。

単方向ゲージインストルメントは、観測される値が累積的であるメトリクスの Observer コールバックで一般的に使用されます。

真に累積的なカウンターと双方向カウンターの違いを説明する他の方法としては、次のようなものがあります。

これらすべてのケースを「Counter」という広い用語にまとめてしまうことは、解決するよりも多くの混乱を生む可能性があります。

単純にすべての「Cumulative」を「Counter」に置き換え、その後文法に合わせて編集します。

既存のメトリクスライブラリを調査したところ、Counterの方がはるかに一般的です。