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.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

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!