Class ProcessIncubatingAttributes
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic final classValues forPROCESS_CONTEXT_SWITCH_TYPE.static final classDeprecated.static final classValues forPROCESS_PAGING_FAULT_TYPE. -
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final io.opentelemetry.api.common.AttributeKey<Long>Length of the process.command_args arraystatic final io.opentelemetry.api.common.AttributeKey<String>The command used to launch the process (i.e. the command name).All the command arguments (including the command/executable itself) as received by the process.static final io.opentelemetry.api.common.AttributeKey<String>The full command used to launch the process as a single string representing the full command.static final io.opentelemetry.api.common.AttributeKey<String>Specifies whether the context switches for this data point were voluntary or involuntary.static final io.opentelemetry.api.common.AttributeKey<String>Deprecated.Replaced bycpu.mode.static final io.opentelemetry.api.common.AttributeKey<String>The date and time the process was created, in ISO 8601 format.static final io.opentelemetry.semconv.AttributeKeyTemplate<String>Process environment variables,<key>being the environment variable name, the value being the environment variable value.static final io.opentelemetry.api.common.AttributeKey<String>The GNU build ID as found in the.note.gnu.build-idELF section (hex string).static final io.opentelemetry.api.common.AttributeKey<String>The Go build ID as retrieved bygo tool buildid <go executable>.static final io.opentelemetry.api.common.AttributeKey<String>Profiling specific build ID for executables.static final io.opentelemetry.api.common.AttributeKey<String>Deprecated.Replaced byprocess.executable.build_id.htlhash.static final io.opentelemetry.api.common.AttributeKey<String>The name of the process executable.static final io.opentelemetry.api.common.AttributeKey<String>The full path to the process executable.static final io.opentelemetry.api.common.AttributeKey<Long>The exit code of the process.static final io.opentelemetry.api.common.AttributeKey<String>The date and time the process exited, in ISO 8601 format.static final io.opentelemetry.api.common.AttributeKey<Long>The PID of the process's group leader.static final io.opentelemetry.api.common.AttributeKey<Boolean>Whether the process is connected to an interactive shell.static final io.opentelemetry.api.common.AttributeKey<String>The control group associated with the process.static final io.opentelemetry.api.common.AttributeKey<String>The username of the user that owns the process.static final io.opentelemetry.api.common.AttributeKey<String>The type of page fault for this data point.static final io.opentelemetry.api.common.AttributeKey<Long>Parent Process identifier (PPID).static final io.opentelemetry.api.common.AttributeKey<Long>Process identifier (PID).static final io.opentelemetry.api.common.AttributeKey<Long>The real user ID (RUID) of the process.static final io.opentelemetry.api.common.AttributeKey<String>The username of the real user of the process.static final io.opentelemetry.api.common.AttributeKey<String>An additional description about the runtime of the process, for example a specific vendor customization of the runtime environment.static final io.opentelemetry.api.common.AttributeKey<String>The name of the runtime of this process.static final io.opentelemetry.api.common.AttributeKey<String>The version of the runtime of this process, as returned by the runtime without modification.static final io.opentelemetry.api.common.AttributeKey<Long>The saved user ID (SUID) of the process.static final io.opentelemetry.api.common.AttributeKey<String>The username of the saved user.static final io.opentelemetry.api.common.AttributeKey<Long>The PID of the process's session leader.static final io.opentelemetry.api.common.AttributeKey<String>Process title (proctitle)static final io.opentelemetry.api.common.AttributeKey<Long>The effective user ID (EUID) of the process.static final io.opentelemetry.api.common.AttributeKey<String>The username of the effective user of the process.static final io.opentelemetry.api.common.AttributeKey<Long>Virtual process identifier.static final io.opentelemetry.api.common.AttributeKey<String>The working directory of the process. -
Method Summary
-
Field Details
-
PROCESS_ARGS_COUNT
Length of the process.command_args arrayNotes:
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.
-
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 inproc/[pid]/cmdline. On Windows, can be set to the first parameter extracted fromGetCommandLineW. -
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 fromproc/[pid]/cmdline. For libc-based executables, this would be the full argv vector passed tomain. SHOULD NOT be collected by default unless there is sanitization that excludes sensitive data. -
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 ofGetCommandLineW. Do not set this if you have to assemble it just for monitoring; useprocess.command_argsinstead. SHOULD NOT be collected by default unless there is sanitization that excludes sensitive data. -
PROCESS_CONTEXT_SWITCH_TYPE
Specifies whether the context switches for this data point were voluntary or involuntary. -
PROCESS_CPU_STATE
Deprecated.Replaced bycpu.mode.Deprecated, usecpu.modeinstead. -
PROCESS_CREATION_TIME
The date and time the process was created, in ISO 8601 format. -
PROCESS_ENVIRONMENT_VARIABLE
public static final io.opentelemetry.semconv.AttributeKeyTemplate<String> PROCESS_ENVIRONMENT_VARIABLEProcess environment variables,<key>being the environment variable name, the value being the environment variable value.Notes:
Examples:
- an environment variable
USERwith value"ubuntu"SHOULD be recorded as theprocess.environment_variable.USERattribute with value"ubuntu". - an environment variable
PATHwith value"/usr/local/bin:/usr/bin"SHOULD be recorded as theprocess.environment_variable.PATHattribute with value"/usr/local/bin:/usr/bin".
- an environment variable
-
PROCESS_EXECUTABLE_BUILD_ID_GNU
public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_EXECUTABLE_BUILD_ID_GNUThe GNU build ID as found in the.note.gnu.build-idELF section (hex string). -
PROCESS_EXECUTABLE_BUILD_ID_GO
The Go build ID as retrieved bygo tool buildid <go executable>. -
PROCESS_EXECUTABLE_BUILD_ID_HTLHASH
public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_EXECUTABLE_BUILD_ID_HTLHASHProfiling specific build ID for executables. See the OTel specification for Profiles for more information. -
PROCESS_EXECUTABLE_BUILD_ID_PROFILING
@Deprecated public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_EXECUTABLE_BUILD_ID_PROFILINGDeprecated.Replaced byprocess.executable.build_id.htlhash."Deprecated, useprocess.executable.build_id.htlhashinstead." -
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 ofGetProcessImageFileNameW. -
PROCESS_EXECUTABLE_PATH
The full path to the process executable. On Linux based systems, can be set to the target ofproc/[pid]/exe. On Windows, can be set to the result ofGetProcessImageFileNameW. -
PROCESS_EXIT_CODE
The exit code of the process. -
PROCESS_EXIT_TIME
The date and time the process exited, in ISO 8601 format. -
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
Whether the process is connected to an interactive shell. -
PROCESS_LINUX_CGROUP
The control group associated with the process.Notes:
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.
-
PROCESS_OWNER
The username of the user that owns the process. -
PROCESS_PAGING_FAULT_TYPE
The type of page fault for this data point. Typemajoris for major/hard page faults, andminoris for minor/soft page faults. -
PROCESS_PARENT_PID
Parent Process identifier (PPID). -
PROCESS_PID
Process identifier (PID). -
PROCESS_REAL_USER_ID
The real user ID (RUID) of the process. -
PROCESS_REAL_USER_NAME
The username of the real user of the process. -
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
The name of the runtime of this process. -
PROCESS_RUNTIME_VERSION
The version of the runtime of this process, as returned by the runtime without modification. -
PROCESS_SAVED_USER_ID
The saved user ID (SUID) of the process. -
PROCESS_SAVED_USER_NAME
The username of the saved user. -
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 (proctitle)Notes:
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.
-
PROCESS_USER_ID
The effective user ID (EUID) of the process. -
PROCESS_USER_NAME
The username of the effective user of the process. -
PROCESS_VPID
Virtual process identifier.Notes:
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.
-
PROCESS_WORKING_DIRECTORY
The working directory of the process.
-
cpu.mode.