Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit 47c28ea

Browse files
committedJun 15, 2020
Added semantic conventions for the "process" resource
1 parent 1729bc4 commit 47c28ea

File tree

2 files changed

+21
-1
lines changed

2 files changed

+21
-1
lines changed
 

‎CHANGELOG.md

+2
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ the release.
77

88
## Unreleased
99

10+
- Add semantic conventions for process resource.
11+
1012
## v0.5.0 (06-02-2020)
1113

1214
- Define Log Data Model.

‎specification/resource/semantic_conventions/README.md

+19-1
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ This document defines standard attributes for resources. These attributes are ty
88
- [Compute Unit](#compute-unit)
99
* [Container](#container)
1010
* [Function as a Service](#function-as-a-service)
11+
* [Process](#process)
1112
- [Deployment Service](#deployment-service)
1213
* [Kubernetes](#kubernetes)
1314
- [Compute Instance](#compute-instance)
@@ -19,7 +20,7 @@ This document defines standard attributes for resources. These attributes are ty
1920

2021
## TODOs
2122

22-
* Add more compute units: Process, AppEngine unit, etc.
23+
* Add more compute units: AppEngine unit, etc.
2324
* Add Device (mobile) and Web Browser.
2425
* Decide if lower case strings only.
2526
* Consider to add optional/required for each attribute and combination of attributes
@@ -113,6 +114,23 @@ Note: The resource attribute `faas.instance` differs from the span attribute `fa
113114
[ARN]:https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
114115
[FunctionDirectory]: https://github.com/Azure/azure-functions-host/wiki/Retrieving-information-about-the-currently-running-function
115116

117+
### Process
118+
119+
**type:** `process`
120+
121+
**Description:** An operating system process.
122+
123+
| Attribute | Description | Example | Required |
124+
|---|---|---|--|
125+
| process.pid | Process identifier (PID). | `1234` | Yes |
126+
| process.executable_name | The name of the process executable. On Unix based systems, can be set to the `Name` in `proc/[pid]/status`. On Windows, can be set to the base name of `GetProcessImageFileNameW`. | `otelcol` | See below |
127+
| process.executable_path | The full path to the process executable. On Unix 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` | See below |
128+
| process.command | The command used to launch the process (i.e. the command name). On Unix 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` | See below |
129+
| process.commandline | The full command used to launch the process. This can be a nil- or space-delimited string. On Unix based systems, can be set to the full `proc/[pid]/cmdline` string. On Windows, can be set to the result of `GetCommandLineW`. | `cmd/otecol --config=config.yaml` | See below |
130+
| process.owner | The username of the user that owns the process. | `root` | No |
131+
132+
At least one of `process.executable_name`, `process.executable_path`, `process.command`, or `process.commandline` is required.
133+
116134
## Deployment Service
117135

118136
Attributes defining a deployment service (e.g. Kubernetes).

0 commit comments

Comments
 (0)