When you set up a tracing session with Konnect Debugger, it collects and reports spans that detail Konnect events. The following sections describe the spans that are available in the Konnect Debugger.
kong
The root span.
This span has the following attributes:
|
Name |
Description |
|---|---|
url.full
|
Full url, without query parameters |
client.address
|
Remote address of the client making the request. This considers forwarded addresses in cases when a load balancer is in front of Kong. Note: this requires configuring the real_ip_header and trusted_ips global configuration options. |
client.port
|
Remote port of the client making the request. This considers forwarded ports in cases when a load balancer is in front of Kong. Note: this requires configuring the real_ip_header and trusted_ips global configuration options. |
network.peer.address
|
IP of the component that is connecting to Kong |
network.peer.port
|
Port of the component that is connecting to Kong |
server.address
|
Kong’s DNS name or IP used in client connection |
server.port
|
Kong’s public port |
network.protocol.name
|
HTTP, gRPC, WS, Kafka, etc. |
http.request.method
|
HTTP request method |
http.request.body.size
|
Request content length or equivalent in bytes |
proxy.kong.request.id
|
Unique id for each request |
proxy.kong.request.time
|
Request time as measured by Nginx ($request_time) |
http.request.size
|
Request body size and request headers size in bytes |
http.response.body.size
|
Response content length or equivalent in bytes |
http.response.size
|
Response body size and response headers size in bytes |
kong.request.id
|
Unique ID for each request |
url.scheme
|
Protocol identifier |
network.protocol.version
|
Version of the HTTP protocol used in establishing connection [1.2, 2.0] |
tls.client.server_name
|
SNI |
http.request.header.host
|
Host header if present. This can be different from the SNI. |
proxy.kong.consumer_id
|
Authenticated Consumer ID if present |
proxy.kong.upstream_id
|
Resolved Upstream ID |
proxy.kong.upstream_status_code
|
status code returned by Upstream |
http.response.status_code
|
Status code sent back by Kong |
proxy.kong.latency.upstream
|
Time between the connection to the upstream and the last byte of response |
proxy.kong.latency.total
|
Time between the first byte into Kong and the last byte out of Kong |
proxy.kong.latency.internal
|
Time taken by Kong to process the request. Excludes client and upstream read/write times, and i/o times. |
proxy.kong.latency.net_io_timings
|
Array containing ip, connect_time, and rw_time. I/o outside of the request context is not considered.
|
proxy.kong.client_KA
|
Whether the downstream used a KeepAlive connection. |
tls.resumed
|
Whether the TLS session resumed. |
tls.client.subject
|
x509 client DN (if mTLS). |
tls.server.subject
|
x509 DN for cert Kong presented. |
tls.cipher
|
Negotiated cipher. |
kong.phase.certificate
A span capturing the execution of the certificate phase of request processing. Any plugins configured for running in this phase will show up as individual child spans.
kong.certificate.plugin.plugin_name
A span capturing the execution of a plugin configured to run in the certificate phase. Multiple such spans can occur in a trace.
This span has the following attributes:
|
Name |
Description |
|---|---|
proxy.kong.plugin.instance_id
|
Instance ID of the plugin configuration that ran |