Prometheus Changelog - Plugin

Changelog

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

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

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.

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

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