Prometheus

Kong Gateway 3.10.x

• Added gauge to expose connectivity state to the Control Plane.
• Added the capability to enable or disable exporting of Proxy-Wasm metrics.

Kong Gateway 3.9.x

• Increased the upper limit of KONG_LATENCY_BUCKETS to 6000 to enhance latency tracking precision. #13588
• Added support for Proxy-Wasm metrics. #13681

Kong Gateway 3.8.x

• Added ai_requests_total, ai_cost_total, and ai_tokens_total metrics to the Prometheus plugin to start counting AI usage. #13148
• Improved error logging when having an inconsistent label count. #13020
• Fixed an issue where the CP/DP compatibility check was missing for the new configuration field ai_metrics. #13417

Kong Gateway 3.7.x

• Added a workspace label to Prometheus plugin metrics. #12836

Kong Gateway 3.6.x

• Exposed metrics for Service-less Routes. #11781

Kong Gateway 3.4.x

• This plugin has been optimized to reduce proxy latency impacts during scraping. #10949 #11040 #11065

Kong Gateway 3.0.x

• High cardinality metrics are now disabled by default.
• Decreased performance penalty to proxy traffic when collecting metrics.
• 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/kong_upstream_latency_ms/kong_kong_latency_ms
  • kong_bandwidh to kong_bandwidth_bytes
  • nginx_http_current_connections/nginx_stream_current_connections to nginx_connections_total
  • Removed: http_consumer_status
• New metric: session_duration_ms for monitoring stream connections
• New metric: node_info is a single gauge set to 1 that outputs the node’s ID and Kong Gateway version
• Latency was split into four different metrics: kong_latency_ms, upstream_latency_ms, request_latency_ms (HTTP), and session_duration_ms (stream). Buckets details follow:
  • Kong Latency and Upstream Latency can operate at orders of different magnitudes. Separate these buckets to reduce memory overhead.
• 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.
• 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.
• Plugin version bumped to 3.0.0
• The node_id label was added to memory metrics.

Kong Gateway 2.8.x

• Adds a new metric:
  • kong_nginx_timers (gauge): Total number of Nginx timers, in Running or Pending state.
• Add two 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 Gateway 2.8.3.2

• Adds new directives in kong.conf to enable or disable high cardinality metrics.
  • prometheus_plugin_status_code_metrics: Enables or disables reporting the HTTP/Stream status codes per Service/Route.
  • prometheus_plugin_latency_metrics: Enables or disables reporting the latency added by Kong Gateway, request time and upstream latency.
  • prometheus_plugin_bandwidth_metrics: Enables or disables reporting the bandwidth consumed by Service/Route.
  • prometheus_plugin_upstream_health_metrics: Enables or disables reporting the upstream health status.

    Kong Gateway 2.5.x

• New data_plane_cluster_cert_expiry_timestamp metric
• Added subsystem label to Upstream Target health metrics

Kong Gateway 2.4.x

• Added the per_consumer configuration parameter to export per-Consumer status.

Kong Gateway 2.3.x

• The plugin can now export Kong Gateway Enterprise licensing information.