Skip to content

Commit

Permalink
Add data format section and a description of timestamps (#111)
Browse files Browse the repository at this point in the history
* Add section on data formats. Fixes #85
- Added explanation of representation of times and durations

* Removed wording on tuples

* Removed examples
  • Loading branch information
danielkhan authored and SergeyKanzhelev committed Jun 13, 2019
1 parent 4ac49aa commit 48d0771
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 48d0771

Please sign in to comment.