Operating system

December 2, 2025 ยท View on GitHub

In case of virtualized environments, this is the operating system as it is observed by the process, i.e., the virtualized guest rather than the underlying host.

Status: Development

type: os

Description: The operating system (OS) on which the process represented by this resource is running.

Warning

This entity definition contains attributes without a role. Stable Entities MUST NOT have attributes without a defined role.

Attributes:

RoleKeyStabilityRequirement LevelValue TypeDescriptionExample Values
Otheros.typeDevelopmentRequiredstringThe operating system type.windows; linux; darwin
Otheros.build_idDevelopmentRecommendedstringUnique identifier for a particular build or compilation of the operating system. [1]TQ3C.230805.001.B2; 20E247; 22621
Otheros.descriptionDevelopmentRecommendedstringHuman readable (not intended to be parsed) OS version information, like e.g. reported by ver or lsb_release -a commands.Microsoft Windows [Version 10.0.18363.778]; Ubuntu 18.04.1 LTS
Otheros.nameDevelopmentRecommendedstringHuman readable operating system name.iOS; Android; Ubuntu
Otheros.versionDevelopmentRecommendedstringThe version string of the operating system as defined in Version Attributes.14.2.1; 18.04.1

[1] os.build_id: build_id values SHOULD be obtained from the following sources:

OSPrimaryFallback
WindowsCurrentBuildNumber from registry HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion-
MacOSProductBuildVersion from /System/Library/CoreServices/SystemVersion.plistProductBuildVersion from /System/Library/CoreServices/ServerVersion.plist
LinuxBUILD_ID from /etc/os-releaseBUILD_ID from /usr/lib/os-release;
contents of /proc/sys/kernel/osrelease

os.type has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

ValueDescriptionStability
aixAIX (Advanced Interactive eXecutive)Development
darwinApple DarwinDevelopment
dragonflybsdDragonFly BSDDevelopment
freebsdFreeBSDDevelopment
hpuxHP-UX (Hewlett Packard Unix)Development
linuxLinuxDevelopment
netbsdNetBSDDevelopment
openbsdOpenBSDDevelopment
solarisSunOS, Oracle SolarisDevelopment
windowsMicrosoft WindowsDevelopment
zosIBM z/OSDevelopment