otel

Overview ¶

Package otel provides OpenTelemetry tracing and metrics for HTTP client requests.

The package provides 3 types of telemetry: 1. otelhttptrace low-level telemetry:

• It provides spans for HTTP request parts, for example: "http.dns", "http.tls", "http.getconn".
• Span names start with "http".
• Metrics are not provided.

2. Low-level telemetry

• It provides span and metrics for every sent HTTP request, including redirects and retries.
• Span name is "http.request".
• Metrics names start with "keboola.go.http." (httpMeterPrefix const).
• For full list of metrics see the httpMeters struct.
• The package otelhttp (its client part) is not used, because it doesn't provide metrics.

3. High-level telemetry implemented in this package.

• It provides span and metrics for each "logical" HTTP request send by the client.
• Main span "keboola.go.http.client.request" wraps all redirects and retries together.
• Span "keboola.go.http.client.request.body.parse" tracks response receiving and parsing (as a stream).
• Span "keboola.go.http.client.retry.delay" tracks delay before retry.
• Metrics names start with "keboola.go.http.client" (clientMeterPrefix const).
• For full list of metrics see the clientMeters and parseMeters structs.