OpenTelemetry PHP

ProcessIncubatingAttributes

Semantic attributes and corresponding values for process.

Tags
see
https://opentelemetry.io/docs/specs/semconv/registry/attributes/process/

May contain @experimental Semantic Conventions which may change or be removed in the future.

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
experimental

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
experimental

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
experimental

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
experimental

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
experimental

PROCESS_CONTEXT_SWITCH_TYPE_VALUE_INVOLUNTARY

none

public mixed PROCESS_CONTEXT_SWITCH_TYPE_VALUE_INVOLUNTARY = 'involuntary'
Tags
experimental

PROCESS_CONTEXT_SWITCH_TYPE_VALUE_VOLUNTARY

none

public mixed PROCESS_CONTEXT_SWITCH_TYPE_VALUE_VOLUNTARY = 'voluntary'
Tags
experimental

PROCESS_CREATION_TIME

The date and time the process was created, in ISO 8601 format.

public mixed PROCESS_CREATION_TIME = 'process.creation.time'
Tags
experimental

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 the process.environment_variable.USER attribute with value "ubuntu".
  • an environment variable PATH with value "/usr/local/bin:/usr/bin" SHOULD be recorded as the process.environment_variable.PATH attribute with value "/usr/local/bin:/usr/bin".
Tags
experimental

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
experimental

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
experimental

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
experimental

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
experimental

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
experimental

PROCESS_EXIT_CODE

The exit code of the process.

public mixed PROCESS_EXIT_CODE = 'process.exit.code'
Tags
experimental

PROCESS_EXIT_TIME

The date and time the process exited, in ISO 8601 format.

public mixed PROCESS_EXIT_TIME = 'process.exit.time'
Tags
experimental

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
experimental

PROCESS_INTERACTIVE

Whether the process is connected to an interactive shell.

public mixed PROCESS_INTERACTIVE = 'process.interactive'
Tags
experimental

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
experimental

PROCESS_OWNER

The username of the user that owns the process.

public mixed PROCESS_OWNER = 'process.owner'
Tags
experimental

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
experimental

PROCESS_PAGING_FAULT_TYPE_VALUE_MAJOR

none

public mixed PROCESS_PAGING_FAULT_TYPE_VALUE_MAJOR = 'major'
Tags
experimental

PROCESS_PAGING_FAULT_TYPE_VALUE_MINOR

none

public mixed PROCESS_PAGING_FAULT_TYPE_VALUE_MINOR = 'minor'
Tags
experimental

PROCESS_PARENT_PID

Parent Process identifier (PPID).

public mixed PROCESS_PARENT_PID = 'process.parent_pid'
Tags
experimental

PROCESS_REAL_USER_ID

The real user ID (RUID) of the process.

public mixed PROCESS_REAL_USER_ID = 'process.real_user.id'
Tags
experimental

PROCESS_REAL_USER_NAME

The username of the real user of the process.

public mixed PROCESS_REAL_USER_NAME = 'process.real_user.name'
Tags
experimental

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
experimental

PROCESS_RUNTIME_NAME

The name of the runtime of this process.

public mixed PROCESS_RUNTIME_NAME = 'process.runtime.name'
Tags
experimental

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
experimental

PROCESS_SAVED_USER_ID

The saved user ID (SUID) of the process.

public mixed PROCESS_SAVED_USER_ID = 'process.saved_user.id'
Tags
experimental

PROCESS_SAVED_USER_NAME

The username of the saved user.

public mixed PROCESS_SAVED_USER_NAME = 'process.saved_user.name'
Tags
experimental

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
experimental

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
experimental

PROCESS_USER_ID

The effective user ID (EUID) of the process.

public mixed PROCESS_USER_ID = 'process.user.id'
Tags
experimental

PROCESS_USER_NAME

The username of the effective user of the process.

public mixed PROCESS_USER_NAME = 'process.user.name'
Tags
experimental

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
experimental

PROCESS_WORKING_DIRECTORY

The working directory of the process.

public mixed PROCESS_WORKING_DIRECTORY = 'process.working_directory'
Tags
experimental

        
On this page

Search results