Skip to content

Commit

Permalink
doc: add some links to the diagnostics page
Browse files Browse the repository at this point in the history
Updates golang#22027.

Change-Id: I468348d2b000f146f88ef8b7cf450eea8d1c12a7
Reviewed-on: https://go-review.googlesource.com/83917
Reviewed-by: Andrew Bonventre <andybons@golang.org>
  • Loading branch information
rakyll committed Dec 14, 2017
1 parent c6ea277 commit 774ae54
Showing 1 changed file with 4 additions and 2 deletions.
6 changes: 4 additions & 2 deletions doc/diagnostics.html
Original file line number Diff line number Diff line change
Expand Up @@ -254,7 +254,8 @@ <h2 id="tracing">Tracing</h2>
<p><strong>How should I propagate trace headers in Go libraries?</strong></p>

<p>
You can propagate trace identifiers and tags in the <code>context.Context</code>.
You can propagate trace identifiers and tags in the
<a href="/pkg/context#Context"><code>context.Context</code></a>.
There is no canonical trace key or common representation of trace headers
in the industry yet. Each tracing provider is responsible for providing propagation
utilities in their Go libraries.
Expand All @@ -267,7 +268,8 @@ <h2 id="tracing">Tracing</h2>

<p>
The standard library and runtime are trying to expose several additional APIs
to notify on low level internal events. For example, httptrace.ClientTrace
to notify on low level internal events. For example,
<a href="/pkg/net/http/httptrace#ClientTrace"><code>httptrace.ClientTrace</code></a>
provides APIs to follow low-level events in the life cycle of an outgoing request.
There is an ongoing effort to retrieve low-level runtime events from
the runtime execution tracer and allow users to define and record their user events.
Expand Down

0 comments on commit 774ae54

Please sign in to comment.