Skip to content

Commit

Permalink
move 'make given span active' operation to a MUST
Browse files Browse the repository at this point in the history
  • Loading branch information
tsloughter committed Mar 10, 2020
1 parent 604c58f commit 5b96bda
Showing 1 changed file with 3 additions and 4 deletions.
7 changes: 3 additions & 4 deletions specification/api-tracing.md
Original file line number Diff line number Diff line change
Expand Up @@ -120,19 +120,18 @@ mechanism, for instance the `ServiceLoader` class in Java.

### Tracer operations

The currently active `Span` for a `Tracer` is the one that is tracked in the current
`Context` by the `Tracer`. An inactive `Span` is not currently tracked in any
`Context`.
The currently active `Span` is the one that is tracked in the current `Context`
by the `Tracer`. An inactive `Span` is not currently tracked in any `Context`.

The `Tracer` MUST provide functions to:

- Start a new active `Span`
- Start a new inactive `Span`
- Make a given `Span` active

The `Tracer` SHOULD provide methods to:

- Get the currently active `Span`
- Make a given `Span` active

The `Tracer` MUST internally leverage the `Context` in order to get and set the
currently active `Span` and how `Span`s are passed across process boundaries. A
Expand Down

0 comments on commit 5b96bda

Please sign in to comment.