update documentation for jaeger -> otlp

README.md

@@ -32,7 +32,7 @@ Trickster is a fully-featured HTTP Reverse Proxy Cache for HTTP applications lik
 * [Negative Caching](./docs/negative-caching.md) to prevent domino effect outages
 * High-performance [Collapsed Forwarding](./docs/collapsed-forwarding.md)
 * Best-in-class [Byte Range Request caching and acceleration](./docs/range_request.md).
-* [Distributed Tracing](./docs/tracing.md) via OpenTelemetry, supporting Jaeger and Zipkin
+* [Distributed Tracing](./docs/tracing.md) via OpenTelemetry, supporting OTLP and Zipkin
 * Rules engine for custom request routing and rewriting
 
 ## Time Series Database Accelerator

deploy/kube/configmap.yaml

@@ -505,24 +505,31 @@ data:
     #   default:
 
     #     # provider specifies the type of backend tracing system where traces are sent (in that format)
-    #     # options are: jaeger, zipkin, stdout or none.  none is the default
+    #     # options are: otlp, zipkin, stdout or none.  none is the default
     #     provider: none
 
     #     # service_name specifies the service name under which the traces are registered by this tracer
     #     # default is trickster
     #     service_name: trickster
 
-    #     # collector_url is the URL of the tracing backend
-    #     # required for zipkin and jaeger, unused for stdout
-    #     collector_url: http://jaeger:14268/api/traces
+    #     # endpoint is the URL, URI or Path to the tracing backend
+    #     # required for Zipkin and OTLP, unused for stdout
+    #     endpoint: http://jaeger:14268/api/traces
 
-    #     # collector_user is the username credential for authenticating with the tracing backend
-    #     # optional jaeger; unused for zipkin and stdout
-    #     collector_user: ''
+    #     # timeout_ms is the amount of time in milliseconds for the tracing post
+    #     # to wait for a response before timing out
+    #     # default is no timeout set
+    #     timeout_ms: 5000
 
-    #     # collector_pass is the username credential for authenticating with the tracing backend
-    #     # optional jaeger; unused for zipkin and stdout
-    #     collector_pass: ''
+    #     # headers is a list of http headers to include in the tracing post
+    #     # default is none
+    #     headers:
+    #       "Header-Name-1": "header value 1"
+    #       "Header-Name-2": "header value 2"
+
+    #     # disable_compression should be set to true if tracing posts should not be compressed
+    #     # default is false
+    #     disable_compression: false
 
     #     # sample_rate sets the probability that a span will be recorded.
     #     # A floating point value of 0.0 to 1.0 (inclusive) is permitted
@@ -556,15 +563,15 @@ data:
     #     # another example tracing config named example using jaeger agent backend and a 50% sample rate
     #   example:
     #     provider: jaeger
-    #     collector_url: jaeger:6831
+    #     endpoint: jaeger:6831
     #     sample_rate: 0.5
     #     jaeger:
     #       endpoint_type: agent
 
     #     # another example tracing config named zipkin-example using zipkin backend and a 10% sample rate
     #   zipkin-example:
     #     provider: zipkin
-    #     collector_url: https://zipkin.example.com:9411/api/v2/spans
+    #     endpoint: https://zipkin.example.com:9411/api/v2/spans
     #     sample_rate: 0.1
 
 

docs/chunked_caching.md

@@ -103,18 +103,16 @@ rules:
 
 tracing:
   jc1:
-    tracer_type: jaeger
-    collector_url: 'http://127.0.0.1:14268/api/traces'
+    tracer_type: otlp
+    endpoint: 'http://127.0.0.1:14268/api/traces'
     tags:
       testTag: testTagValue
       testTag2: testTag2Value
   ja1:
-    tracer_type: jaeger
-    collector_url: '127.0.0.1:6831'
+    tracer_type: otlp
+    endpoint: '127.0.0.1:6831'
     omit_tags:
       - http.url
-    jaeger:
-      endpoint_type: agent
 
 backends:
   prom1:

docs/tracing.md

@@ -1,13 +1,12 @@
 # Distributed Tracing via OpenTelemetry
 
