diff --git a/docs/attributes-registry/process.md b/docs/attributes-registry/process.md index 7b9dd83193..969bb6dc5f 100644 --- a/docs/attributes-registry/process.md +++ b/docs/attributes-registry/process.md @@ -11,7 +11,7 @@ | `process.command` | string | 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`. | `cmd/otelcol` | | `process.command_args` | string[] | 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`. | `[cmd/otecol, --config=config.yaml]` | | `process.command_line` | string | 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. | `C:\cmd\otecol --config="my directory\config.yaml"` | -| `process.end` | string | The date and time the process ended. | `2023-11-21T09:26:12.315Z` | +| `process.end` | string | The date and time the process ended, in ISO 8601 format. | `2023-11-21T09:26:12.315Z` | | `process.env_vars` | string[] | Array of environment variable bindings. [1] | `[PATH=/usr/local/bin;/usr/bin, USER=ubuntu]` | | `process.executable.name` | string | The name of the process executable. On Linux based systems, can be set to the `Name` in `proc/[pid]/status`. On Windows, can be set to the base name of `GetProcessImageFileNameW`. | `otelcol` | | `process.executable.path` | string | 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`. | `/usr/bin/cmd/otelcol` | @@ -19,7 +19,7 @@ | `process.group_leader.pid` | int | The PID of the process's group leader. This is also the process group ID (PGID) of the process. | `23` | | `process.interactive` | boolean | Whether the process is connected to an interactive shell. | | | `process.owner` | string | The username of the user that owns the process. [2] | `root` | -| `process.parent_pid` | int | Parent Process identifier (PPID). | `111` | +| `process.parent.pid` | int | Parent Process identifier (PPID). | `111` | | `process.pid` | int | Process identifier (PID). | `1234` | | `process.real_user.id` | int | The real user ID (RUID) of the process. | `1000` | | `process.real_user.name` | string | The username of the real user of the process. | `operator` | @@ -29,7 +29,7 @@ | `process.saved_user.id` | int | The saved user ID (SUID) of the process. | `1002` | | `process.saved_user.name` | string | The username of the saved user. | `operator` | | `process.session_leader.pid` | int | The PID of the process's session leader. This is also the session ID (SID) of the process. | `14` | -| `process.start` | string | The date and time the process started. | `2023-11-21T09:25:34.853Z` | +| `process.start` | string | The date and time the process started, in ISO 8601 format. | `2023-11-21T09:25:34.853Z` | | `process.user.id` | int | The effective user ID (EUID) of the process. | `1001` | | `process.user.name` | string | The username of the effective user of the process. | `root` | | `process.vpid` | int | Virtual process identifier. [3] | `12` | diff --git a/docs/resource/process.md b/docs/resource/process.md index 58b2ee7249..75aeb4ae77 100644 --- a/docs/resource/process.md +++ b/docs/resource/process.md @@ -33,7 +33,7 @@ | [`process.executable.name`](../attributes-registry/process.md) | string | The name of the process executable. On Linux based systems, can be set to the `Name` in `proc/[pid]/status`. On Windows, can be set to the base name of `GetProcessImageFileNameW`. | `otelcol` | Conditionally Required: See alternative attributes below. | | [`process.executable.path`](../attributes-registry/process.md) | string | 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`. | `/usr/bin/cmd/otelcol` | Conditionally Required: See alternative attributes below. | | [`process.owner`](../attributes-registry/process.md) | string | The username of the user that owns the process. [1] | `root` | Recommended | -| [`process.parent_pid`](../attributes-registry/process.md) | int | Parent Process identifier (PPID). | `111` | Recommended | +| [`process.parent.pid`](../attributes-registry/process.md) | int | Parent Process identifier (PPID). | `111` | Recommended | | [`process.pid`](../attributes-registry/process.md) | int | Process identifier (PID). | `1234` | Recommended | **[1]:** This is intended to be used with Windows only. On POSIX systems, processes can have multiple users (effective, real and saved). To avoid confusion about which user is being referenced, this field should not be used with POSIX systems. diff --git a/model/registry/process.yaml b/model/registry/process.yaml index 09ebd3e755..c91c4a7126 100644 --- a/model/registry/process.yaml +++ b/model/registry/process.yaml @@ -143,12 +143,12 @@ groups: - id: start type: string brief: > - The date and time the process started. + The date and time the process started, in ISO 8601 format. examples: ['2023-11-21T09:25:34.853Z'] - id: end type: string brief: > - The date and time the process ended. + The date and time the process ended, in ISO 8601 format. examples: ['2023-11-21T09:26:12.315Z'] - id: exit_code type: int