Skip to content
This repository has been archived by the owner on Dec 6, 2024. It is now read-only.

Propose: Remove support to report out-of-band telemetry from the API #26

Merged
merged 7 commits into from
Sep 12, 2019

Conversation

bogdandrutu
Copy link
Member

No description provided.

Copy link
Contributor

@jmacd jmacd left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a good step towards our 1.0 goals. We can always add something like this in the future. For now, if a user wants to alter the resources they can construct alternate SDKx, later we can evaluate how much complexity is introduced if individual spans and metrics operations can vary resources.

text/0007-no-out-of-band-reporting.md Outdated Show resolved Hide resolved
text/0007-no-out-of-band-reporting.md Outdated Show resolved Hide resolved
bogdandrutu and others added 2 commits August 27, 2019 13:41
Co-Authored-By: Yang Song <songy23@users.noreply.github.com>
Co-Authored-By: Yang Song <songy23@users.noreply.github.com>
alban added a commit to kinvolk/opentelemetry-python that referenced this pull request Aug 28, 2019
OTEP-7 ("Remove support to report out-of-band telemetry from the API")
states that the API does not support specifying the span_id in
create_span() or start_span(). Also, following OTEP-2 ("Remove
SpanData"), we cannot use the SpanData to specify the span_id.

However, the need to specify the span_id remains for some applications.
Following the suggestion from OTEP-7, I am adding this feature in the
SDK only.

This patch adds the named argument span_id in create_span() and
start_span() to optionally specify the id of the span to be created.
When unset, the previous behavior remains and the SDK allocate a span_id
automatically.

Callers should give the name of the argument and not rely on the
current argument order because more arguments could be passed in the
future. OTEP-2 lists possible additional optional arguments:
- start timestamp
- span ID
- resource

Example of call:
    with tracer.start_span('foo', span_id = my_span_id):
        print(Context)

OTEP-7: open-telemetry/oteps#26
OTEP-2: https://github.com/open-telemetry/oteps/blob/master/text/0002-remove-spandata.md
alban added a commit to kinvolk/opentelemetry-python that referenced this pull request Aug 28, 2019
OTEP-7 ("Remove support to report out-of-band telemetry from the API")
states that the API does not support specifying the span_id in
create_span() or start_span(). Also, following OTEP-2 ("Remove
SpanData"), we cannot use the SpanData to specify the span_id.

However, the need to specify the span_id remains for some applications.
Following the suggestion from OTEP-7, I am adding this feature in the
SDK only.

This patch adds the named argument span_id in create_span() and
start_span() to optionally specify the id of the span to be created.
When unset, the previous behavior remains and the SDK allocates a
span_id automatically.

Callers should give the name of the argument and not rely on the
current argument order because more arguments could be passed in the
future. OTEP-2 lists possible additional optional arguments:
- start timestamp
- span ID
- resource

Example of call:
```
    with tracer.start_span('foo', span_id = my_span_id):
        print(Context)
```

OTEP-7: open-telemetry/oteps#26
OTEP-2: https://github.com/open-telemetry/oteps/blob/master/text/0002-remove-spandata.md
alban added a commit to kinvolk/opentelemetry-python that referenced this pull request Aug 28, 2019
OTEP-7 ("Remove support to report out-of-band telemetry from the API")
states that the API does not support specifying the span_id in
create_span() or start_span(). Also, following OTEP-2 ("Remove
SpanData"), we cannot use the SpanData to specify the span_id.

However, the need to specify the span_id remains for some applications.
Following the suggestion from OTEP-7, I am adding this feature in the
SDK only.

This patch adds the named argument span_id in create_span() and
start_span() to optionally specify the id of the span to be created.
When unset, the previous behavior remains and the SDK allocates a
span_id automatically.

Callers should give the name of the argument and not rely on the
current argument order because more arguments could be passed in the
future. OTEP-2 lists possible additional optional arguments:
- start timestamp
- span ID
- resource

Example of call:
```
    with tracer.start_span('foo', span_id=my_span_id):
        print(Context)
```

OTEP-7: open-telemetry/oteps#26
OTEP-2: https://github.com/open-telemetry/oteps/blob/master/text/0002-remove-spandata.md
alban added a commit to kinvolk/opentelemetry-python that referenced this pull request Aug 28, 2019
OTEP-7 ("Remove support to report out-of-band telemetry from the API")
states that the API does not support specifying the span_id in
create_span() or start_span(). Also, following OTEP-2 ("Remove
SpanData"), we cannot use the SpanData to specify the span_id.

However, the need to specify the span_id remains for some applications.
Following the suggestion from OTEP-7, I am adding this feature in the
SDK only.

This patch adds the named argument span_id in create_span() and
start_span() to optionally specify the id of the span to be created.
When unset, the previous behavior remains and the SDK allocates a
span_id automatically.

Callers should give the name of the argument and not rely on the
current argument order because more arguments could be passed in the
future. OTEP-2 lists possible additional optional arguments:
- start timestamp
- span ID
- resource

Example of call:
```
    with tracer.start_span('foo', span_id=my_span_id):
        print(Context)
```

OTEP-7: open-telemetry/oteps#26
OTEP-2: https://github.com/open-telemetry/oteps/blob/master/text/0002-remove-spandata.md
alban added a commit to kinvolk/opentelemetry-python that referenced this pull request Aug 28, 2019
OTEP-7 ("Remove support to report out-of-band telemetry from the API")
states that the API does not support specifying the span_id in
create_span() or start_span(). Also, following OTEP-2 ("Remove
SpanData"), we cannot use the SpanData to specify the span_id.

However, the need to specify the span_id remains for some applications.
Following the suggestion from OTEP-7, I am adding this feature in the
SDK only.

This patch adds the named argument span_id in create_span() and
start_span() to optionally specify the id of the span to be created.
When unset, the previous behavior remains and the SDK allocates a
span_id automatically.

Callers should give the name of the argument and not rely on the
current argument order because more arguments could be passed in the
future. OTEP-2 lists possible additional optional arguments:
- start timestamp
- span ID
- resource

Example of call:
```
    with tracer.start_span('foo', span_id=my_span_id):
        print(Context)
```

OTEP-7: open-telemetry/oteps#26
OTEP-2: https://github.com/open-telemetry/oteps/blob/master/text/0002-remove-spandata.md
alban added a commit to kinvolk/opentelemetry-python that referenced this pull request Aug 28, 2019
OTEP-7 ("Remove support to report out-of-band telemetry from the API")
states that the API does not support specifying the span_id in
create_span() or start_span(). Also, following OTEP-2 ("Remove
SpanData"), we cannot use the SpanData to specify the span_id.

However, the need to specify the span_id remains for some applications.
Following the suggestion from OTEP-7, I am adding this feature in the
SDK only.

This patch adds the named argument span_id in create_span() and
start_span() to optionally specify the id of the span to be created.
When unset, the previous behavior remains and the SDK allocates a
span_id automatically.

Callers should give the name of the argument and not rely on the
current argument order because more arguments could be passed in the
future. OTEP-2 lists possible additional optional arguments:
- start timestamp
- span ID
- resource

Example of call:
```
    with tracer.start_span('foo', span_id=my_span_id):
        print(Context)
```

OTEP-7: open-telemetry/oteps#26
OTEP-2: https://github.com/open-telemetry/oteps/blob/master/text/0002-remove-spandata.md
alban added a commit to kinvolk/opentelemetry-python that referenced this pull request Aug 28, 2019
OTEP-7 ("Remove support to report out-of-band telemetry from the API")
states that the API does not support specifying the span_id in
create_span() or start_span(). Also, following OTEP-2 ("Remove
SpanData"), we cannot use the SpanData to specify the span_id.

However, the need to specify the span_id remains for some applications.
Following the suggestion from OTEP-7, I am adding this feature in the
SDK only.

This patch adds the named argument span_id in create_span() and
start_span() to optionally specify the id of the span to be created.
When unset, the previous behavior remains and the SDK allocates a
span_id automatically.

Callers should give the name of the argument and not rely on the
current argument order because more arguments could be passed in the
future. OTEP-2 lists possible additional optional arguments:
- start timestamp
- span ID
- resource

Example of call:
```
    with tracer.start_span('foo', span_id=my_span_id):
        print(Context)
```

OTEP-7: open-telemetry/oteps#26
OTEP-2: https://github.com/open-telemetry/oteps/blob/master/text/0002-remove-spandata.md
@songy23
Copy link
Member

songy23 commented Sep 3, 2019

Please rebase.

@bogdandrutu
Copy link
Member Author

Any objections for this PR? In order to merge this we need couple more approves.

Copy link
Member

@c24t c24t left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, this simplifies the API and seems like the right move for resources.

@yurishkuro yurishkuro merged commit ecbb70b into open-telemetry:master Sep 12, 2019
carlosalberto pushed a commit to carlosalberto/oteps that referenced this pull request Oct 23, 2024
…n-telemetry#26)

* Propose: Remove support to report out-of-band telemetry from the API

* Clarify what the change means

* Update text/0007-no-out-of-band-reporting.md

Co-Authored-By: Yang Song <songy23@users.noreply.github.com>

* Update text/0007-no-out-of-band-reporting.md

Co-Authored-By: Yang Song <songy23@users.noreply.github.com>
carlosalberto pushed a commit to carlosalberto/oteps that referenced this pull request Oct 23, 2024
…n-telemetry#26)

* Propose: Remove support to report out-of-band telemetry from the API

* Clarify what the change means

* Update text/0007-no-out-of-band-reporting.md

Co-Authored-By: Yang Song <songy23@users.noreply.github.com>

* Update text/0007-no-out-of-band-reporting.md

Co-Authored-By: Yang Song <songy23@users.noreply.github.com>
carlosalberto pushed a commit to carlosalberto/oteps that referenced this pull request Oct 30, 2024
…n-telemetry#26)

* Propose: Remove support to report out-of-band telemetry from the API

* Clarify what the change means

* Update text/0007-no-out-of-band-reporting.md

Co-Authored-By: Yang Song <songy23@users.noreply.github.com>

* Update text/0007-no-out-of-band-reporting.md

Co-Authored-By: Yang Song <songy23@users.noreply.github.com>
carlosalberto pushed a commit to open-telemetry/opentelemetry-specification that referenced this pull request Nov 8, 2024
…n-telemetry/oteps#26)

* Propose: Remove support to report out-of-band telemetry from the API

* Clarify what the change means

* Update text/0007-no-out-of-band-reporting.md

Co-Authored-By: Yang Song <songy23@users.noreply.github.com>

* Update text/0007-no-out-of-band-reporting.md

Co-Authored-By: Yang Song <songy23@users.noreply.github.com>
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

10 participants