Skip to content

Commit 0c02bd6

Browse files
One sentence perline
...even in lists. + de facto
1 parent f73f7fb commit 0c02bd6

File tree

1 file changed

+11
-4
lines changed

1 file changed

+11
-4
lines changed

modules/howtos/pages/observability-tracing.adoc

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -125,10 +125,17 @@ include::example$Tracing.java[tag=otel-direct,indent=0]
125125
At this point the SDK will automatically be exporting spans, and you should see them in your receiver of choice.
126126

127127
=== OpenTelemetry Troubleshooting
128-
* There are many ways to export spans. The example is exporting OpenTelemetry Protocol (OTLP) spans over GRPC to port 4317, which we believe is the defacto standard for OpenTelemetry. Make sure that your receiver is compatible with this, e.g. has these ports open and is ready to receive OTLP traffic over GRPC. With https://www.jaegertracing.io/docs/1.41/getting-started/[Jaeger in Docker] this is achieved with the options `-e COLLECTOR_OTLP_ENABLED=true` and `-p 4317:4317`.
129-
* The exporter used in this example is `BatchSpanProcessor`, which may not have a chance to export spans if the application exits very quickly (e.g. a test application). `SimpleSpanProcessor` can be used instead, though is not likely suitable for production.
130-
* The example above uses `Sampler.alwaysOn()`, which exports every span. This may need to be reduced to avoid overwhelming the receiver, with e.g. `Sampler.traceIdRatioBased(0.01)` to sample 1% of all traces.
131-
* It can be worth sending traces into https://opentelemetry.io/docs/collector/[OpenTelemetry Collector], and forwarding them on from there to your receiver of choice. Among other capabilities the collector can log traces it receives, making for easier debugging.
128+
129+
* There are many ways to export spans.
130+
The example is exporting OpenTelemetry Protocol (OTLP) spans over GRPC to port 4317, which we believe is the _de facto_ standard for OpenTelemetry.
131+
Make sure that your receiver is compatible with this, e.g. has these ports open and is ready to receive OTLP traffic over GRPC.
132+
With https://www.jaegertracing.io/docs/1.41/getting-started/[Jaeger in Docker] this is achieved with the options `-e COLLECTOR_OTLP_ENABLED=true` and `-p 4317:4317`.
133+
* The exporter used in this example is `BatchSpanProcessor`, which may not have a chance to export spans if the application exits very quickly (e.g. a test application).
134+
`SimpleSpanProcessor` can be used instead, though is not likely suitable for production.
135+
* The example above uses `Sampler.alwaysOn()`, which exports every span.
136+
This may need to be reduced to avoid overwhelming the receiver, with e.g. `Sampler.traceIdRatioBased(0.01)` to sample 1% of all traces.
137+
* It can be worth sending traces into https://opentelemetry.io/docs/collector/[OpenTelemetry Collector], and forwarding them on from there to your receiver of choice.
138+
Among other capabilities the collector can log traces it receives, making for easier debugging.
132139

133140
=== Parent spans
134141

0 commit comments

Comments
 (0)