◇semconv.com

Hosts and hardware

as of v1.44.0

The machine: its operating system, CPU, disks, filesystems and physical hardware sensors.

hw 27file 21system 17host 15os 5cpu 2nfs 2zos 2disk 1linux 1mainframe 1

attributes
94
metrics
107
signals
4
stable
0
deprecated
7

Signals

What this domain emits, and the attributes each one carries, most strongly required first. An attribute marked * is required on that signal; * is conditionally required.

Entities 4

Metrics 107

Specification

The specification prose never names this domain. That is not an omission: the specification defines signals, not subject matter — what binds hw telemetry is the general rules above, and the conventions themselves carry the rest.

On the wire, this lands in metrics/v1/metrics, resource/v1/resource. Field-by-field definitions are under OTLP.

Attributes 94

hw27 attributes

file21 attributes

  • file.accessed
    DevelopmentTime when the file was last accessed, in ISO 8601 format.
  • file.attributes
    DevelopmentArray of file attributes.
  • file.changed
    DevelopmentTime when the file attributes or metadata was last changed, in ISO 8601 format.
  • file.created
    DevelopmentTime when the file was created, in ISO 8601 format.
  • file.directory
    DevelopmentDirectory where the file is located. It should include the drive letter, when appropriate.
  • file.extension
    DevelopmentFile extension, excluding the leading dot.
  • file.fork_name
    DevelopmentName of the fork. A fork is additional data associated with a filesystem object.
  • file.group.id
    DevelopmentPrimary Group ID (GID) of the file.
  • file.group.name
    DevelopmentPrimary group name of the file.
  • file.inode
    DevelopmentInode representing the file in the filesystem.
  • file.lock.mechanism
    DevelopmentThe lock mechanism such as noted by POSIX
  • file.lock.mode
    DevelopmentMode of lock or operation such as documented by POSIX
  • file.lock.type
    DevelopmentThe lock type as represented by i.e. POSIX's l_type.
  • file.mode
    DevelopmentMode of the file in octal representation.
  • file.modified
    DevelopmentTime when the file content was last modified, in ISO 8601 format.
  • file.name
    DevelopmentName of the file including the extension, without the directory.
  • file.owner.id
    DevelopmentThe user ID (UID) or security identifier (SID) of the file owner.
  • file.owner.name
    DevelopmentUsername of the file owner.
  • file.path
    DevelopmentFull path to the file, including the filename. It should include the drive letter, when appropriate.
  • file.size
    DevelopmentFile size in bytes.
  • file.symbolic_link.target_path
    DevelopmentPath to the target of a symbolic link.

system17 attributes

host15 attributes

  • host.arch
    DevelopmentThe CPU architecture the host system is running on.
  • host.cpu.cache.l2.size
    DevelopmentThe amount of level 2 memory cache available to the processor (in Bytes).
  • host.cpu.family
    DevelopmentFamily or generation of the CPU.
  • host.cpu.model.id
    DevelopmentModel identifier. It provides more granular information about the CPU, distinguishing it from other CPUs within the same family.
  • host.cpu.model.name
    DevelopmentModel designation of the processor.
  • host.cpu.stepping
    DevelopmentStepping or core revisions.
  • host.cpu.vendor.id
    DevelopmentProcessor manufacturer identifier. A maximum 12-character string.
  • host.id
    DevelopmentUnique host ID. For Cloud, this must be the instance_id assigned by the cloud provider. For non-containerized systems, this should be the machine-id. See the ta
  • host.image.id
    DevelopmentVM image ID or host OS image ID. For Cloud, this value is from the provider.
  • host.image.name
    DevelopmentName of the VM image or OS install the host was instantiated from.
  • host.image.version
    DevelopmentThe version string of the VM image or host OS as defined in Version Attributes.
  • host.ip
    DevelopmentAvailable IP addresses of the host, excluding loopback interfaces.
  • host.mac
    DevelopmentAvailable MAC addresses of the host, excluding loopback interfaces.
  • host.name
    DevelopmentName of the host. On UNIX systems, it may contain what the hostname command returns, or the fully qualified hostname, or another name specified by the user.
  • host.type
    DevelopmentType of host. For Cloud, this must be the machine type.

os5 attributes

  • os.build_id
    DevelopmentUnique identifier for a particular build or compilation of the operating system.
  • os.description
    DevelopmentHuman readable (not intended to be parsed) OS version information, like e.g. reported by ver or lsb_release -a commands.
  • os.name
    DevelopmentHuman readable operating system name.
  • os.type
    DevelopmentThe operating system type.
  • os.version
    DevelopmentThe version string of the operating system as defined in Version Attributes.

cpu2 attributes

nfs2 attributes

zos2 attributes

  • zos.smf.id
    DevelopmentThe System Management Facility (SMF) Identifier uniquely identified a z/OS system within a SYSPLEX or mainframe environment and is used for system and performan
  • zos.sysplex.name
    DevelopmentThe name of the SYSPLEX to which the z/OS system belongs too.

disk1 attributes

linux1 attributes

mainframe1 attributes

  • mainframe.lpar.name
    DevelopmentName of the logical partition that hosts a systems with a mainframe operating system.

Recent changes

Breaking and notable changes to this domain across the last 6 semantic-conventions releases.

  • stabilityattributedisk.io.directionPromoted to release_candidate.
  • stabilityattributesystem.paging.fault.typePromoted to release_candidate.
  • stabilityattributecpu.modePromoted to release_candidate.
  • renamedmetricsystem.memory.sharedRenamed to system.memory.linux.shared.

Topics are this site's grouping of upstream namespaces, not a structure the OpenTelemetry project publishes. JSON · All domains