> Source: https://www.ymotongpoo.com/works/otel-specs-ja/semconv/cicd/cicd-metrics/ # CI/CDメトリクスに関するセマンティック規約 **ステータス**: [Mixed][DocumentStatus] ## CI/CDメトリクス この節で説明する規約は、継続的インテグレーション/継続的デプロイ（CI/CD）システムに固有のものです。 **免責事項:** これらは初期のCI/CDメトリクスと属性であり、将来さらに追加される可能性があります。 ### パイプライン実行ごとのメトリクスに関するガイダンス パイプライン実行ごとに固有のメトリクスを収集することが有用な場合があります。
そのようなメトリクスの例には次のものがあります。 * パイプライン実行が実行されるワーカーのCPU、メモリ、ディスクなどのホストメトリクス * CPU、メモリのリクエストやリミットなどのコンテナメトリクス * パイプライン実行の一部として実行されるプロセスのランタイムメトリクス（JVMメトリクスなど） これらのメトリクスは、ビルドの失敗を過負荷やメモリ不足といった環境上の問題と関連付けるために使用できます。また、パイプラインレベルの集計に使い、割り当てられたワーカーリソースの調整に役立てることもできます。 CI/CDパイプラインでホスト、コンテナ、ランタイム、その他のメトリクスを報告する際、計装の実装者とアプリケーション開発者は、適用可能な[CI/CDおよびVCSのリソース規約][cicdres]を使用すべきです（SHOULD）。また、すべてのメトリクスまたは特定のメトリクスを`cicd.pipeline.run`と関連付けて、実行情報と関連付けてもかまいません（MAY）。 [`cicd.pipeline.run`](https://opentelemetry.io/docs/specs/semconv/registry/entities/cicd/#cicd-pipeline-run) Entityは、パイプライン実行を識別します。これをメトリクスに関連付けると、本質的に高いカーディナリティが発生し、一部のメトリクス保存バックエンドではコストが増加する可能性があります。したがって、`cicd.pipeline.run` Entityはopt-inでなければなりません（MUST）。 [cicdres]: /works/otel-specs-ja/semconv/resource/cicd/ "CI/CDおよびVCSのリソース規約" ### メトリクス: `cicd.pipeline.run.duration` このメトリクスは[recommended][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `cicd.pipeline.run.duration` | Histogram | `s` | パイプライン、状態、結果でグループ化した、パイプライン実行の処理時間。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | [`cicd.pipeline`](https://opentelemetry.io/docs/specs/semconv/registry/entities/cicd/#cicd-pipeline) | **Attributes:** | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | | [`cicd.pipeline.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cicd/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | CI/CDシステム内のパイプラインの、人間が読める名前。 | `Build and Test`; `Lint`; `Deploy Go Project`; `deploy_to_environment` | | [`cicd.pipeline.run.state`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cicd/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | パイプライン実行は、そのライフサイクルの中でこれらの状態を経ます。 | `pending`; `executing`; `finalizing` | | [`cicd.pipeline.result`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cicd/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Conditionally Required` [1] | string | パイプライン実行の結果。 | `success`; `failure`; `timeout`; `skip` | | [`error.type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/error/) | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | `Conditionally Required` If and only if the pipeline run failed. | string | 操作が終了したエラーのクラスを記述します。[2] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` | **[1] `cicd.pipeline.result`:** その状態の間にパイプライン実行の結果が設定されている場合に限ります。 **[2] `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`を設定する。 --- `cicd.pipeline.result`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `cancellation` | パイプライン実行がキャンセルされました。たとえばユーザーが手動でキャンセルした場合。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `error` | CI/CDシステムでのエラー（ワーカーが強制終了された場合など）により、パイプライン実行が失敗しました。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `failure` | コンパイルエラーやテスト失敗などにより、パイプライン実行が正常に終了しませんでした。このような失敗は通常、パイプライン実行中に実行されたツールの非0の終了コードによって検出されます。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `skip` | 前提条件が満たされなかったなどの理由で、パイプライン実行がスキップされました。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `success` | パイプライン実行が正常に終了しました。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `timeout` | タイムアウトによってパイプライン実行が中断されました。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | --- `cicd.pipeline.run.state`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `executing` | executing状態は、（ビルドやテストなどの）実行タスクの実行にわたります。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `finalizing` | finalizing状態は、実行が完了した時点から（実行リソースのクリーンアップなど）にわたります。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `pending` | pending状態は、パイプライン実行を起動するイベントから、実行の開始までにわたります（キューでの待機時間、エージェントのプロビジョニング、実行リソースの作成などが含まれます）。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | --- `error.type`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `_OTHER` | 計装が独自の値を定義していない場合に使用するフォールバック用のエラー値。 | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | ### メトリクス: `cicd.pipeline.run.active` このメトリクスは[recommended][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `cicd.pipeline.run.active` | UpDownCounter | `{run}` | 状態別の、システム内で現在アクティブなパイプライン実行数。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | [`cicd.pipeline`](https://opentelemetry.io/docs/specs/semconv/registry/entities/cicd/#cicd-pipeline) | **Attributes:** | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | | [`cicd.pipeline.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cicd/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | CI/CDシステム内のパイプラインの、人間が読める名前。 | `Build and Test`; `Lint`; `Deploy Go Project`; `deploy_to_environment` | | [`cicd.pipeline.run.state`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cicd/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | パイプライン実行は、そのライフサイクルの中でこれらの状態を経ます。 | `pending`; `executing`; `finalizing` | --- `cicd.pipeline.run.state`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `executing` | executing状態は、（ビルドやテストなどの）実行タスクの実行にわたります。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `finalizing` | finalizing状態は、実行が完了した時点から（実行リソースのクリーンアップなど）にわたります。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `pending` | pending状態は、パイプライン実行を起動するイベントから、実行の開始までにわたります（キューでの待機時間、エージェントのプロビジョニング、実行リソースの作成などが含まれます）。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | ### メトリクス: `cicd.worker.count` このメトリクスは[recommended][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `cicd.worker.count` | UpDownCounter | `{worker}` | 状態別の、CI/CDシステム上のワーカー数。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | **Attributes:** | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | | [`cicd.worker.state`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cicd/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | CI/CDワーカー・エージェントの状態。 | `available`; `busy`; `offline` | --- `cicd.worker.state`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `available` | ワーカーはCI/CDシステムのために作業を実行していません。CI/CDシステムが作業を実行できる状態にあります（オンライン・アイドル）。[1] | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `busy` | ワーカーはCI/CDシステムのために作業を実行しています。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `offline` | ワーカーはCI/CDシステムから利用できません（切断・停止）。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | **[1]:** パイプラインには、実行可能なワーカーに関する条件が設定されている場合があるため、すべてのワーカーがすべてのパイプラインで利用可能とは限りません。 ### メトリクス: `cicd.pipeline.run.errors` このメトリクスは[recommended][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `cicd.pipeline.run.errors` | Counter | `{error}` | パイプライン実行中に遭遇したエラー数（コンパイルエラー、テスト失敗など）。[1] | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | [`cicd.pipeline`](https://opentelemetry.io/docs/specs/semconv/registry/entities/cicd/#cicd-pipeline) | **[1]:** パイプライン実行には、致命的でないエラー（抑制されるものなど）が存在する場合や、並列ステージにおいて複数のステージが致命的なエラーを持つ場合があります。 このため、このエラー数は、実行結果`failure`を持つメトリクス`cicd.pipeline.run.duration`の件数と一致しない場合があります。 **Attributes:** | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | | [`cicd.pipeline.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cicd/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | CI/CDシステム内のパイプラインの、人間が読める名前。 | `Build and Test`; `Lint`; `Deploy Go Project`; `deploy_to_environment` | | [`error.type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/error/) | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | `Required` | 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` | 計装が独自の値を定義していない場合に使用するフォールバック用のエラー値。 | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | ### メトリクス: `cicd.system.errors` このメトリクスは[recommended][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `cicd.system.errors` | Counter | `{error}` | CI/CDシステムのコンポーネント（コントローラー、スケジューラー、エージェントなど）で発生したエラー数。[1] | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | **[1]:** パイプライン実行の実行過程で発生するエラーは、明示的に除外されます。つまり、テストの失敗はこのメトリクスには含まれません。 **Attributes:** | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | | [`cicd.system.component`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cicd/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | CI/CDシステムのコンポーネントの名前。 | `controller`; `scheduler`; `agent` | | [`error.type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/error/) | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | `Required` | 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` | 計装が独自の値を定義していない場合に使用するフォールバック用のエラー値。 | ![Stable](https://img.shields.io/badge/-stable-lightgreen) | ## VCSメトリクス この節で説明する規約は、バージョン管理システムに固有のものです。 **免責事項:** これらは初期のVCSメトリクスと属性であり、将来さらに追加される可能性があります。 ### メトリクス: `vcs.change.count` このメトリクスは[recommended][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `vcs.change.count` | UpDownCounter | `{change}` | リポジトリ内の変更（プルリクエスト・マージリクエスト・チェンジリスト）の数を、その状態（openやmergedなど）別に分類したもの。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | [`vcs.repository`](https://opentelemetry.io/docs/specs/semconv/registry/entities/vcs/#vcs-repository) | **Attributes:** | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | | [`vcs.change.state`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | 変更（プルリクエスト・マージリクエスト・チェンジリスト）の状態。 | `open`; `closed`; `merged` | | [`vcs.repository.url.full`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | ブラウザでリポジトリを特定・識別するための完全なHTTP(S)アドレスを提供する、リポジトリの[正規URL](https://support.google.com/webmasters/answer/10347851)。[1] | `https://github.com/opentelemetry/open-telemetry-collector-contrib`; `https://gitlab.com/my-org/my-project/my-projects-project/repo` | | [`vcs.owner.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | バージョン管理システム内のグループの所有者。 | `my-org`; `myteam`; `business-unit` | | [`vcs.repository.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | リポジトリの人間が読める名前。GitLabのGroup/SubGroupやGitHubのorganizationのような追加の識別子を含めるべきではありません（SHOULD NOT）。[2] | `semantic-conventions`; `my-cool-repo` | | [`vcs.provider.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Opt-In` | string | バージョン管理システムのプロバイダー名。 | `github`; `gitlab`; `gitea`; `bitbucket` | **[1] `vcs.repository.url.full`:** Gitのバージョンコントロールシステムにおいて、正規URLに`.git`拡張子を含めるべきではありません（SHOULD NOT）。 **[2] `vcs.repository.name`:** 名前だけであるため、複数の組織やグループにわたってテレメトリーを収集する場合、同じバックエンド内で同じリポジトリのフォークと衝突する可能性があります。 --- `vcs.change.state`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `closed` | closedとは、マージリクエストがマージされずにクローズされたことを意味します。これは、変更が不要と判断された、別の方法で問題が解決された、作成者がリクエストを取り下げることを決めたなど、さまざまな理由で発生する可能性があります。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `merged` | mergedは、変更が対象のコードベースに正常に統合されたことを示します。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `open` | openとは、変更が現在アクティブでレビュー中であることを意味します。対象のブランチにまだマージされておらず、変更やコメントの追加がまだ可能です。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `wip` | WIP（work-in-progress、ドラフト）とは、変更がまだ進行中であり、まだ十分なレビューの準備ができていないことを意味します。今後も大きく変更される可能性があります。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | --- `vcs.provider.name`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `bitbucket` | [Bitbucket](https://bitbucket.org) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitea` | [Gitea](https://gitea.io) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `github` | [GitHub](https://github.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitlab` | [GitLab](https://gitlab.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | ### メトリクス: `vcs.change.duration` このメトリクスは[recommended][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `vcs.change.duration` | Gauge | `s` | 変更（プルリクエスト・マージリクエスト・チェンジリスト）が、ある状態に留まっている時間。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | [`vcs.repository`](https://opentelemetry.io/docs/specs/semconv/registry/entities/vcs/#vcs-repository) | **Attributes:** | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | | [`vcs.change.state`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | 変更（プルリクエスト・マージリクエスト・チェンジリスト）の状態。 | `open`; `closed`; `merged` | | [`vcs.ref.head.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | リポジトリ内の**branch**や**tag**などの[reference](https://git-scm.com/docs/gitglossary#def_ref)の名前。[1] | `my-feature-branch`; `tag-1-test` | | [`vcs.repository.url.full`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | ブラウザでリポジトリを特定・識別するための完全なHTTP(S)アドレスを提供する、リポジトリの[正規URL](https://support.google.com/webmasters/answer/10347851)。[2] | `https://github.com/opentelemetry/open-telemetry-collector-contrib`; `https://gitlab.com/my-org/my-project/my-projects-project/repo` | | [`vcs.owner.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | バージョン管理システム内のグループの所有者。 | `my-org`; `myteam`; `business-unit` | | [`vcs.repository.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | リポジトリの人間が読める名前。GitLabのGroup/SubGroupやGitHubのorganizationのような追加の識別子を含めるべきではありません（SHOULD NOT）。[3] | `semantic-conventions`; `my-cool-repo` | | [`vcs.provider.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Opt-In` | string | バージョン管理システムのプロバイダー名。 | `github`; `gitlab`; `gitea`; `bitbucket` | **[1] `vcs.ref.head.name`:** `head`は、まさに今いる場所、ある時点における現在のreferenceを指します。 **[2] `vcs.repository.url.full`:** Gitのバージョンコントロールシステムにおいて、正規URLに`.git`拡張子を含めるべきではありません（SHOULD NOT）。 **[3] `vcs.repository.name`:** 名前だけであるため、複数の組織やグループにわたってテレメトリーを収集する場合、同じバックエンド内で同じリポジトリのフォークと衝突する可能性があります。 --- `vcs.change.state`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `closed` | closedとは、マージリクエストがマージされずにクローズされたことを意味します。これは、変更が不要と判断された、別の方法で問題が解決された、作成者がリクエストを取り下げることを決めたなど、さまざまな理由で発生する可能性があります。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `merged` | mergedは、変更が対象のコードベースに正常に統合されたことを示します。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `open` | openとは、変更が現在アクティブでレビュー中であることを意味します。対象のブランチにまだマージされておらず、変更やコメントの追加がまだ可能です。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `wip` | WIP（work-in-progress、ドラフト）とは、変更がまだ進行中であり、まだ十分なレビューの準備ができていないことを意味します。今後も大きく変更される可能性があります。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | --- `vcs.provider.name`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `bitbucket` | [Bitbucket](https://bitbucket.org) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitea` | [Gitea](https://gitea.io) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `github` | [GitHub](https://github.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitlab` | [GitLab](https://gitlab.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | ### メトリクス: `vcs.change.time_to_approval` このメトリクスは[recommended][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `vcs.change.time_to_approval` | Gauge | `s` | 変更（プルリクエスト・マージリクエスト・チェンジリスト）が作成されてから最初の承認を得るまでにかかった時間。 | ![Development](https://img.shields.io/badge/-development-blue) | [`vcs.repository`](https://opentelemetry.io/docs/specs/semconv/registry/entities/vcs/#vcs-repository); [`vcs.ref`](https://opentelemetry.io/docs/specs/semconv/registry/entities/vcs/#vcs-ref) | **Attributes:** | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | | [`vcs.ref.head.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | リポジトリ内の**branch**や**tag**などの[reference](https://git-scm.com/docs/gitglossary#def_ref)の名前。[1] | `my-feature-branch`; `tag-1-test` | | [`vcs.repository.url.full`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | ブラウザでリポジトリを特定・識別するための完全なHTTP(S)アドレスを提供する、リポジトリの[正規URL](https://support.google.com/webmasters/answer/10347851)。[2] | `https://github.com/opentelemetry/open-telemetry-collector-contrib`; `https://gitlab.com/my-org/my-project/my-projects-project/repo` | | [`vcs.owner.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | バージョン管理システム内のグループの所有者。 | `my-org`; `myteam`; `business-unit` | | [`vcs.ref.base.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | リポジトリ内の**branch**や**tag**などの[reference](https://git-scm.com/docs/gitglossary#def_ref)の名前。[3] | `my-feature-branch`; `tag-1-test` | | [`vcs.repository.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | リポジトリの人間が読める名前。GitLabのGroup/SubGroupやGitHubのorganizationのような追加の識別子を含めるべきではありません（SHOULD NOT）。[4] | `semantic-conventions`; `my-cool-repo` | | [`vcs.provider.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Opt-In` | string | バージョン管理システムのプロバイダー名。 | `github`; `gitlab`; `gitea`; `bitbucket` | | [`vcs.ref.base.revision`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Opt-In` | string | リビジョン、文字通り[改訂版](https://www.merriam-webster.com/dictionary/revision)。リビジョンは、Gitではコミットオブジェクトを、SVNではリビジョン番号を指すことが最も多いです。[5] | `9d59409acf479dfa0df1aa568182e43e43df8bbe28d60fcf2bc52e30068802cc`; `main`; `123`; `HEAD` | | [`vcs.ref.head.revision`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Opt-In` | string | リビジョン、文字通り[改訂版](https://www.merriam-webster.com/dictionary/revision)。リビジョンは、Gitではコミットオブジェクトを、SVNではリビジョン番号を指すことが最も多いです。[6] | `9d59409acf479dfa0df1aa568182e43e43df8bbe28d60fcf2bc52e30068802cc`; `main`; `123`; `HEAD` | **[1] `vcs.ref.head.name`:** `head`は、まさに今いる場所、ある時点における現在のreferenceを指します。 **[2] `vcs.repository.url.full`:** Gitのバージョンコントロールシステムにおいて、正規URLに`.git`拡張子を含めるべきではありません（SHOULD NOT）。 **[3] `vcs.ref.base.name`:** `base`は、変更の起点を指します。たとえば、`main`からbranch型の新しいreferenceを作成し、新しいコミットを作成した場合、`main`はbranch型のbase referenceになります。 **[4] `vcs.repository.name`:** 名前だけであるため、複数の組織やグループにわたってテレメトリーを収集する場合、同じバックエンド内で同じリポジトリのフォークと衝突する可能性があります。 **[5] `vcs.ref.base.revision`:** `base`は、変更の起点を指します。たとえば、`main`からbranch型の新しいreferenceを作成し、新しいコミットを作成した場合、`main`はbranch型のbase referenceになります。リビジョンは、リポジトリ内のrefへの記録された変更を指す、コミット[commit](https://git-scm.com/docs/git-commit)オブジェクトへの完全な[ハッシュ値（用語集を参照）](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf)であってもかまいません。必ずしもハッシュである必要はなく、単調増加する整数である[リビジョン番号](https://svnbook.red-bean.com/en/1.7/svn.tour.revs.specifiers.html)を単純に定義してもかまいません。`ref.base.name`と同一である場合でも、含めるべきです（SHOULD）。VCSシステムと状況に応じたコンテキストに基づいて、どの値をリビジョンとして設定するかは、実装者の判断に委ねられます。 **[6] `vcs.ref.head.revision`:** `head`は、まさに今いる場所、ある時点における現在のreferenceを指します。リビジョンは、リポジトリ内のrefへの記録された変更を指す、コミット[commit](https://git-scm.com/docs/git-commit)オブジェクトへの完全な[ハッシュ値（用語集を参照）](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf)であってもかまいません。必ずしもハッシュである必要はなく、単調増加する整数である[リビジョン番号](https://svnbook.red-bean.com/en/1.7/svn.tour.revs.specifiers.html)を単純に定義してもかまいません。`ref.head.name`と同一である場合でも、含めるべきです（SHOULD）。VCSシステムと状況に応じたコンテキストに基づいて、どの値をリビジョンとして設定するかは、実装者の判断に委ねられます。 --- `vcs.provider.name`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `bitbucket` | [Bitbucket](https://bitbucket.org) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitea` | [Gitea](https://gitea.io) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `github` | [GitHub](https://github.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitlab` | [GitLab](https://gitlab.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | ### メトリクス: `vcs.change.time_to_merge` このメトリクスは[recommended][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `vcs.change.time_to_merge` | Gauge | `s` | 変更（プルリクエスト・マージリクエスト・チェンジリスト）が作成されてから、対象（base）のrefにマージされるまでにかかった時間。 | ![Development](https://img.shields.io/badge/-development-blue) | [`vcs.repository`](https://opentelemetry.io/docs/specs/semconv/registry/entities/vcs/#vcs-repository); [`vcs.ref`](https://opentelemetry.io/docs/specs/semconv/registry/entities/vcs/#vcs-ref) | **Attributes:** | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | | [`vcs.ref.head.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | リポジトリ内の**branch**や**tag**などの[reference](https://git-scm.com/docs/gitglossary#def_ref)の名前。[1] | `my-feature-branch`; `tag-1-test` | | [`vcs.repository.url.full`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | ブラウザでリポジトリを特定・識別するための完全なHTTP(S)アドレスを提供する、リポジトリの[正規URL](https://support.google.com/webmasters/answer/10347851)。[2] | `https://github.com/opentelemetry/open-telemetry-collector-contrib`; `https://gitlab.com/my-org/my-project/my-projects-project/repo` | | [`vcs.owner.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | バージョン管理システム内のグループの所有者。 | `my-org`; `myteam`; `business-unit` | | [`vcs.ref.base.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | リポジトリ内の**branch**や**tag**などの[reference](https://git-scm.com/docs/gitglossary#def_ref)の名前。[3] | `my-feature-branch`; `tag-1-test` | | [`vcs.repository.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | リポジトリの人間が読める名前。GitLabのGroup/SubGroupやGitHubのorganizationのような追加の識別子を含めるべきではありません（SHOULD NOT）。[4] | `semantic-conventions`; `my-cool-repo` | | [`vcs.provider.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Opt-In` | string | バージョン管理システムのプロバイダー名。 | `github`; `gitlab`; `gitea`; `bitbucket` | | [`vcs.ref.base.revision`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Opt-In` | string | リビジョン、文字通り[改訂版](https://www.merriam-webster.com/dictionary/revision)。リビジョンは、Gitではコミットオブジェクトを、SVNではリビジョン番号を指すことが最も多いです。[5] | `9d59409acf479dfa0df1aa568182e43e43df8bbe28d60fcf2bc52e30068802cc`; `main`; `123`; `HEAD` | | [`vcs.ref.head.revision`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Opt-In` | string | リビジョン、文字通り[改訂版](https://www.merriam-webster.com/dictionary/revision)。リビジョンは、Gitではコミットオブジェクトを、SVNではリビジョン番号を指すことが最も多いです。[6] | `9d59409acf479dfa0df1aa568182e43e43df8bbe28d60fcf2bc52e30068802cc`; `main`; `123`; `HEAD` | **[1] `vcs.ref.head.name`:** `head`は、まさに今いる場所、ある時点における現在のreferenceを指します。 **[2] `vcs.repository.url.full`:** Gitのバージョンコントロールシステムにおいて、正規URLに`.git`拡張子を含めるべきではありません（SHOULD NOT）。 **[3] `vcs.ref.base.name`:** `base`は、変更の起点を指します。たとえば、`main`からbranch型の新しいreferenceを作成し、新しいコミットを作成した場合、`main`はbranch型のbase referenceになります。 **[4] `vcs.repository.name`:** 名前だけであるため、複数の組織やグループにわたってテレメトリーを収集する場合、同じバックエンド内で同じリポジトリのフォークと衝突する可能性があります。 **[5] `vcs.ref.base.revision`:** `base`は、変更の起点を指します。たとえば、`main`からbranch型の新しいreferenceを作成し、新しいコミットを作成した場合、`main`はbranch型のbase referenceになります。リビジョンは、リポジトリ内のrefへの記録された変更を指す、コミット[commit](https://git-scm.com/docs/git-commit)オブジェクトへの完全な[ハッシュ値（用語集を参照）](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf)であってもかまいません。必ずしもハッシュである必要はなく、単調増加する整数である[リビジョン番号](https://svnbook.red-bean.com/en/1.7/svn.tour.revs.specifiers.html)を単純に定義してもかまいません。`ref.base.name`と同一である場合でも、含めるべきです（SHOULD）。VCSシステムと状況に応じたコンテキストに基づいて、どの値をリビジョンとして設定するかは、実装者の判断に委ねられます。 **[6] `vcs.ref.head.revision`:** `head`は、まさに今いる場所、ある時点における現在のreferenceを指します。リビジョンは、リポジトリ内のrefへの記録された変更を指す、コミット[commit](https://git-scm.com/docs/git-commit)オブジェクトへの完全な[ハッシュ値（用語集を参照）](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf)であってもかまいません。必ずしもハッシュである必要はなく、単調増加する整数である[リビジョン番号](https://svnbook.red-bean.com/en/1.7/svn.tour.revs.specifiers.html)を単純に定義してもかまいません。`ref.head.name`と同一である場合でも、含めるべきです（SHOULD）。VCSシステムと状況に応じたコンテキストに基づいて、どの値をリビジョンとして設定するかは、実装者の判断に委ねられます。 --- `vcs.provider.name`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `bitbucket` | [Bitbucket](https://bitbucket.org) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitea` | [Gitea](https://gitea.io) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `github` | [GitHub](https://github.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitlab` | [GitLab](https://gitlab.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | ### メトリクス: `vcs.repository.count` このメトリクスは[recommended][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `vcs.repository.count` | UpDownCounter | `{repository}` | 組織内のリポジトリ数。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | **Attributes:** | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | | [`vcs.owner.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | バージョン管理システム内のグループの所有者。 | `my-org`; `myteam`; `business-unit` | | [`vcs.provider.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Opt-In` | string | バージョン管理システムのプロバイダー名。 | `github`; `gitlab`; `gitea`; `bitbucket` | --- `vcs.provider.name`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `bitbucket` | [Bitbucket](https://bitbucket.org) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitea` | [Gitea](https://gitea.io) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `github` | [GitHub](https://github.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitlab` | [GitLab](https://gitlab.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | ### メトリクス: `vcs.ref.count` このメトリクスは[recommended][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `vcs.ref.count` | UpDownCounter | `{ref}` | リポジトリ内のbranch型またはtag型のref数。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | [`vcs.repository`](https://opentelemetry.io/docs/specs/semconv/registry/entities/vcs/#vcs-repository) | **Attributes:** | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | | [`vcs.ref.type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | リポジトリ内の[reference](https://git-scm.com/docs/gitglossary#def_ref)の種類。 | `branch`; `tag` | | [`vcs.repository.url.full`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | ブラウザでリポジトリを特定・識別するための完全なHTTP(S)アドレスを提供する、リポジトリの[正規URL](https://support.google.com/webmasters/answer/10347851)。[1] | `https://github.com/opentelemetry/open-telemetry-collector-contrib`; `https://gitlab.com/my-org/my-project/my-projects-project/repo` | | [`vcs.owner.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | バージョン管理システム内のグループの所有者。 | `my-org`; `myteam`; `business-unit` | | [`vcs.repository.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | リポジトリの人間が読める名前。GitLabのGroup/SubGroupやGitHubのorganizationのような追加の識別子を含めるべきではありません（SHOULD NOT）。[2] | `semantic-conventions`; `my-cool-repo` | | [`vcs.provider.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Opt-In` | string | バージョン管理システムのプロバイダー名。 | `github`; `gitlab`; `gitea`; `bitbucket` | **[1] `vcs.repository.url.full`:** Gitのバージョンコントロールシステムにおいて、正規URLに`.git`拡張子を含めるべきではありません（SHOULD NOT）。 **[2] `vcs.repository.name`:** 名前だけであるため、複数の組織やグループにわたってテレメトリーを収集する場合、同じバックエンド内で同じリポジトリのフォークと衝突する可能性があります。 --- `vcs.provider.name`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `bitbucket` | [Bitbucket](https://bitbucket.org) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitea` | [Gitea](https://gitea.io) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `github` | [GitHub](https://github.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitlab` | [GitLab](https://gitlab.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | --- `vcs.ref.type`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `branch` | [branch](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddefbranchabranch) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `tag` | [tag](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddeftagatag) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | ### メトリクス: `vcs.ref.lines_delta` このメトリクスは[recommended][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `vcs.ref.lines_delta` | Gauge | `{line}` | `vcs.ref.base.name`属性が示すrefと比較した、あるref（branch）で追加・削除された行数。[1] | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | [`vcs.repository`](https://opentelemetry.io/docs/specs/semconv/registry/entities/vcs/#vcs-repository) | **[1]:** このメトリクスは、`vcs.line_change.type`の値ごとに報告されるべきです（should）。たとえば、あるrefで3行が追加され2行が削除された場合、計装は2つの計測値（3と2、いずれも正の数）を報告すべきです（SHOULD）。 追加・削除された行数を最初の時点から計算する場合、`vcs.ref.base.name`は空文字列に設定されるべきです（SHOULD）。 **Attributes:** | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | | [`vcs.line_change.type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | branchや変更について計測される行変更の種類。 | `added`; `removed` | | [`vcs.ref.base.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | リポジトリ内の**branch**や**tag**などの[reference](https://git-scm.com/docs/gitglossary#def_ref)の名前。[1] | `my-feature-branch`; `tag-1-test` | | [`vcs.ref.base.type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | リポジトリ内の[reference](https://git-scm.com/docs/gitglossary#def_ref)の種類。[2] | `branch`; `tag` | | [`vcs.ref.head.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | リポジトリ内の**branch**や**tag**などの[reference](https://git-scm.com/docs/gitglossary#def_ref)の名前。[3] | `my-feature-branch`; `tag-1-test` | | [`vcs.ref.head.type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | リポジトリ内の[reference](https://git-scm.com/docs/gitglossary#def_ref)の種類。[4] | `branch`; `tag` | | [`vcs.repository.url.full`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | ブラウザでリポジトリを特定・識別するための完全なHTTP(S)アドレスを提供する、リポジトリの[正規URL](https://support.google.com/webmasters/answer/10347851)。[5] | `https://github.com/opentelemetry/open-telemetry-collector-contrib`; `https://gitlab.com/my-org/my-project/my-projects-project/repo` | | [`vcs.change.id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Conditionally Required` if a change is associated with the ref. | string | 該当する場合の、変更（プルリクエスト・マージリクエスト・チェンジリスト）のID。これは通常、VCSシステムが生成する（リポジトリ内で一意な）識別子です。 | `123` | | [`vcs.owner.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | バージョン管理システム内のグループの所有者。 | `my-org`; `myteam`; `business-unit` | | [`vcs.repository.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | リポジトリの人間が読める名前。GitLabのGroup/SubGroupやGitHubのorganizationのような追加の識別子を含めるべきではありません（SHOULD NOT）。[6] | `semantic-conventions`; `my-cool-repo` | | [`vcs.provider.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Opt-In` | string | バージョン管理システムのプロバイダー名。 | `github`; `gitlab`; `gitea`; `bitbucket` | **[1] `vcs.ref.base.name`:** `base`は、変更の起点を指します。たとえば、`main`からbranch型の新しいreferenceを作成し、新しいコミットを作成した場合、`main`はbranch型のbase referenceになります。 **[2] `vcs.ref.base.type`:** `base`は、変更の起点を指します。たとえば、`main`からbranch型の新しいreferenceを作成し、新しいコミットを作成した場合、`main`はbranch型のbase referenceになります。 **[3] `vcs.ref.head.name`:** `head`は、まさに今いる場所、ある時点における現在のreferenceを指します。 **[4] `vcs.ref.head.type`:** `head`は、まさに今いる場所、ある時点における現在のreferenceを指します。 **[5] `vcs.repository.url.full`:** Gitのバージョンコントロールシステムにおいて、正規URLに`.git`拡張子を含めるべきではありません（SHOULD NOT）。 **[6] `vcs.repository.name`:** 名前だけであるため、複数の組織やグループにわたってテレメトリーを収集する場合、同じバックエンド内で同じリポジトリのフォークと衝突する可能性があります。 --- `vcs.line_change.type`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `added` | 追加された行数。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `removed` | 削除された行数。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | --- `vcs.provider.name`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `bitbucket` | [Bitbucket](https://bitbucket.org) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitea` | [Gitea](https://gitea.io) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `github` | [GitHub](https://github.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitlab` | [GitLab](https://gitlab.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | --- `vcs.ref.base.type`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `branch` | [branch](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddefbranchabranch) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `tag` | [tag](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddeftagatag) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | --- `vcs.ref.head.type`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `branch` | [branch](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddefbranchabranch) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `tag` | [tag](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddeftagatag) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | ### メトリクス: `vcs.ref.revisions_delta` このメトリクスは[recommended][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `vcs.ref.revisions_delta` | Gauge | `{revision}` | `vcs.ref.base.name`属性が示すbranchと比較して、あるref（branch）が進んでいる・遅れているリビジョン（コミット）数。[1] | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | [`vcs.repository`](https://opentelemetry.io/docs/specs/semconv/registry/entities/vcs/#vcs-repository) | **[1]:** このメトリクスは、`vcs.revision_delta.direction`の値ごとに報告されるべきです（should）。たとえば、branch `a`が`trunk`に対して3コミット遅れ、2コミット進んでいる場合、計装は2つの計測値（3と2、いずれも正の数）を報告すべきであり（SHOULD）、`vcs.ref.base.name`は`trunk`に設定されます。 **Attributes:** | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | | [`vcs.ref.base.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | リポジトリ内の**branch**や**tag**などの[reference](https://git-scm.com/docs/gitglossary#def_ref)の名前。[1] | `my-feature-branch`; `tag-1-test` | | [`vcs.ref.base.type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | リポジトリ内の[reference](https://git-scm.com/docs/gitglossary#def_ref)の種類。[2] | `branch`; `tag` | | [`vcs.ref.head.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | リポジトリ内の**branch**や**tag**などの[reference](https://git-scm.com/docs/gitglossary#def_ref)の名前。[3] | `my-feature-branch`; `tag-1-test` | | [`vcs.ref.head.type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | リポジトリ内の[reference](https://git-scm.com/docs/gitglossary#def_ref)の種類。[4] | `branch`; `tag` | | [`vcs.repository.url.full`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | ブラウザでリポジトリを特定・識別するための完全なHTTP(S)アドレスを提供する、リポジトリの[正規URL](https://support.google.com/webmasters/answer/10347851)。[5] | `https://github.com/opentelemetry/open-telemetry-collector-contrib`; `https://gitlab.com/my-org/my-project/my-projects-project/repo` | | [`vcs.revision_delta.direction`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | リビジョン比較の種類。 | `ahead`; `behind` | | [`vcs.change.id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Conditionally Required` if a change is associated with the ref. | string | 該当する場合の、変更（プルリクエスト・マージリクエスト・チェンジリスト）のID。これは通常、VCSシステムが生成する（リポジトリ内で一意な）識別子です。 | `123` | | [`vcs.owner.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | バージョン管理システム内のグループの所有者。 | `my-org`; `myteam`; `business-unit` | | [`vcs.repository.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | リポジトリの人間が読める名前。GitLabのGroup/SubGroupやGitHubのorganizationのような追加の識別子を含めるべきではありません（SHOULD NOT）。[6] | `semantic-conventions`; `my-cool-repo` | | [`vcs.provider.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Opt-In` | string | バージョン管理システムのプロバイダー名。 | `github`; `gitlab`; `gitea`; `bitbucket` | **[1] `vcs.ref.base.name`:** `base`は、変更の起点を指します。たとえば、`main`からbranch型の新しいreferenceを作成し、新しいコミットを作成した場合、`main`はbranch型のbase referenceになります。 **[2] `vcs.ref.base.type`:** `base`は、変更の起点を指します。たとえば、`main`からbranch型の新しいreferenceを作成し、新しいコミットを作成した場合、`main`はbranch型のbase referenceになります。 **[3] `vcs.ref.head.name`:** `head`は、まさに今いる場所、ある時点における現在のreferenceを指します。 **[4] `vcs.ref.head.type`:** `head`は、まさに今いる場所、ある時点における現在のreferenceを指します。 **[5] `vcs.repository.url.full`:** Gitのバージョンコントロールシステムにおいて、正規URLに`.git`拡張子を含めるべきではありません（SHOULD NOT）。 **[6] `vcs.repository.name`:** 名前だけであるため、複数の組織やグループにわたってテレメトリーを収集する場合、同じバックエンド内で同じリポジトリのフォークと衝突する可能性があります。 --- `vcs.provider.name`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `bitbucket` | [Bitbucket](https://bitbucket.org) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitea` | [Gitea](https://gitea.io) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `github` | [GitHub](https://github.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitlab` | [GitLab](https://gitlab.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | --- `vcs.ref.base.type`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `branch` | [branch](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddefbranchabranch) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `tag` | [tag](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddeftagatag) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | --- `vcs.ref.head.type`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `branch` | [branch](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddefbranchabranch) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `tag` | [tag](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddeftagatag) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | --- `vcs.revision_delta.direction`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `ahead` | 変更が対象のrefより進んでいるリビジョン数。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `behind` | 変更が対象のrefより遅れているリビジョン数。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | ### メトリクス: `vcs.ref.time` このメトリクスは[recommended][MetricRecommended]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `vcs.ref.time` | Gauge | `s` | デフォルトブランチ（trunk）から作成されたref（branch）が存在してきた時間。`ref.type`属性は常に`branch`です。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | [`vcs.repository`](https://opentelemetry.io/docs/specs/semconv/registry/entities/vcs/#vcs-repository) | **Attributes:** | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | | [`vcs.ref.head.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | リポジトリ内の**branch**や**tag**などの[reference](https://git-scm.com/docs/gitglossary#def_ref)の名前。[1] | `my-feature-branch`; `tag-1-test` | | [`vcs.ref.head.type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | リポジトリ内の[reference](https://git-scm.com/docs/gitglossary#def_ref)の種類。[2] | `branch`; `tag` | | [`vcs.repository.url.full`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | ブラウザでリポジトリを特定・識別するための完全なHTTP(S)アドレスを提供する、リポジトリの[正規URL](https://support.google.com/webmasters/answer/10347851)。[3] | `https://github.com/opentelemetry/open-telemetry-collector-contrib`; `https://gitlab.com/my-org/my-project/my-projects-project/repo` | | [`vcs.owner.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | バージョン管理システム内のグループの所有者。 | `my-org`; `myteam`; `business-unit` | | [`vcs.repository.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | リポジトリの人間が読める名前。GitLabのGroup/SubGroupやGitHubのorganizationのような追加の識別子を含めるべきではありません（SHOULD NOT）。[4] | `semantic-conventions`; `my-cool-repo` | | [`vcs.provider.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Opt-In` | string | バージョン管理システムのプロバイダー名。 | `github`; `gitlab`; `gitea`; `bitbucket` | **[1] `vcs.ref.head.name`:** `head`は、まさに今いる場所、ある時点における現在のreferenceを指します。 **[2] `vcs.ref.head.type`:** `head`は、まさに今いる場所、ある時点における現在のreferenceを指します。 **[3] `vcs.repository.url.full`:** Gitのバージョンコントロールシステムにおいて、正規URLに`.git`拡張子を含めるべきではありません（SHOULD NOT）。 **[4] `vcs.repository.name`:** 名前だけであるため、複数の組織やグループにわたってテレメトリーを収集する場合、同じバックエンド内で同じリポジトリのフォークと衝突する可能性があります。 --- `vcs.provider.name`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `bitbucket` | [Bitbucket](https://bitbucket.org) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitea` | [Gitea](https://gitea.io) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `github` | [GitHub](https://github.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitlab` | [GitLab](https://gitlab.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | --- `vcs.ref.head.type`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `branch` | [branch](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddefbranchabranch) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `tag` | [tag](https://git-scm.com/docs/gitglossary#Documentation/gitglossary.txt-aiddeftagatag) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | ### メトリクス: `vcs.contributor.count` このメトリクスは[opt-in][MetricOptIn]です。 | Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations | | -------- | --------------- | ----------- | -------------- | --------- | ------ | | `vcs.contributor.count` | Gauge | `{contributor}` | リポジトリに対する一意な貢献者の数。 | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | [`vcs.repository`](https://opentelemetry.io/docs/specs/semconv/registry/entities/vcs/#vcs-repository) | **Attributes:** | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | | [`vcs.repository.url.full`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Required` | string | ブラウザでリポジトリを特定・識別するための完全なHTTP(S)アドレスを提供する、リポジトリの[正規URL](https://support.google.com/webmasters/answer/10347851)。[1] | `https://github.com/opentelemetry/open-telemetry-collector-contrib`; `https://gitlab.com/my-org/my-project/my-projects-project/repo` | | [`vcs.owner.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | バージョン管理システム内のグループの所有者。 | `my-org`; `myteam`; `business-unit` | | [`vcs.repository.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Recommended` | string | リポジトリの人間が読める名前。GitLabのGroup/SubGroupやGitHubのorganizationのような追加の識別子を含めるべきではありません（SHOULD NOT）。[2] | `semantic-conventions`; `my-cool-repo` | | [`vcs.provider.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/vcs/) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | `Opt-In` | string | バージョン管理システムのプロバイダー名。 | `github`; `gitlab`; `gitea`; `bitbucket` | **[1] `vcs.repository.url.full`:** Gitのバージョンコントロールシステムにおいて、正規URLに`.git`拡張子を含めるべきではありません（SHOULD NOT）。 **[2] `vcs.repository.name`:** 名前だけであるため、複数の組織やグループにわたってテレメトリーを収集する場合、同じバックエンド内で同じリポジトリのフォークと衝突する可能性があります。 --- `vcs.provider.name`には、次のよく知られた値の一覧があります。これらのいずれかが該当する場合は、対応する値を使用しなければなりません（MUST）。そうでない場合は、独自の値を使用してもかまいません（MAY）。 | Value | Description | Stability | | --- | --- | --- | | `bitbucket` | [Bitbucket](https://bitbucket.org) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitea` | [Gitea](https://gitea.io) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `github` | [GitHub](https://github.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | | `gitlab` | [GitLab](https://gitlab.com) | ![Release Candidate](https://img.shields.io/badge/-rc-mediumorchid) | [DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status [MetricOptIn]: /works/otel-specs-ja/semconv/general/metric-requirement-level/#opt-in [MetricRecommended]: /works/otel-specs-ja/semconv/general/metric-requirement-level/#recommended