-Trickster instruments Distributed Tracing with [OpenTelemetry](http://opentelemetry.io/), which is a currently emergent, comprehensive observability stack that is in Public Beta. We import the [OpenTelemetry golang packages](https://github.com/open-telemetry/opentelemetry-go) to instrument support for tracing.
+Trickster instruments Distributed Tracing with [OpenTelemetry](http://opentelemetry.io/). We import the [OpenTelemetry golang packages](https://github.com/open-telemetry/opentelemetry-go) to instrument support for tracing.
 
 As OpenTelemetry evolves to support additional exporter formats, we will work to extend Trickster to support those as quickly as possible. We also make a best effort to update our otel package imports to the latest releases, whenever we publish a new Trickster release. You can check the [go.mod](../go.mod) file to see which release of opentelemetry-go we are is using. In this view, to see which version of otel a specific Trickster release imports, use the branch selector dropdown to switch to the tag corresponding to that version of Trickster.
 
 ## Supported Tracing Backends
 
-- Jaeger
-- Jaeger Agent
+- Jaeger (via OTLP)
 - Zipkin
 - Console/Stdout (printed locally by the Trickster process)
 

examples/conf/example.full.yaml

@@ -601,24 +601,31 @@ backends:
 #   default:
 
 #     # provider specifies the type of backend tracing system where traces are sent (in that format)
-#     # options are: jaeger, zipkin, stdout or none.  none is the default
+#     # options are: otlp, zipkin, stdout or none.  none is the default
 #     provider: none
 
 #     # service_name specifies the service name under which the traces are registered by this tracer
 #     # default is trickster
 #     service_name: trickster
 
-#     # collector_url is the URL of the tracing backend
-#     # required for zipkin and jaeger, unused for stdout
-#     collector_url: http://jaeger:14268/api/traces
+#     # endpoint is the URL, URI or Path to the tracing backend
+#     # required for Zipkin and OTLP, unused for stdout
+#     endpoint: http://jaeger:14268/api/traces
 
-#     # collector_user is the username credential for authenticating with the tracing backend
-#     # optional jaeger; unused for zipkin and stdout
-#     collector_user: ''
+#     # timeout_ms is the amount of time in milliseconds for the tracing post
+#     # to wait for a response before timing out
+#     # default is no timeout set
+#     timeout_ms: 5000
 
-#     # collector_pass is the username credential for authenticating with the tracing backend
-#     # optional jaeger; unused for zipkin and stdout
-#     collector_pass: ''
+#     # headers is a list of http headers to include in the tracing post
+#     # default is none
+#     headers:
+#       "Header-Name-1": "header value 1"
+#       "Header-Name-2": "header value 2"
+
+#     # disable_compression should be set to true if tracing posts should not be compressed
+#     # default is false
+#     disable_compression: false
 
 #     # sample_rate sets the probability that a span will be recorded.
 #     # A floating point value of 0.0 to 1.0 (inclusive) is permitted
@@ -637,30 +644,22 @@ backends:
 #       key1: "value1"
 #       key2: "value2"
 
-#       # configurations for this tracer, specific to jaeger
-#     jaeger:
-#       # endpoint_type indicates whether the jaeger tracing backend is a collector or agent
-#       # default is collector
-#       endpoint_type: collector
-
 #       # configurations for this tracer, specific to stdout
 #     stdout:
 #       # pretty_print indicates whether the output to stdout is formatted better human readability
 #       # default is false
 #       pretty_print: false
 
-#     # another example tracing config named example using jaeger agent backend and a 50% sample rate
+#     # another example tracing config named example using otlp agent backend and a 50% sample rate
 #   example:
-#     provider: jaeger
-#     collector_url: jaeger:6831
+#     provider: otlp
+#     endpoint: jaeger:6831
 #     sample_rate: 0.5
-#     jaeger:
-#       endpoint_type: agent
 
 #     # another example tracing config named zipkin-example using zipkin backend and a 10% sample rate
 #   zipkin-example:
 #     provider: zipkin
-#     collector_url: https://zipkin.example.com:9411/api/v2/spans
+#     endpoint: https://zipkin.example.com:9411/api/v2/spans
 #     sample_rate: 0.1
 
 

examples/docker-compose/docker-compose-data/trickster-config/trickster.yaml

@@ -32,15 +32,13 @@ tracing:
       pretty_print: true
   zip1:
     provider: zipkin
-    collector_url: 'http://zipkin:9411/api/v2/spans'
+    endpoint: 'http://zipkin:9411/api/v2/spans'
   jc1:
-    provider: jaeger # jaeger collector
-    collector_url: 'http://jaeger:14268/api/traces'
+    provider: otlp # jaeger collector
+    endpoint: 'http://jaeger:14268/api/traces'
   ja1:
-    provider: jaeger # jaeger agent
-    collector_url: 'jaeger:6831'
-    jaeger:
-      endpoint_type: agent
+    provider: otlp # jaeger agent
+    endpoint: 'jaeger:6831'
 backends:
   prom1: # prometheus cached with a memory cache, traces sent to stdout
     provider: prometheus