Skip to content

Commit

Permalink
Add data format section and a description of timestamps (open-telemet…
Browse files Browse the repository at this point in the history
…ry#111)

* Add section on data formats. Fixes open-telemetry#85
- Added explanation of representation of times and durations

* Removed wording on tuples

* Removed examples
  • Loading branch information
danielkhan authored and Sergey Kanzhelev committed Feb 18, 2020
1 parent ef79f11 commit ba007cd
Showing 1 changed file with 18 additions and 0 deletions.
18 changes: 18 additions & 0 deletions specification/tracing-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,24 @@ Tracing API consist of a few main classes:
- `SpanData` is an immutable object that is used to report out-of-band completed
spans. See [SpanData](#spandata) section.

## Data types
While languages and platforms have different ways of representing data,
this section defines some generic requirements for this API.

### Time
OpenTelemetry can operate on time values up to nanosecond (ns) precision.
The representation of those values is language specific.

#### Timestamp
A timestamp is the time elapsed since the Unix epoch.
* The minimal precision is milliseconds.
* The maximal precision is nanoseconds.

#### Duration
A duration is the elapsed time between two events.
* The minimal precision is milliseconds.
* The maximal precision is nanoseconds.

## Tracer

### Obtaining a tracer
Expand Down

0 comments on commit ba007cd

Please sign in to comment.