Skip to content
This repository was archived by the owner on Feb 6, 2026. It is now read-only.

docs: Documentation update for OpenTelemetry and tracing #1657

Merged
cindy-peng merged 5 commits into from
Jul 16, 2024
Merged

docs: Documentation update for OpenTelemetry and tracing #1657

Changes from 2 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
8848619
docs: Documentation update for OpenTelemetry and tracing
cindy-peng Jul 12, 2024
9f5b546
update wording
cindy-peng Jul 12, 2024
0e4914f
Fix comments
cindy-peng Jul 12, 2024
ff6f185
🦉 Updates from Hermetic Build image
diegomarquezp Jul 12, 2024
59b95fc
fix comments
cindy-peng Jul 12, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions .readme-partials.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -227,4 +227,20 @@ custom_content: |
<artifactId>google-cloud-logging-servlet-initializer</artifactId>
</dependency>
```
#### Population of log entrys' trace/span Id
Cloud Logging libraries use [trace fields within LogEntry](https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry#FIELDS.trace) to capture trace contexts, which enables the [correlation of logs and traces](https://cloud.google.com/logging/docs/view/correlate-logs), and distributed tracing troubleshooting.
These tracing fields including [trace](https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry#FIELDS.trace), [spanId](https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry#FIELDS.span_id), and [traceSampled](https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry#FIELDS.trace_sampled) define the trace context for a `LogEntry`.
Comment thread
cindy-peng marked this conversation as resolved.
Outdated

The library provides three methods to update trace/span Id:
* Manually set trace/span Id
The trace and span Ids can be set directly using `setTraceId()` and `setSpanId()` methods provided by `Context.Builder`. Alternatively it can also be parsed from the [W3C tracing context header](https://www.w3.org/TR/trace-context) using `loadW3CTraceParentContext()` or from the [Google Cloud tracing context header](https://cloud.google.com/trace/docs/trace-context#legacy-http-header) using `loadCloudTraceContext()`.
Comment thread
cindy-peng marked this conversation as resolved.
Outdated
Tracing information set using this method will take precedence over other methods below.
Comment thread
cindy-peng marked this conversation as resolved.
Outdated

* Auto-populate trace/span Id from OpenTelemetry context
If you are using OpenTelemetry and there is an active span in the OpenTelemetry Context, that log entry will automatically have the `trace`, `span_id`, and `trace_sampled` fields populated from that span. More information about OpenTelemetry can be found [here](https://opentelemetry.io/docs/languages/java/).
Comment thread
cindy-peng marked this conversation as resolved.
Outdated

* Use [servlet initializer](https://github.com/googleapis/java-logging-servlet-initializer) to populate trace/span Id from HTTP headers
If trace/span Id is not manually set or auto-populated from OpenTelemetry context, you can use [servlet initializer](https://github.com/googleapis/java-logging-servlet-initializer) package to populate trace/span Id from HTTP headers.
Comment thread
cindy-peng marked this conversation as resolved.
Outdated
This package filters all servlet requests to automatically capture the execution context of the servlet request and store it using ContextHandler class. Http request and trace/span Id information will be populated from the stored Context class instances.
Comment thread
cindy-peng marked this conversation as resolved.
Outdated
Using this method, trace/span Id can be automatically populated from either the [W3C Traceparent](https://www.w3.org/TR/trace-context) or [X-Cloud-Trace-Context](https://cloud.google.com/trace/docs/trace-context#legacy-http-header) headers.