> Source: https://www.ymotongpoo.com/works/otel-specs-ja/semconv/browser/browser-events/


# ブラウザイベントに関するセマンティック規約

**ステータス**: [Development][DocumentStatus]

この文書では、イベントを発行するブラウザ（Web）計装のためのセマンティック規約を定義します。

## WebVital Event

<!-- semconv event.browser.web_vital -->
<!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
<!-- see templates/registry/markdown/snippet.md.j2 -->
<!-- prettier-ignore-start -->

**Status:** ![Development](https://img.shields.io/badge/-development-blue)

イベント名は `browser.web_vital` でなければなりません（MUST）。

このイベントは、Googleが導入したウェブサイトのパフォーマンスメトリクスについて記述します。詳細は[web vitals](https://web.dev/vitals)を参照してください。

**Attributes:**

| Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`browser.web_vital.delta`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/browser/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | double | 現在の値と直前に報告された値との差分。[delta](https://github.com/GoogleChrome/web-vitals?tab=readme-ov-file#report-only-the-delta-of-changes)を参照。 | `0.2` |
| [`browser.web_vital.id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/browser/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | この特定のメトリクスインスタンスを表す一意のID。 | `v3-1677874579383-6381583661209` |
| [`browser.web_vital.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/browser/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | web vitalの名前。 | `cls` |
| [`browser.web_vital.value`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/browser/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | double | web vitalの値。 | `1.0` |
| [`browser.web_vital.navigation_type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/browser/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | [Navigation Timing API](https://developer.mozilla.org/docs/Web/API/PerformanceNavigationTiming/type)で報告されるナビゲーションの種別に、web-vitalsライブラリが報告する追加の値を加えたもの。 | `navigate` |
| [`browser.web_vital.rating`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/browser/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | そのメトリクスに定義された「good」「needs improvement」「poor」の閾値に対する、web vitalの値の評価。 | `good` |

---

`browser.web_vital.name` には、次のよく知られた値の一覧があります。いずれかが該当する場合、対応する値を使用しなければならず（MUST）、そうでない場合はカスタムの値を使用できます（MAY）。

| Value | Description | Stability |
| --- | --- | --- |
| `cls` | Cumulative Layout Shift。[cls](https://web.dev/articles/cls)を参照。 | ![Development](https://img.shields.io/badge/-development-blue) |
| `fcp` | First Contentful Paint。[fcp](https://web.dev/articles/fcp)を参照。 | ![Development](https://img.shields.io/badge/-development-blue) |
| `inp` | Interaction to Next Paint。[inp](https://web.dev/articles/inp)を参照。 | ![Development](https://img.shields.io/badge/-development-blue) |
| `lcp` | Largest Contentful Paint。[lcp](https://web.dev/articles/lcp)を参照。 | ![Development](https://img.shields.io/badge/-development-blue) |
| `ttfb` | Time to First Byte。[ttfb](https://web.dev/articles/ttfb)を参照。 | ![Development](https://img.shields.io/badge/-development-blue) |

---

`browser.web_vital.navigation_type` には、次のよく知られた値の一覧があります。いずれかが該当する場合、対応する値を使用しなければならず（MUST）、そうでない場合はカスタムの値を使用できます（MAY）。

| Value | Description | Stability |
| --- | --- | --- |
| `back-forward` | ブラウザの履歴移動（戻る/進むボタンなど）によるナビゲーション。 | ![Development](https://img.shields.io/badge/-development-blue) |
| `back-forward-cache` | back/forwardキャッシュ（bfcache）からページを復元するナビゲーション。 | ![Development](https://img.shields.io/badge/-development-blue) |
| `navigate` | リンクのクリック、URLの入力、フォームの送信、またはスクリプト操作によって開始されたナビゲーション。 | ![Development](https://img.shields.io/badge/-development-blue) |
| `prerender` | プリレンダリングされたページへのナビゲーション。 | ![Development](https://img.shields.io/badge/-development-blue) |
| `reload` | リロード操作または `Location.reload()` 呼び出しによるナビゲーション。 | ![Development](https://img.shields.io/badge/-development-blue) |
| `restore` | ブラウザによって以前破棄されたページを復元するナビゲーション。 | ![Development](https://img.shields.io/badge/-development-blue) |

---

`browser.web_vital.rating` には、次のよく知られた値の一覧があります。いずれかが該当する場合、対応する値を使用しなければならず（MUST）、そうでない場合はカスタムの値を使用できます（MAY）。

| Value | Description | Stability |
| --- | --- | --- |
| `good` | メトリクスの値が「good」の閾値内にあります。 | ![Development](https://img.shields.io/badge/-development-blue) |
| `needs-improvement` | メトリクスの値が「needs improvement」の閾値内にあります。 | ![Development](https://img.shields.io/badge/-development-blue) |
| `poor` | メトリクスの値が「poor」の閾値内にあります。 | ![Development](https://img.shields.io/badge/-development-blue) |

<!-- prettier-ignore-end -->
<!-- END AUTOGENERATED TEXT -->
<!-- endsemconv -->

[DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status