> Source: https://www.ymotongpoo.com/works/otel-specs-ja/semconv/resource/webengine/


# Webengine

<!-- semconv entity.webengine -->
<!-- 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)

**type:** `webengine`

**Description:** アプリケーションコードを実行しているパッケージ化されたソフトウェアを表すリソース。Webエンジンは通常 process.runtime を使って実行されます。

> [!warning]
> このEntity定義には、ロールを持たない属性が含まれています。
> 安定版のEntityは、ロールが定義されていない属性を持ってはなりません（MUST NOT）。

**Attributes:**

| Role | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- | --- |
| Other | [`webengine.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/webengine/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | Webエンジンの名前。 | `WildFly` |
| Other | [`webengine.description`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/webengine/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | Webエンジンに関する追加の説明（詳細なバージョンやエディション情報など）。 | `WildFly Full 21.0.0.Final (WildFly Core 13.0.1.Final) - 2.2.2.Final` |
| Other | [`webengine.version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/webengine/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | Webエンジンのバージョン。 | `21.0.0` |
<!-- prettier-ignore-end -->
<!-- END AUTOGENERATED TEXT -->
<!-- endsemconv -->

Webエンジンを記述する情報は、エンジンのバージョンアップグレード時の保守負担を避けるため、できればランタイム中にWebエンジンが提供するAPIから取得した値を使って収集すべきです（SHOULD）。例えば、JavaのWebエンジンはしばしばアプリケーションサーバーとしてパッケージ化されますが、常にそうとは限りません。Servlet APIをサポートするJavaアプリケーションサーバーの場合、必要な情報はランタイム中に `ServletContext.getServerInfo()` を呼び出し、その結果を構文解析することで取得してもかまいません（MAY）。

1つのリソースは、最大で1つのWebエンジンに帰属できます。

複数の候補がある状況では、どのWebエンジンを選ぶかは計装ライブラリの作者に委ねられます。例として、Apache HTTP Serverをmod_wsgiと組み合わせてサーバーとし、DjangoをWebフレームワークとして使うPythonアプリケーションを考えます。この状況では次のようになります。

* 計装作者の判断により、Apache HTTP Serverまたは `mod_wsgi` のいずれかを `webengine` として選んでもかまいません（MAY）。
* 必要な情報はすでに計装ライブラリで利用可能であり、これを `webengine` に設定すると情報が重複するため、Djangoを `webengine` として設定するべきではありません（SHOULD NOT）。