StatsD

このページは、まだ日本語ではご利用いただけません。翻訳中です。

古いプラグインバージョンのドキュメントを閲覧しています。

Looking for the plugin's configuration parameters? You can find them in the StatsD configuration reference doc.

Log metrics for a service or route to a StatsD server. It can also be used to log metrics on Collectd daemon by enabling its StatsD plugin.

By default, the plugin sends a packet for each metric it observes. The udp_packet_size option configures the greatest datagram size the plugin can combine. It should be less than 65507 according to UDP protocol. Consider the MTU of the network when setting this parameter.

---

Metrics

Metric	Description	Namespace syntax
request_count	The number of requests.	kong.service.<service_identifier>.request.count
request_size	The request’s body size in bytes.	kong.service.<service_identifier>.request.size
response_size	The response’s body size in bytes.	kong.service.<service_identifier>.response.size
latency	The time interval in milliseconds between the request and response.	kong.service.<service_identifier>.latency
status_count	Tracks each status code returned in a response.	kong.service.<service_identifier>.status.<status>
unique_users	Tracks unique users who made requests to the underlying Service or route.	kong.service.<service_identifier>.user.uniques
request_per_user	Tracks the request count per consumer.	kong.service.<service_identifier>.user.<consumer_identifier>.request.count
upstream_latency	Tracks the time in milliseconds it took for the final Service to process the request.	kong.service.<service_identifier>.upstream_latency
kong_latency	Tracks the internal Kong latency in milliseconds that it took to run all the plugins.	kong.service.<service_identifier>.kong_latency
status_count_per_user	Tracks the status code per consumer per service.	kong.service.<service_identifier>.user.<consumer_identifier>.status.<status>
status_count_per_workspace	The status code per workspace.	kong.service.<service_identifier>.workspace.<workspace_identifier>.status.<status>
status_count_per_user_per_route	The status code per consumer per route.	kong.route.<route_id>.user.<consumer_identifier>.status.<status>
shdict_usage	The usage of a shared dict, sent once every minute. Monitors any lua_shared_dict used by Kong Gateway. You can find all the shared dicts Kong Gateway has configured using the /status endpoint of the Admin API. For example, the metric might report on shdict.kong_locks or shdict.kong_counters.	kong.node.<node_hostname>.shdict.<lua_shared_dict>.free_space and kong.node.<node_hostname>.shdict.<lua_shared_dict>.capacity
cache_datastore_hits_total	The total number of cache hits. (Kong Gateway Enterprise only)	kong.service.<service_identifier>.cache_datastore_hits_total
cache_datastore_misses_total	The total number of cache misses. (Kong Gateway Enterprise only)	kong.service.<service_identifier>.cache_datastore_misses_total

If a request URI doesn’t match any Routes, the following metrics are sent instead:

Metric	Description	Namespace
request_count	The request count.	kong.global.unmatched.request.count
request_size	The request’s body size in bytes.	kong.global.unmatched.request.size
response_size	The response’s body size in bytes.	kong.global.unmatched.response.size
latency	The time interval between when the request started and when the response is received from the upstream server.	kong.global.unmatched.latency
status_count	The status count.	kong.global.unmatched.status.<status>.count
kong_latency	The internal Kong latency in milliseconds that it took to run all the plugins.	kong.global.unmatched.kong_latency

Metric Fields

The plugin can be configured with any combination of Metrics, with each entry containing the following fields:

Field	Description	Datatype	Allowed values
name required	StatsD metric’s name.	String	Metrics
stat_type required	Determines what sort of event a metric represents.	String	gauge, timer, counter, histogram, meter and set
sample_rate required conditional	Sampling rate.	Number	number
consumer_identifier conditional	Authenticated user detail.	String	One of the following options: consumer_id, custom_id, username, null

service_identifier conditional	Service detail.	String	One of the following options: service_id, service_name, service_host, service_name_or_host, null
workspace_identifier conditional	Workspace detail.	String	One of the following options:workspace_id, workspace_name, null

Metric behaviors

• By default, all metrics get logged.
• Metric with stat_type set to counter or gauge must have sample_rate defined as well.

• unique_users metric only works with stat_type as set.

• status_count, status_count_per_user, status_count_per_user_per_route and request_per_user work only with stat_type as counter.
• shdict_usage work only with stat_type as gauge.
• status_count_per_user, request_per_user, unique_users and status_count_per_user_per_route must have customer_identifier defined.
• All metrics can optionally configure service_identifier; by default it’s set to service_name_or_host.
• status_count_per_workspace must have workspace_identifier defined.

Kong Process Errors

This logging plugin logs HTTP request and response data, and also supports stream data (TCP, TLS, and UDP).

The Kong process error file is the Nginx error file. You can find it at the following path:

{prefix}/logs/error.log

Configure the prefix in kong.conf.