ProcessIncubatingAttributes
in
Semantic attributes and corresponding values for process.
Tags
Table of Contents
Constants
- PROCESS_ARGS_COUNT = 'process.args_count'
- Length of the process.command_args array
- PROCESS_COMMAND = 'process.command'
- The command used to launch the process (i.e. the command name). On Linux based systems, can be set to the zeroth string in `proc/[pid]/cmdline`. On Windows, can be set to the first parameter extracted from `GetCommandLineW`.
- PROCESS_COMMAND_ARGS = 'process.command_args'
- All the command arguments (including the command/executable itself) as received by the process. On Linux-based systems (and some other Unixoid systems supporting procfs), can be set according to the list of null-delimited strings extracted from `proc/[pid]/cmdline`. For libc-based executables, this would be the full argv vector passed to `main`. SHOULD NOT be collected by default unless there is sanitization that excludes sensitive data.
- PROCESS_COMMAND_LINE = 'process.command_line'
- The full command used to launch the process as a single string representing the full command. On Windows, can be set to the result of `GetCommandLineW`. Do not set this if you have to assemble it just for monitoring; use `process.command_args` instead. SHOULD NOT be collected by default unless there is sanitization that excludes sensitive data.
- PROCESS_CONTEXT_SWITCH_TYPE = 'process.context_switch_type'
- Specifies whether the context switches for this data point were voluntary or involuntary.
- PROCESS_CONTEXT_SWITCH_TYPE_VALUE_INVOLUNTARY = 'involuntary'
- none
- PROCESS_CONTEXT_SWITCH_TYPE_VALUE_VOLUNTARY = 'voluntary'
- none
- PROCESS_CREATION_TIME = 'process.creation.time'
- The date and time the process was created, in ISO 8601 format.
- PROCESS_ENVIRONMENT_VARIABLE = 'process.environment_variable'
- Process environment variables, `<key>` being the environment variable name, the value being the environment variable value.
- PROCESS_EXECUTABLE_BUILD_ID_GNU = 'process.executable.build_id.gnu'
- The GNU build ID as found in the `.note.gnu.build-id` ELF section (hex string).
- PROCESS_EXECUTABLE_BUILD_ID_GO = 'process.executable.build_id.go'
- The Go build ID as retrieved by `go tool buildid <go executable>`.
- PROCESS_EXECUTABLE_BUILD_ID_HTLHASH = 'process.executable.build_id.htlhash'
- Profiling specific build ID for executables. See the OTel specification for Profiles for more information.
- PROCESS_EXECUTABLE_NAME = 'process.executable.name'
- The name of the process executable. On Linux based systems, this SHOULD be set to the base name of the target of `/proc/[pid]/exe`. On Windows, this SHOULD be set to the base name of `GetProcessImageFileNameW`.
- PROCESS_EXECUTABLE_PATH = 'process.executable.path'
- The full path to the process executable. On Linux based systems, can be set to the target of `proc/[pid]/exe`. On Windows, can be set to the result of `GetProcessImageFileNameW`.
- PROCESS_EXIT_CODE = 'process.exit.code'
- The exit code of the process.
- PROCESS_EXIT_TIME = 'process.exit.time'
- The date and time the process exited, in ISO 8601 format.
- PROCESS_GROUP_LEADER_PID = 'process.group_leader.pid'
- The PID of the process's group leader. This is also the process group ID (PGID) of the process.
- PROCESS_INTERACTIVE = 'process.interactive'
- Whether the process is connected to an interactive shell.
- PROCESS_LINUX_CGROUP = 'process.linux.cgroup'
- The control group associated with the process.
- PROCESS_OWNER = 'process.owner'
- The username of the user that owns the process.
- PROCESS_PAGING_FAULT_TYPE = 'process.paging.fault_type'
- The type of page fault for this data point. Type `major` is for major/hard page faults, and `minor` is for minor/soft page faults.
- PROCESS_PAGING_FAULT_TYPE_VALUE_MAJOR = 'major'
- none
- PROCESS_PAGING_FAULT_TYPE_VALUE_MINOR = 'minor'
- none
- PROCESS_PARENT_PID = 'process.parent_pid'
- Parent Process identifier (PPID).
- PROCESS_PID = 'process.pid'
- Process identifier (PID).
- PROCESS_REAL_USER_ID = 'process.real_user.id'
- The real user ID (RUID) of the process.
- PROCESS_REAL_USER_NAME = 'process.real_user.name'
- The username of the real user of the process.
- PROCESS_RUNTIME_DESCRIPTION = 'process.runtime.description'
- An additional description about the runtime of the process, for example a specific vendor customization of the runtime environment.
- PROCESS_RUNTIME_NAME = 'process.runtime.name'
- The name of the runtime of this process.
- PROCESS_RUNTIME_VERSION = 'process.runtime.version'
- The version of the runtime of this process, as returned by the runtime without modification.
- PROCESS_SAVED_USER_ID = 'process.saved_user.id'
- The saved user ID (SUID) of the process.
- PROCESS_SAVED_USER_NAME = 'process.saved_user.name'
- The username of the saved user.
- PROCESS_SESSION_LEADER_PID = 'process.session_leader.pid'
- The PID of the process's session leader. This is also the session ID (SID) of the process.
- PROCESS_TITLE = 'process.title'
- Process title (proctitle)
- PROCESS_USER_ID = 'process.user.id'
- The effective user ID (EUID) of the process.
- PROCESS_USER_NAME = 'process.user.name'
- The username of the effective user of the process.
- PROCESS_VPID = 'process.vpid'
- Virtual process identifier.
- PROCESS_WORKING_DIRECTORY = 'process.working_directory'
- The working directory of the process.
Constants
PROCESS_ARGS_COUNT
Length of the process.command_args array
public
mixed
PROCESS_ARGS_COUNT
= 'process.args_count'
This field can be useful for querying or performing bucket analysis on how many arguments were provided to start a process. More arguments may be an indication of suspicious activity.
Tags
PROCESS_COMMAND
The command used to launch the process (i.e. the command name). On Linux based systems, can be set to the zeroth string in `proc/[pid]/cmdline`. On Windows, can be set to the first parameter extracted from `GetCommandLineW`.
public
mixed
PROCESS_COMMAND
= 'process.command'
Tags
PROCESS_COMMAND_ARGS
All the command arguments (including the command/executable itself) as received by the process. On Linux-based systems (and some other Unixoid systems supporting procfs), can be set according to the list of null-delimited strings extracted from `proc/[pid]/cmdline`. For libc-based executables, this would be the full argv vector passed to `main`. SHOULD NOT be collected by default unless there is sanitization that excludes sensitive data.
public
mixed
PROCESS_COMMAND_ARGS
= 'process.command_args'
Tags
PROCESS_COMMAND_LINE
The full command used to launch the process as a single string representing the full command. On Windows, can be set to the result of `GetCommandLineW`. Do not set this if you have to assemble it just for monitoring; use `process.command_args` instead. SHOULD NOT be collected by default unless there is sanitization that excludes sensitive data.
public
mixed
PROCESS_COMMAND_LINE
= 'process.command_line'
Tags
PROCESS_CONTEXT_SWITCH_TYPE
Specifies whether the context switches for this data point were voluntary or involuntary.
public
mixed
PROCESS_CONTEXT_SWITCH_TYPE
= 'process.context_switch_type'
Tags
PROCESS_CONTEXT_SWITCH_TYPE_VALUE_INVOLUNTARY
none
public
mixed
PROCESS_CONTEXT_SWITCH_TYPE_VALUE_INVOLUNTARY
= 'involuntary'
Tags
PROCESS_CONTEXT_SWITCH_TYPE_VALUE_VOLUNTARY
none
public
mixed
PROCESS_CONTEXT_SWITCH_TYPE_VALUE_VOLUNTARY
= 'voluntary'
Tags
PROCESS_CREATION_TIME
The date and time the process was created, in ISO 8601 format.
public
mixed
PROCESS_CREATION_TIME
= 'process.creation.time'
Tags
PROCESS_ENVIRONMENT_VARIABLE
Process environment variables, `<key>` being the environment variable name, the value being the environment variable value.
public
mixed
PROCESS_ENVIRONMENT_VARIABLE
= 'process.environment_variable'
Examples:
- an environment variable
USER
with value"ubuntu"
SHOULD be recorded as theprocess.environment_variable.USER
attribute with value"ubuntu"
. - an environment variable
PATH
with value"/usr/local/bin:/usr/bin"
SHOULD be recorded as theprocess.environment_variable.PATH
attribute with value"/usr/local/bin:/usr/bin"
.
Tags
PROCESS_EXECUTABLE_BUILD_ID_GNU
The GNU build ID as found in the `.note.gnu.build-id` ELF section (hex string).
public
mixed
PROCESS_EXECUTABLE_BUILD_ID_GNU
= 'process.executable.build_id.gnu'
Tags
PROCESS_EXECUTABLE_BUILD_ID_GO
The Go build ID as retrieved by `go tool buildid <go executable>`.
public
mixed
PROCESS_EXECUTABLE_BUILD_ID_GO
= 'process.executable.build_id.go'
Tags
PROCESS_EXECUTABLE_BUILD_ID_HTLHASH
Profiling specific build ID for executables. See the OTel specification for Profiles for more information.
public
mixed
PROCESS_EXECUTABLE_BUILD_ID_HTLHASH
= 'process.executable.build_id.htlhash'
Tags
PROCESS_EXECUTABLE_NAME
The name of the process executable. On Linux based systems, this SHOULD be set to the base name of the target of `/proc/[pid]/exe`. On Windows, this SHOULD be set to the base name of `GetProcessImageFileNameW`.
public
mixed
PROCESS_EXECUTABLE_NAME
= 'process.executable.name'
Tags
PROCESS_EXECUTABLE_PATH
The full path to the process executable. On Linux based systems, can be set to the target of `proc/[pid]/exe`. On Windows, can be set to the result of `GetProcessImageFileNameW`.
public
mixed
PROCESS_EXECUTABLE_PATH
= 'process.executable.path'
Tags
PROCESS_EXIT_CODE
The exit code of the process.
public
mixed
PROCESS_EXIT_CODE
= 'process.exit.code'
Tags
PROCESS_EXIT_TIME
The date and time the process exited, in ISO 8601 format.
public
mixed
PROCESS_EXIT_TIME
= 'process.exit.time'
Tags
PROCESS_GROUP_LEADER_PID
The PID of the process's group leader. This is also the process group ID (PGID) of the process.
public
mixed
PROCESS_GROUP_LEADER_PID
= 'process.group_leader.pid'
Tags
PROCESS_INTERACTIVE
Whether the process is connected to an interactive shell.
public
mixed
PROCESS_INTERACTIVE
= 'process.interactive'
Tags
PROCESS_LINUX_CGROUP
The control group associated with the process.
public
mixed
PROCESS_LINUX_CGROUP
= 'process.linux.cgroup'
Control groups (cgroups) are a kernel feature used to organize and manage process resources. This attribute provides the path(s) to the cgroup(s) associated with the process, which should match the contents of the /proc/[PID]/cgroup file.
Tags
PROCESS_OWNER
The username of the user that owns the process.
public
mixed
PROCESS_OWNER
= 'process.owner'
Tags
PROCESS_PAGING_FAULT_TYPE
The type of page fault for this data point. Type `major` is for major/hard page faults, and `minor` is for minor/soft page faults.
public
mixed
PROCESS_PAGING_FAULT_TYPE
= 'process.paging.fault_type'
Tags
PROCESS_PAGING_FAULT_TYPE_VALUE_MAJOR
none
public
mixed
PROCESS_PAGING_FAULT_TYPE_VALUE_MAJOR
= 'major'
Tags
PROCESS_PAGING_FAULT_TYPE_VALUE_MINOR
none
public
mixed
PROCESS_PAGING_FAULT_TYPE_VALUE_MINOR
= 'minor'
Tags
PROCESS_PARENT_PID
Parent Process identifier (PPID).
public
mixed
PROCESS_PARENT_PID
= 'process.parent_pid'
Tags
PROCESS_PID
Process identifier (PID).
public
mixed
PROCESS_PID
= 'process.pid'
Tags
PROCESS_REAL_USER_ID
The real user ID (RUID) of the process.
public
mixed
PROCESS_REAL_USER_ID
= 'process.real_user.id'
Tags
PROCESS_REAL_USER_NAME
The username of the real user of the process.
public
mixed
PROCESS_REAL_USER_NAME
= 'process.real_user.name'
Tags
PROCESS_RUNTIME_DESCRIPTION
An additional description about the runtime of the process, for example a specific vendor customization of the runtime environment.
public
mixed
PROCESS_RUNTIME_DESCRIPTION
= 'process.runtime.description'
Tags
PROCESS_RUNTIME_NAME
The name of the runtime of this process.
public
mixed
PROCESS_RUNTIME_NAME
= 'process.runtime.name'
Tags
PROCESS_RUNTIME_VERSION
The version of the runtime of this process, as returned by the runtime without modification.
public
mixed
PROCESS_RUNTIME_VERSION
= 'process.runtime.version'
Tags
PROCESS_SAVED_USER_ID
The saved user ID (SUID) of the process.
public
mixed
PROCESS_SAVED_USER_ID
= 'process.saved_user.id'
Tags
PROCESS_SAVED_USER_NAME
The username of the saved user.
public
mixed
PROCESS_SAVED_USER_NAME
= 'process.saved_user.name'
Tags
PROCESS_SESSION_LEADER_PID
The PID of the process's session leader. This is also the session ID (SID) of the process.
public
mixed
PROCESS_SESSION_LEADER_PID
= 'process.session_leader.pid'
Tags
PROCESS_TITLE
Process title (proctitle)
public
mixed
PROCESS_TITLE
= 'process.title'
In many Unix-like systems, process title (proctitle), is the string that represents the name or command line of a running process, displayed by system monitoring tools like ps, top, and htop.
Tags
PROCESS_USER_ID
The effective user ID (EUID) of the process.
public
mixed
PROCESS_USER_ID
= 'process.user.id'
Tags
PROCESS_USER_NAME
The username of the effective user of the process.
public
mixed
PROCESS_USER_NAME
= 'process.user.name'
Tags
PROCESS_VPID
Virtual process identifier.
public
mixed
PROCESS_VPID
= 'process.vpid'
The process ID within a PID namespace. This is not necessarily unique across all processes on the host but it is unique within the process namespace that the process exists within.
Tags
PROCESS_WORKING_DIRECTORY
The working directory of the process.
public
mixed
PROCESS_WORKING_DIRECTORY
= 'process.working_directory'