Package io.opentelemetry.semconv.incubating

Class ProcessIncubatingAttributes

java.lang.Object
io.opentelemetry.semconv.incubating.ProcessIncubatingAttributes
public final class ProcessIncubatingAttributes extends Object

  • Field Details

    • PROCESS_ARGS_COUNT

      public static final io.opentelemetry.api.common.AttributeKey<Long> PROCESS_ARGS_COUNT
      Length of the process.command_args array

      Notes:

      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

      public static final io.opentelemetry.api.common.AttributeKey<String> 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

      public static final io.opentelemetry.api.common.AttributeKey<List<String>> 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

      public static final io.opentelemetry.api.common.AttributeKey<String> 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

      public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_CONTEXT_SWITCH_TYPE
      Specifies whether the context switches for this data point were voluntary or involuntary.

    • PROCESS_CPU_STATE

      @Deprecated public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_CPU_STATE
      Deprecated.
      Replaced by cpu.mode.
      Deprecated, use cpu.mode instead.

    • PROCESS_CREATION_TIME

      public static final io.opentelemetry.api.common.AttributeKey<String> 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_VARIABLE
      Process environment variables, <key> being the environment variable name, the value being the environment variable value.

      Notes:

      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".

    • PROCESS_EXECUTABLE_BUILD_ID_GNU

      public static final io.opentelemetry.api.common.AttributeKey<String> 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

      public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_EXECUTABLE_BUILD_ID_GO
      The Go build ID as retrieved by go tool buildid <go executable>.

    • PROCESS_EXECUTABLE_BUILD_ID_HTLHASH

      public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_EXECUTABLE_BUILD_ID_HTLHASH
      Deterministic build ID for executables.

      Notes:

      GNU and Go build IDs may be stripped or unavailable in some environments (e.g., Alpine Linux, Docker images). This attribute provides a deterministic build ID computed by hashing the first and last 4096 bytes of the file along with its length: 

      Input   ← Concat(File[:4096], File[-4096:], BigEndianUInt64(Len(File)))
 Digest  ← SHA256(Input)
 BuildID ← Digest[:16]
      The result is the first 16 bytes (128 bits) of the SHA256 digest, represented as a hex string.

    • PROCESS_EXECUTABLE_BUILD_ID_PROFILING

      @Deprecated public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_EXECUTABLE_BUILD_ID_PROFILING
      Deprecated.
      Replaced by process.executable.build_id.htlhash.
      "Deprecated, use process.executable.build_id.htlhash instead."

    • PROCESS_EXECUTABLE_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> 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

      public static final io.opentelemetry.api.common.AttributeKey<String> 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

      public static final io.opentelemetry.api.common.AttributeKey<Long> PROCESS_EXIT_CODE
      The exit code of the process.

    • PROCESS_EXIT_TIME

      public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_EXIT_TIME
      The date and time the process exited, in ISO 8601 format.

    • PROCESS_GROUP_LEADER_PID

      public static final io.opentelemetry.api.common.AttributeKey<Long> 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

      public static final io.opentelemetry.api.common.AttributeKey<Boolean> PROCESS_INTERACTIVE
      Whether the process is connected to an interactive shell.

    • PROCESS_LINUX_CGROUP

      public static final io.opentelemetry.api.common.AttributeKey<String> 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

      public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_OWNER
      The username of the user that owns the process.

    • PROCESS_PAGING_FAULT_TYPE

      @Deprecated public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_PAGING_FAULT_TYPE
      Deprecated.
      Replaced by system.paging.fault.type.
      Deprecated, use system.paging.fault.type instead.

    • PROCESS_PARENT_PID

      public static final io.opentelemetry.api.common.AttributeKey<Long> PROCESS_PARENT_PID
      Parent Process identifier (PPID).

    • PROCESS_PID

      public static final io.opentelemetry.api.common.AttributeKey<Long> PROCESS_PID
      Process identifier (PID).

    • PROCESS_REAL_USER_ID

      public static final io.opentelemetry.api.common.AttributeKey<Long> PROCESS_REAL_USER_ID
      The real user ID (RUID) of the process.

    • PROCESS_REAL_USER_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_REAL_USER_NAME
      The username of the real user of the process.

    • PROCESS_RUNTIME_DESCRIPTION

      public static final io.opentelemetry.api.common.AttributeKey<String> 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

      public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_RUNTIME_NAME
      The name of the runtime of this process.

    • PROCESS_RUNTIME_VERSION

      public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_RUNTIME_VERSION
      The version of the runtime of this process, as returned by the runtime without modification.

    • PROCESS_SAVED_USER_ID

      public static final io.opentelemetry.api.common.AttributeKey<Long> PROCESS_SAVED_USER_ID
      The saved user ID (SUID) of the process.

    • PROCESS_SAVED_USER_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_SAVED_USER_NAME
      The username of the saved user.

    • PROCESS_SESSION_LEADER_PID

      public static final io.opentelemetry.api.common.AttributeKey<Long> PROCESS_SESSION_LEADER_PID
      The PID of the process's session leader. This is also the session ID (SID) of the process.

    • PROCESS_STATE

      public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_STATE
      The process state, e.g., Linux Process State Codes

    • PROCESS_TITLE

      public static final io.opentelemetry.api.common.AttributeKey<String> 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

      public static final io.opentelemetry.api.common.AttributeKey<Long> PROCESS_USER_ID
      The effective user ID (EUID) of the process.

    • PROCESS_USER_NAME

      public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_USER_NAME
      The username of the effective user of the process.

    • PROCESS_VPID

      public static final io.opentelemetry.api.common.AttributeKey<Long> 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

      public static final io.opentelemetry.api.common.AttributeKey<String> PROCESS_WORKING_DIRECTORY
      The working directory of the process.