# セマンティック規約

> Source: https://www.ymotongpoo.com/works/otel-specs-ja/spec/semantic-conventions/


**ステータス**: [開発中（Development）](/works/otel-specs-ja/spec/document-status/)

**セマンティック規約**は、アプリケーションで一般的に観測される概念・プロトコル・操作を記述するためのキーと値を定義します。

OpenTelemetryは、そのセマンティック規約を別のリポジトリで定義しています。
[https://github.com/open-telemetry/semantic-conventions](https://github.com/open-telemetry/semantic-conventions)。

## 予約された属性

セマンティック規約は、以下の属性を提供しなければなりません（MUST）。

- [`error.type`](https://github.com/open-telemetry/semantic-conventions/blob/mainhttps://opentelemetry.io/docs/specs/semconv/registry/attributes/error/#error-type)
- [`exception.message`](https://github.com/open-telemetry/semantic-conventions/blob/mainhttps://opentelemetry.io/docs/specs/semconv/registry/attributes/exception/#exception-message)
- [`exception.stacktrace`](https://github.com/open-telemetry/semantic-conventions/blob/mainhttps://opentelemetry.io/docs/specs/semconv/registry/attributes/exception/#exception-stacktrace)
- [`exception.type`](https://github.com/open-telemetry/semantic-conventions/blob/mainhttps://opentelemetry.io/docs/specs/semconv/registry/attributes/exception/#exception-type)
- [`server.address`](https://github.com/open-telemetry/semantic-conventions/blob/mainhttps://opentelemetry.io/docs/specs/semconv/registry/attributes/server/#server-address)
- [`server.port`](https://github.com/open-telemetry/semantic-conventions/blob/mainhttps://opentelemetry.io/docs/specs/semconv/registry/attributes/server/#server-port)
- [`service.name`](https://github.com/open-telemetry/semantic-conventions/blob/mainhttps://opentelemetry.io/docs/specs/semconv/registry/attributes/service/#service-name)
- [`telemetry.sdk.language`](https://github.com/open-telemetry/semantic-conventions/blob/mainhttps://opentelemetry.io/docs/specs/semconv/registry/attributes/telemetry/#telemetry-sdk-language)
- [`telemetry.sdk.name`](https://github.com/open-telemetry/semantic-conventions/blob/mainhttps://opentelemetry.io/docs/specs/semconv/registry/attributes/telemetry/#telemetry-sdk-name)
- [`telemetry.sdk.version`](https://github.com/open-telemetry/semantic-conventions/blob/mainhttps://opentelemetry.io/docs/specs/semconv/registry/attributes/telemetry/#telemetry-sdk-version)
- [`url.scheme`](https://github.com/open-telemetry/semantic-conventions/blob/mainhttps://opentelemetry.io/docs/specs/semconv/registry/attributes/url/#url-scheme)

セマンティック規約は、以下のイベントを提供しなければなりません（MUST）。

- [`exception`](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/exceptions/exceptions-spans.md)

## 開発中の予約された属性

セマンティック規約は、以下の属性を提供しなければなりません（MUST）。

- [`service.instance.id`](https://github.com/open-telemetry/semantic-conventions/blob/mainhttps://opentelemetry.io/docs/specs/semconv/registry/attributes/service/#service-instance-id)

## 予約された名前空間

`otel.*`という名前空間は、非OpenTelemetry技術との互換性を定義するために予約されています。