You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: projects/resources-and-entities.md
+5-9Lines changed: 5 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
## Description
4
4
5
-
OpenTelemetry's usage of Resource has a number of known problems (see listed below). The Project's and the SIG's charter is to solve these and related problems.
5
+
OpenTelemetry's usage of Resource has a number of known problems (see listed below). The Project's and the SIG's charter is to solve these and related problems.
6
6
7
7
The background work on these problems and coming up with potential solutions have been in progress for more than a year now, with participation of the listed sponsors and other interested contributors. We have been waiting until there is sufficient understanding of what and how we would like to solve these problems and also until we are certain there is significant available contributing capacity and interest.
8
8
@@ -20,7 +20,7 @@ The problem with such usage is that by looking at the Resource attributes it is
20
20
21
21
The Resource is one set of attributes, which contains all attributes of all entities that the Resource represents. It is impossible to tell which of these attributes identify the entity (or entities) and which are non-identifying, i.e. purely descriptive.
22
22
23
-
This lack of precise identity makes it difficult or impossible to identify the same entities reported in different Resources.
23
+
This lack of precise identity makes it difficult or impossible to identify the same entities reported in different Resources.
24
24
25
25
### Problem 3: Lack of Mutable Attributes
26
26
@@ -37,15 +37,15 @@ It is clear that the strictly "immutable" definition of the Resource is not suff
37
37
38
38
Today every attribute in an OpenTelemetry Resource, according to the metric data model, is used to determine the identity of a metric. Given known issues in metric time-series database implementations around cardinality, this can cause major issues if Resources are allowed to leverage high cardinality attributes.
39
39
40
-
Given many Resource attribute semantic conventions today were defined for tracing instrumentation, we do find many high cardinality definitions, e.g. the [Process](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/resource/process.md#process) resource includes `pid` and and `parent_pid`, which are known to churn between instances of an application and would lead to higher cardinality streams.
40
+
Given many Resource attribute semantic conventions today were defined for tracing instrumentation, we do find many high cardinality definitions, e.g. the [Process](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/resource/process.md#process) resource includes `pid` and and `parent_pid`, which are known to churn between instances of an application and would lead to higher cardinality streams.
41
41
42
42
Many metric backends are simply erasing resource attributes from metrics to workaround the issue. Here's an example [solution for prometheus](https://github.com/open-telemetry/opentelemetry-specification/issues/1782), and [another proposal for yet another point-fix for prometheus](https://github.com/open-telemetry/opentelemetry-specification/pull/2736).
43
43
44
44
However, these workarounds prevent Metrics users from regaining descriptive attributes (and benefits) of current Otel Resource detection.
45
45
46
46
Source: [see this issue](https://github.com/open-telemetry/opentelemetry-specification/issues/2775).
47
47
48
-
### Further Reading
48
+
### Further Reading
49
49
50
50
For more details on the problems and proposed solutions please [see this document](https://docs.google.com/document/d/1VUdBRInLEhO_0ABAoiLEssB1CQO_IcD5zDnaMEha42w/edit).
51
51
@@ -115,8 +115,4 @@ All PRs, Issues, and OTEPs related to the project should link back to the tracki
115
115
116
116
## Project Board
117
117
118
-
Once approved by TC, a project should be managed using a GitHub project board. This project board should be pre-populated with issues that cover all known deliverables, organized by timeline milestones.
119
-
120
-
A Technical Committee (TC) member associated with the project can create the board, along with a new project-specific GitHub label to automatically associate issues and PRs with the project. The project lead and all other relevant project members should have edit access to the board.
121
-
122
-
Once created, please link to the project board here.
118
+
[Entities and Resource project board](https://github.com/orgs/open-telemetry/projects/85)
0 commit comments