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


# オペレーティングシステム

仮想化環境の場合、これはプロセスから観測されるオペレーティングシステムであり、つまり基盤となるホストではなく仮想化されたゲスト側のOSを指します。

<!-- semconv entity.os -->
<!-- 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:** `os`

**Description:** このリソースが表すプロセスが実行されているオペレーティングシステム（OS）。

> [!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 | [`os.type`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/os/) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | オペレーティングシステムの種別。 | `windows`; `linux`; `darwin` |
| Other | [`os.build_id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/os/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | オペレーティングシステムの特定のビルドまたはコンパイルを一意に識別する識別子。[1] | `TQ3C.230805.001.B2`; `20E247`; `22621` |
| Other | [`os.description`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/os/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | 人間が読める（構文解析を意図しない）OSバージョン情報。例えば `ver` や `lsb_release -a` コマンドで報告される情報。 | `Microsoft Windows [Version 10.0.18363.778]`; `Ubuntu 18.04.1 LTS` |
| Other | [`os.name`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/os/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | 人間が読めるオペレーティングシステム名。 | `iOS`; `Android`; `Ubuntu` |
| Other | [`os.version`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/os/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | [Version Attributes](https://opentelemetry.io/docs/specs/semconv/resource/#version-attributes)で定義されている、オペレーティングシステムのバージョン文字列。 | `14.2.1`; `18.04.1` |

**[1] `os.build_id`:** `build_id` の値は、次のソースから取得すべきです（SHOULD）。

| OS | Primary | Fallback |
| ------- | ------- | ------- |
| Windows | `CurrentBuildNumber` from registry `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion` | - |
| macOS | `ProductBuildVersion` from `/System/Library/CoreServices/SystemVersion.plist` | `ProductBuildVersion` from `/System/Library/CoreServices/ServerVersion.plist` |
| Linux | `BUILD_ID` from `/etc/os-release` | `BUILD_ID` from `/usr/lib/os-release`; <br> contents of `/proc/sys/kernel/osrelease` |

---

`os.type` には、次のよく知られた値の一覧があります。いずれかが該当する場合はその値を使用しなければならず（MUST）、それ以外の場合は独自の値を使ってもかまいません（MAY）。

| Value | Description | Stability |
| --- | --- | --- |
| `aix` | AIX（Advanced Interactive eXecutive） | ![Development](https://img.shields.io/badge/-development-blue) |
| `darwin` | Apple Darwin | ![Development](https://img.shields.io/badge/-development-blue) |
| `dragonflybsd` | DragonFly BSD | ![Development](https://img.shields.io/badge/-development-blue) |
| `freebsd` | FreeBSD | ![Development](https://img.shields.io/badge/-development-blue) |
| `hpux` | HP-UX（Hewlett Packard UNIX） | ![Development](https://img.shields.io/badge/-development-blue) |
| `linux` | Linux | ![Development](https://img.shields.io/badge/-development-blue) |
| `netbsd` | NetBSD | ![Development](https://img.shields.io/badge/-development-blue) |
| `openbsd` | OpenBSD | ![Development](https://img.shields.io/badge/-development-blue) |
| `solaris` | SunOS、Oracle Solaris | ![Development](https://img.shields.io/badge/-development-blue) |
| `windows` | Microsoft Windows | ![Development](https://img.shields.io/badge/-development-blue) |
| `zos` | IBM z/OS | ![Development](https://img.shields.io/badge/-development-blue) |
<!-- prettier-ignore-end -->
<!-- END AUTOGENERATED TEXT -->
<!-- endsemconv -->