Kong - Prometheus extension

  • Latest Dynatrace
  • Extension
  • Published Oct 27, 2025

Monitor Kong Prometheus export metrics.

Monitor Kong Prometheus export metrics such as routes, nodes, locally or remotely stored data, or proxied upstream services with the Kong - Prometheus Kong - Prometheus extension.

Get started

Find the extension in Dynatrace Hub to start the installation.

For more information on the related Prometheus extension, see Dynatrace Prometheus Extension Documentation.

Use cases

Requirements

  • Kong Prometheus Plugin
  • Kong Gateway 2.8.x +
  • Konnect
  • Kong Gateway Enterprise

Details

The Kong - Prometheus Kong - Prometheus extension uses the Kong Prometheus Export to scrape and ingest metrics. It enables the Prometheus extension in your Kong environment. It points the Dynatrace monitoring configuration to the metrics endpoint, for example, http://localhost:<port>/metrics.

In this context, Dynatrace is the Prometheus server.

Dynatrace creates the following custom topology types from the Prometheus metric dimensions:

  • kong.node
  • Kong shared dictionary
  • Kong service

A SAME_AS relationship is defined between the Kong service and a monitored Dynatrace service, where the service names are the same.

Feature sets

When activating your extension using monitoring configuration, you can limit monitoring to one of the feature sets. To work properly the extension has to collect at least one metric after the activation.

In highly segmented networks, feature sets can reflect the segments of your environment. Then, when you create a monitoring configuration, you can select a feature set and a corresponding ActiveGate group that can connect to this particular segment.

All metrics that aren't categorized into any feature set are considered to be the default and are always reported.

A metric inherits the feature set of a subgroup, which in turn inherits the feature set of a group. Also, the feature set defined on the metric level overrides the feature set defined on the subgroup level, which in turn overrides the feature set defined on the group level.

luaVm
Metric nameMetric keyDescription
Kong Memory Workers Lua Vms Byteskong_memory_workers_lua_vms_bytesAllocated bytes in worker Lua VM
request-latency
Metric nameMetric keyDescription
Kong Request Latency (Histogram)kong_request_latency_msTotal latency incurred during requests for each service/route in Kong
http-requests
Metric nameMetric keyDescription
Kong HTTP Requests Totalkong_http_requests_total.countHTTP status codes per consumer/service/route in Kong
license
Metric nameMetric keyDescription
Kong Enterprise License Errorskong_enterprise_license_errors.countErrors when collecting license info
Kong Enterprise License Errorskong_enterprise_license_expirationErrors when collecting license info
Kong Enterprise License Featureskong_enterprise_license_featuresLicense features
dataplane
Metric nameMetric keyDescription
Kong Data Plane Last Seenkong_data_plane_last_seenLast time data plane contacted control plane
Kong Data Plane Version Compatiblekong_data_plane_version_compatibleVersion compatible status of the data plane, 0 is incompatible
datastore
Metric nameMetric keyDescription
Kong Datastore Reachablekong_datastore_reachableDatastore reachable from Kong, 0 is unreachable
Kong Database Entities Totalkong_db_entities_totalTotal number of Kong db entities
Kong Database Errorskong_db_entity_count_errors.countErrors during entity count collection
bandwidth
Metric nameMetric keyDescription
Kong Total Bandwidthkong_bandwidth_bytesTotal bandwidth (ingress/egress) throughput in bytes
node
Metric nameMetric keyDescription
Kong Node Infokong_node_infoKong Node metadata information
nginx
Metric nameMetric keyDescription
Kong Nginx Connections Totalkong_nginx_connections_totalNumber of connections by subsystem
Kong Nginx Metric Errors Totalkong_nginx_metric_errors_total.countNumber of nginx-lua-prometheus errors
Kong Nginx Requests Totalkong_nginx_requests_totalTotal number of requests
Kong Nginx Timerskong_nginx_timersNumber of nginx timers
Kong Nginx HTTP Current Connectionskong_nginx_http_current_connectionsNumber of HTTP connections
sharedDict
Metric nameMetric keyDescription
Kong Memory Lua Shared Dict Byteskong_memory_lua_shared_dict_bytesAllocated slabs in bytes in a shared_dict
Kong Memory Lua Shared Dict Total Byteskong_memory_lua_shared_dict_total_bytesTotal capacity in bytes of a shared_dict
upstream-latency
Metric nameMetric keyDescription
Kong Upstream Latency (Histogram)kong_upstream_latency_msLatency added by upstream response for each service/route in Kong
kong-latency
Metric nameMetric keyDescription
Kong Latency (Histogram)kong_kong_latency_msLatency added by Kong and enabled plugins for each service/route in Kong
Related tags
ApplicationPrometheusAPI managerKongApplication Observability