Related Documentation
Made by
Kong Inc.
Supported Gateway Topologies
hybrid db-less traditional
Supported Konnect Deployments
hybrid cloud-gateways serverless
Compatible Protocols
grpc grpcs http https
Minimum Version
Kong Gateway - 3.1

3.10.0.0

Release date 2025/03/27

Feature

  • This plugin now supports variable resource attributes.

  • This plugin now supports instana headers in propagation.

3.8.0.0

Release date 2024/09/11

Feature

  • Added support for OpenTelemetry formatted logs.

Bugfix

  • Fixed an issue where migration fails when upgrading from below version 3.3 to 3.7.

  • remove redundant deprecation warnings

  • Improved accuracy of sampling decisions.

3.7.0.0

Release date 2024/05/28

Feature

  • The propagation module has been reworked. The new options allow better control over the configuration of tracing headers propagation.

Bugfix

  • Fixed an OTEL sampling mode Lua panic bug, which happened when the http_response_header_for_traceid option was enabled.

Performance

  • Increased queue max batch size to 200.

3.6.1.8

Release date 2024/10/11

Bugfix

  • Fixed an issue where header_type being nil caused a concatenation error.

3.6.1.3

Release date 2024/04/16

Bugfix

  • Improved robustness of parsing for short trace IDs.

3.6.1.0

Release date 2024/02/26

Bugfix

  • fix otel sampling mode lua panic bug when http_response_header_for_traceid option enable

Performance

  • increase queue max batch size to 200

3.5.0.4

Release date 2024/05/20

Bugfix

  • fix otel sampling mode lua panic bug when http_response_header_for_traceid option enable

Performance

  • increase queue max batch size to 200

3.5.0.0

Release date 2023/11/08

Feature

  • A new value is added to the parameter header_type, which allows Kong to inject datadog headers into the headers of requests forwarding to upstream.

Bugfix

  • fix an issue that resulted in invalid parent IDs in the propagated tracing headers

  • fix an issue that resulted in traces with invalid parent IDs when balancer instrumentation was enabled

3.4.3.13

Release date 2024/11/15

Bugfix

  • Fixed an issue where header_type being nil caused a concatenation error.

3.4.3.5

Release date 2024/03/21

Bugfix

  • fix otel sampling mode lua panic bug when http_response_header_for_traceid option enable

Performance

  • increase queue max batch size to 200

3.4.2.0

Release date 2023/11/10

Bugfix

  • fix an issue that resulted in traces with invalid parent IDs when balancer instrumentation was enabled

3.4.1.0

Release date 2023/09/28

Feature

  • A new value is added to the parameter header_type, which allows Kong to inject datadog headers into the headers of requests forwarding to upstream.

Bugfix

  • fix an issue that resulted in invalid parent IDs in the propagated tracing headers

  • fix an issue that resulted in invalid parent IDs in the propagated tracing headers

3.4.0.0

Release date 2023/08/09

Feature

  • Introduced support for the AWS X-Ray propagation header. The field header_typenow accepts the aws value to handle this specific propagation header.#11075

  • The endpoint parameter is now referenceable, and can be stored as a secret in a vault.#11220

3.3.1.1

Release date 2023/10/12

Bugfix

  • fix an issue that resulted in invalid parent IDs in the propagated tracing headers

3.3.0.0

Release date 2023/05/19

Feature

  • These plugins now convert traceid in HTTP response headers to hex format.#10534

  • Spans are now correctly correlated in downstream Datadog traces.10531

  • Added the header_type field. Previously, the header_type was hardcoded to preserve. Now it can be set to one of the following values: preserve, ignore, b3, b3-single,w3c, jaeger, or ot.#10620

  • Added the new span attribute http.client_ip to capture the client IP when behind a proxy.#10723

  • Added the http_response_header_for_traceid configuration parameter. Setting a string value in this field sets a corresponding header in the response.#10379

Bugfix

  • Fixed an issue where reconfiguring the plugin didn’t take effect.

  • Fixed an issue that caused spans to be propagated incorrectly resulting in the wrong hierarchy being rendered on tracing backends.#10663

3.2.1.0

Release date 2023/02/28

Feature

  • This plugin can now be scoped to individual services, routes, and consumers.#10096

Bugfix

  • Fixed an issue in these plugins’ batch queue processing, where metrics would be published multiple times. This caused a memory leak, where memory usage would grow without limit.#10052 #10044

  • Fixed non-compliances to specification:

    • For http.uri in spans, the field is now the full HTTP URI. #10036
    • http.status_code is now present on spans for requests that have a status code. #10160
    • http.flavor is now a string value, not a double. #10160
  • For http.uri in spans, the field is now the full HTTP URI. #10036

  • http.status_code is now present on spans for requests that have a status code. #10160

  • http.flavor is now a string value, not a double. #10160

  • Fixed an issue with getting the traces of other formats, where the trace ID reported and propagated could be of incorrect length. This caused traces originating from Kong Gateway to incorrectly connect with the target service, causing Kong Gateway and the target service to submit separate traces.#10332

3.1.1.2

Release date 2023/01/24

Bugfix

  • Fixed an issue in these plugins’ batch queue processing, where metrics would be published multiple times. This caused a memory leak, where memory usage would grow without limit.

3.1.0.0

Release date 2022/12/06

Feature

  • Added referenceable attribute to the headers field that could be stored in vaults.#9611

Bugfix

  • Fixed an issue that the default propagation header was not configured to w3c correctly.#9457

  • Replaced the worker-level table cache withBatchQueue to avoid data race.#9504

  • Fixed an issue that the parent_id was not set on the span when propagating w3c traceparent.#9628

Something wrong?

Help us make these docs great!

Kong Developer docs are open source. If you find these useful and want to make them better, contribute today!