Introducing Active Tracing (Tech Preview)
We're thrilled to announce the tech preview of Active Tracing, a significant advancement in Kong Konnect. This innovative feature unlocks unparalleled visibility into API traffic as it flows through Kong Gateway, empowering you to optimize performance, troubleshoot issues, and refine your API strategies.
The need for targeted insights
Intermittent service issues can be elusive and challenging to understand. To ensure optimal performance and reliability, it’s essential to have a clear view into your service’s behavior. This is where observability comes in — providing the ability to understand and contextualize system behavior even in the absence of known issues.
When critical services malfunction, pinpointing the root cause can be daunting. Is it a DNS issue, an upstream service anomaly, undetected failures, or a gateway problem? For platform operation teams, accessing component-level data is crucial for rapid mean time to resolution (MTTR).
However, generating and storing detailed telemetry data continuously may be detrimental to the performance of the service and unnecessary. This is where targeted, on-demand insights become invaluable — enabling teams to swiftly identify and resolve issues, minimizing service disruptions.
Introducing Active Tracing
With Active Tracing, infrastructure administrators can initiate targeted “deep tracing” sessions in specific API gateway nodes. During an Active Tracing session, the selected gateway generates detailed, OpenTelemetry-compatible traces for all requests matching the sampling criteria. The detailed spans are captured for the entire request/response lifecycle. These traces can be visualized with Konnect’s built-in span viewer with no additional instrumentation or telemetry tools. Konnect’s Active Tracing capability offers exclusive, in-depth insights that can't be replicated by third-party telemetry tools.
By capturing detailed, component-level telemetry data, platform operations teams can gain a deeper understanding of their services’ performance, dependencies, and potential bottlenecks. This targeted approach to observability enables teams to optimize their services, reduce uncertainty, and improve overall system reliability.
Key highlights
- Traces can be generated for a service (includes all routes) or per route
- Traces can be generated for all requests or those matching a sampling criteria
- Sampling criteria can be defined with simple expressions language (ex: http.method == “GET”)
- Trace spans and attributes adhere to open telemetry conventions
- Traces can be visualized in Konnect’s built-in trace viewer
- Trace sessions are retained in Konnect for up to 7 days
Traces captured in an Active Tracing session can be visualized in Konnect's built-in trace viewer. The trace viewer displays a summary view and a trace view. You can gain instant insights with the summary view while the trace view will help you dive deeper.
Gain instance insights with summary view
Summary view helps you visualize the entire API request-response flow in a single glance. This view provides a concise overview of critical metrics and a transaction map. The transaction map includes the plugins executed by Kong on both the request and the response along with the times spent in each phase. Use summary view to quickly understand the end-to-end API flow, identify performance bottlenecks, and optimize your API strategy.

Dive deeper with trace view
The trace view gives you unparalleled visibility into Kong's internal workings. This detailed view breaks down into individual spans providing a comprehensive understanding of:
- Kong's internal processes and phases
- Plugin execution and performance
- Request and response handling
Use trace view to troubleshoot issues, optimize performance, and refine your configuration.

Try Active Tracing
We're excited to hear your thoughts on Active Tracing! Get started with Active Tracing today and discover new insights into your API traffic.
If you're a Konnect customer, tech preview is already enabled for your org. Login to Konnect, navigate to the gateway manager, select a control plane, and start tracing. If you're new to Kong, you can start by signing up for Kong Konnect for free!
Be sure to share your feedback with us. Your input will help shape the future of this powerful feature.
Unleash the power of APIs with Kong Konnect
