Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add origin_referrer_url and origin_url to the process attribute #1517

Open
wants to merge 20 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
cf92b34
add new attributes to the process model
AsuNa-jp Oct 25, 2024
3caaa00
Update .chloggen/process_originevents.yaml
AsuNa-jp Oct 28, 2024
4ad5fdf
Merge branch 'main' into process_events_fileorigins
AsuNa-jp Oct 28, 2024
2d8178f
Merge branch 'main' into process_events_fileorigins
trisch-me Oct 29, 2024
356c110
add note to zoneid attributes
AsuNa-jp Oct 30, 2024
5bac30a
Merge branch 'main' into process_events_fileorigins
AsuNa-jp Oct 31, 2024
c24ce50
Merge branch 'open-telemetry:main' into process_events_fileorigins
AsuNa-jp Oct 31, 2024
f29e029
Merge branch 'main' into process_events_fileorigins
AsuNa-jp Nov 2, 2024
b69b641
Merge branch 'main' into process_events_fileorigins
AsuNa-jp Nov 5, 2024
df6bc22
Merge branch 'main' into process_events_fileorigins
AsuNa-jp Nov 8, 2024
0856695
Merge branch 'main' into process_events_fileorigins
AsuNa-jp Nov 18, 2024
587f70b
remove zone_identifier
AsuNa-jp Dec 5, 2024
6e52941
reflect the feedback
AsuNa-jp Dec 25, 2024
27a733d
update changelog
AsuNa-jp Dec 25, 2024
d9e9f64
Merge branch 'main' into process_events_fileorigins
trisch-me Dec 30, 2024
7bb2a3d
Merge branch 'main' into process_events_fileorigins
AsuNa-jp Jan 8, 2025
5e2741f
Merge branch 'main' into process_events_fileorigins
trisch-me Jan 10, 2025
d9309b8
Merge branch 'main' into process_events_fileorigins
AsuNa-jp Jan 14, 2025
ad0f670
Merge branch 'main' into process_events_fileorigins
AsuNa-jp Jan 15, 2025
6bb0883
Merge branch 'main' into process_events_fileorigins
AsuNa-jp Jan 24, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions .chloggen/process_originevents.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Use this changelog template to create an entry for release notes.
#
# If your change doesn't affect end users you should instead start
# your pull request title with [chore] or use the "Skip Changelog" label.

# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
change_type: enhancement

# The name of the area of concern in the attributes-registry, (e.g. http, cloud, db)
component: process

# A brief description of the change. Surround your text with quotes ("") if it needs to start with a backtick (`).
note: add process.origin_referrer_url, process.origin_url, and process.zone_identifier

# Mandatory: One or more tracking issues related to the change. You can use the PR number here if no issue exists.
# The values here must be integers.
issues: [1517]

