semantic-conventions/docs/attributes-registry/system.md

System

• General System Attributes
• System CPU Attributes
• Filesystem Attributes
• System Memory Attributes
• System Paging Attributes
• System Process Attributes
• Deprecated System Attributes

General System Attributes

Describes System attributes

Attribute	Type	Description	Examples	Stability
system.device	string	The device identifier	(identifier)

System CPU Attributes

Describes System CPU attributes

Attribute	Type	Description	Examples	Stability
system.cpu.logical_number	int	The logical CPU number [0..n-1]	1

Filesystem Attributes

Describes Filesystem attributes

Attribute	Type	Description	Examples	Stability
system.filesystem.mode	string	The filesystem mode	rw, ro
system.filesystem.mountpoint	string	The filesystem mount path	/mnt/data
system.filesystem.state	string	The filesystem state	used
system.filesystem.type	string	The filesystem type	ext4

---

system.filesystem.state 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.

Value	Description	Stability
free	free
reserved	reserved
used	used

---

system.filesystem.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.

Value	Description	Stability
exfat	exfat
ext4	ext4
fat32	fat32
hfsplus	hfsplus
ntfs	ntfs
refs	refs

System Memory Attributes

Describes System Memory attributes

Attribute	Type	Description	Examples	Stability
system.memory.state	string	The memory state	free; cached

---

system.memory.state 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.

Value	Description	Stability
buffers	buffers
cached	cached
free	free
shared	shared	Removed, report shared memory usage with metric.system.memory.shared metric
used	used

System Paging Attributes

Describes System Memory Paging attributes

Attribute	Type	Description	Examples	Stability
system.paging.direction	string	The paging access direction	in
system.paging.state	string	The memory paging state	free
system.paging.type	string	The memory paging type	minor

---

system.paging.direction 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.

Value	Description	Stability
in	in
out	out

---

system.paging.state 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.

Value	Description	Stability
free	free
used	used

---

system.paging.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.

Value	Description	Stability
major	major
minor	minor

System Process Attributes

Describes System Process attributes

Attribute	Type	Description	Examples	Stability
system.process.status	string	The process state, e.g., Linux Process State Codes	running

---

system.process.status 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.

Value	Description	Stability
defunct	defunct
running	running
sleeping	sleeping
stopped	stopped

Deprecated System Attributes

Deprecated system attributes.

Attribute	Type	Description	Examples	Stability
system.cpu.state	string	Deprecated, use cpu.mode instead.	idle; interrupt	Replaced by cpu.mode
system.network.state	string	Deprecated, use network.connection.state instead.	close_wait	Removed, report network connection state with network.connection.state attribute
system.processes.status	string	Deprecated, use system.process.status instead.	running	Replaced by system.process.status.

---

system.cpu.state 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.

Value	Description	Stability
idle	idle
interrupt	interrupt
iowait	iowait
nice	nice
steal	steal
system	system
user	user

---

system.network.state 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.

Value	Description	Stability
close	close
close_wait	close_wait
closing	closing
delete	delete
established	established
fin_wait_1	fin_wait_1
fin_wait_2	fin_wait_2
last_ack	last_ack
listen	listen
syn_recv	syn_recv
syn_sent	syn_sent
time_wait	time_wait

---

system.processes.status 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.

Value	Description	Stability
defunct	defunct
running	running
sleeping	sleeping
stopped	stopped