Related Documentation
Made by
Kong Inc.
Supported Gateway Topologies
hybrid db-less traditional
Supported Konnect Deployments
hybrid
Compatible Protocols
grpc grpcs http https tcp tls tls_passthrough udp ws wss

3.11.0.0

Release date 2025/07/03

Feature

  • added consumer label for ai metrics and added metrics for ai-rag-injector plugin.

Bugfix

  • Fixed an issue where AI latency histogram might miss some calculation.

  • Fixed an issue where the control plane failed to expose the db_entities_total metric.

  • Fixed an issue where the metric data_plane_config_hash might not work correctly for incremental sync.

3.10.0.3

Release date 2025/07/06

Bugfix

  • Fixed an issue where AI latency histogram might miss some calculation.

3.10.0.1

Release date 2025/04/15

Bugfix

  • Fixed an issue where the metric data_plane_config_hash might not work correctly for incremental sync.

3.10.0.0

Release date 2025/03/27

Feature

  • Added gauge to expose connectivity state to the control plane.

  • Added the capability to enable or disable exporting of Proxy-Wasm metrics.

3.9.0.0

Release date 2024/12/12

Feature

  • Bumped KONG_LATENCY_BUCKETS bucket’s maximal capacity to 6000

  • Added support for Proxy-Wasm metrics.

3.8.1.0

Release date 2024/11/04

Feature

  • Bumped KONG_LATENCY_BUCKETS bucket’s maximal capacity to 6000

3.8.0.0

Release date 2024/09/11

Feature

  • AI plugins: retrieved latency data and pushed it to logs and metrics.

Bugfix

  • Fixed an issue where CP/DP compatibility check was missing for the new configuration field ai_metrics.

  • Improved error logging when having inconsistent labels count.

3.7.0.0

Release date 2024/05/28

Feature

  • Added workspace label to Prometheus plugin metrics.

3.6.0.0

Release date 2024/02/12

Bugfix

  • Expose metrics for serviceless routes

3.4.0.0

Release date 2023/08/09

Feature

3.1.0.0

Release date 2022/12/06

Bugfix

  • Added the missing protocols field to the following plugin schemas: Prometheus (prometheus)

3.0.0.0

Release date 2022/09/09

Feature

  • nginx_http_current_connections and nginx_stream_current_connections were merged into to nginx_hconnections_total (or nginx_current_connections?)

  • request_count and consumer_status were merged into http_requests_total.

    If the per_consumer config is set to false, the consumer label will be empty. If the per_consumer config is true, the consumer label will be filled.

  • Updated the Grafana dashboard that comes packaged with Kong

Breaking Change

  • High cardinality metrics are now disabled by default.

  • Decreased performance penalty to proxy traffic when collecting metrics.

  • http_status to http_requests_total.

  • latency to kong_request_latency_ms (HTTP), kong_upstream_latency_ms, kong_kong_latency_ms, and session_duration_ms (stream).

    Kong latency and upstream latency can operate at orders of different magnitudes. Separate these buckets to reduce memory overhead.

  • kong_bandwidth to kong_bandwidth_bytes.

  • Removed the following metric: http_consumer_status

  • New metrics:

    • session_duration_ms: monitoring stream connections.
    • node_info: Single gauge set to 1 that outputs the node’s ID and Kong Gateway version.
  • session_duration_ms: monitoring stream connections.

  • node_info: Single gauge set to 1 that outputs the node’s ID and Kong Gateway version.

  • http_requests_total has a new label, source. It can be set to exit, error, or service.

  • All memory metrics have a new label: node_id.

  • The following metric names were adjusted to add units to standardize where possible:

    • http_status to http_requests_total.
    • latency to kong_request_latency_ms (HTTP), kong_upstream_latency_ms, kong_kong_latency_ms, and session_duration_ms (stream).

    Kong latency and upstream latency can operate at orders of different magnitudes. Separate these buckets to reduce memory overhead.

    • kong_bandwidth to kong_bandwidth_bytes.
    • nginx_http_current_connections and nginx_stream_current_connections were merged into to nginx_connections_total.
    • request_count and consumer_status were merged into http_requests_total.

    If the per_consumer config is set to false, the consumer label will be empty. If the per_consumer config is true, the consumer label will be filled.

  • nginx_http_current_connections and nginx_stream_current_connections were merged into to nginx_connections_total.

  • request_count and consumer_status were merged into http_requests_total.

    If the per_consumer config is set to false, the consumer label will be empty. If the per_consumer config is true, the consumer label will be filled.

  • Updated the Grafana dashboard that comes packaged with Kong#8712

  • The plugin doesn’t export status codes, latencies, bandwidth and upstream health check metrics by default. They can still be turned on manually by setting status_code_metrics,lantency_metrics, bandwidth_metrics and upstream_health_metrics respectively.#9028

2.8.4.5

Release date 2023/11/28

Performance

  • reduce upstream health iteration latency spike during scrape

2.8.4.0

Release date 2023/03/28

Bugfix

  • Added the missing protocols field to the following plugin schemas: Prometheus (prometheus)

2.8.2.3

Release date 2023/01/06

Bugfix

2.8.0.0

Release date 2022/03/02

Feature

  • Added three new metrics:

    • kong_db_entities_total (gauge): total number of entities in the database.
    • kong_db_entity_count_errors (counter): measures the number of errors encountered during the measurement of kong_db_entities_total.
    • kong_nginx_timers (gauge): total number of Nginx timers, in Running or Pending state. Tracks ngx.timer.running_count() andngx.timer.pending_count().#8387
  • kong_db_entities_total (gauge): total number of entities in the database.

  • kong_db_entity_count_errors (counter): measures the number of errors encountered during the measurement of kong_db_entities_total.

  • kong_nginx_timers (gauge): total number of Nginx timers, in Running or Pending state. Tracks ngx.timer.running_count() andngx.timer.pending_count().#8387

Did this doc help?

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!