# (Optional) One or more lines of additional information to render under the primary note.
# These lines will be padded with 2 spaces and then inserted directly into the document.
# Use pipe (|) for multiline entries.
subtext:
15 changes: 11 additions & 4 deletions docs/attributes-registry/process.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,8 @@ An operating system process.
| <a id="process-exit-time" href="#process-exit-time">`process.exit.time`</a> | string | The date and time the process exited, in ISO 8601 format. | `2023-11-21T09:26:12.315Z` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-group-leader-pid" href="#process-group-leader-pid">`process.group_leader.pid`</a> | int | The PID of the process's group leader. This is also the process group ID (PGID) of the process. | `23` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-interactive" href="#process-interactive">`process.interactive`</a> | boolean | Whether the process is connected to an interactive shell. | | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-origin-referrer-url" href="#process-origin-referrer-url">`process.origin_referrer_url`</a> | string | The URL of the webpage that linked to the process's executable file. [2] | `http://example.com/article1.html` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-origin-url" href="#process-origin-url">`process.origin_url`</a> | string | The URL where the process's executable file is hosted. [3] | `http://example.com/files/example.exe` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-owner" href="#process-owner">`process.owner`</a> | string | The username of the user that owns the process. | `root` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-paging-fault-type" href="#process-paging-fault-type">`process.paging.fault_type`</a> | string | 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. | `major`; `minor` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-parent-pid" href="#process-parent-pid">`process.parent_pid`</a> | int | Parent Process identifier (PPID). | `111` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
Expand All @@ -42,17 +44,22 @@ An operating system process.
| <a id="process-saved-user-id" href="#process-saved-user-id">`process.saved_user.id`</a> | int | The saved user ID (SUID) of the process. | `1002` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-saved-user-name" href="#process-saved-user-name">`process.saved_user.name`</a> | string | The username of the saved user. | `operator` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-session-leader-pid" href="#process-session-leader-pid">`process.session_leader.pid`</a> | int | The PID of the process's session leader. This is also the session ID (SID) of the process. | `14` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-title" href="#process-title">`process.title`</a> | string | Process title (proctitle) [2] | `cat /etc/hostname`; `xfce4-session`; `bash` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-title" href="#process-title">`process.title`</a> | string | Process title (proctitle) [4] | `cat /etc/hostname`; `xfce4-session`; `bash` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-user-id" href="#process-user-id">`process.user.id`</a> | int | The effective user ID (EUID) of the process. | `1001` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-user-name" href="#process-user-name">`process.user.name`</a> | string | The username of the effective user of the process. | `root` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-vpid" href="#process-vpid">`process.vpid`</a> | int | Virtual process identifier. [3] | `12` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-vpid" href="#process-vpid">`process.vpid`</a> | int | Virtual process identifier. [5] | `12` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-working-directory" href="#process-working-directory">`process.working_directory`</a> | string | The working directory of the process. | `/root` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
| <a id="process-zone-identifier" href="#process-zone-identifier">`process.zone_identifier`</a> | int | Windows Zone Identifier for the process's executable file. | `3` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |

**[1]:** 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.

**[2]:** 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.
**[2]:** This information comes from metadata or alternate data streams linked to the process's executable file. `process.origin_url` represents the URL from which the file was downloaded, and `process.origin_referrer_url` indicates the URL of the page where that URL was listed. There may be cases where both `process.origin_url` and `process.origin_referrer_url` exist, or only one of them is present. Note that the URL itself may contain sensitive information.

**[3]:** 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.
**[3]:** This information comes from metadata or alternate data streams linked to the process's executable file. `process.origin_url` represents the URL from which the file was downloaded, and `process.origin_referrer_url` indicates the URL of the page where that URL was listed. There may be cases where both `process.origin_url` and `process.origin_referrer_url` exist, or only one of them is present. Note that the URL itself may contain sensitive information.

**[4]:** 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.

**[5]:** 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.context_switch_type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

Expand Down
30 changes: 30 additions & 0 deletions model/process/registry.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,30 @@ groups:
requirement_level:
recommended: if `process.command_args` is populated.
examples: [4]
- id: process.origin_referrer_url
type: string
stability: experimental
brief: >
The URL of the webpage that linked to the process's executable file.
note: >
This information comes from metadata or alternate data streams linked to the process's executable file.
`process.origin_url` represents the URL from which the file was downloaded, and `process.origin_referrer_url`
indicates the URL of the page where that URL was listed. There may be cases where both `process.origin_url`
and `process.origin_referrer_url` exist, or only one of them is present. Note that the URL itself may contain
sensitive information.
examples: ['http://example.com/article1.html']
- id: process.origin_url
type: string
stability: experimental
brief: >
The URL where the process's executable file is hosted.
note: >
This information comes from metadata or alternate data streams linked to the process's executable file.
`process.origin_url` represents the URL from which the file was downloaded, and `process.origin_referrer_url`
indicates the URL of the page where that URL was listed. There may be cases where both `process.origin_url`
and `process.origin_referrer_url` exist, or only one of them is present. Note that the URL itself may contain
sensitive information.
examples: ['http://example.com/files/example.exe']
- id: process.owner
type: string
stability: experimental
Expand Down Expand Up @@ -241,3 +265,9 @@ groups:
value: 'minor'
stability: experimental
stability: experimental
- id: process.zone_identifier
type: int
stability: experimental
brief: >
Windows Zone Identifier for the process's executable file.
AsuNa-jp marked this conversation as resolved.
Show resolved Hide resolved
examples: 3