mirror of https://github.com/linkerd/linkerd2.git
113 lines
4.4 KiB
Markdown
113 lines
4.4 KiB
Markdown
+++
|
|
title = "Proxy Metrics"
|
|
docpage = true
|
|
[menu.docs]
|
|
parent = "proxy-metrics"
|
|
+++
|
|
|
|
The Conduit proxy exposes metrics that describe the traffic flowing through the
|
|
proxy. The following metrics are available at `/metrics` on the proxy's metrics
|
|
port (default: `:4191`) in the [Prometheus format][prom-format]:
|
|
|
|
### `request_total`
|
|
|
|
A counter of the number of requests the proxy has received. This is incremented
|
|
when the request stream begins.
|
|
|
|
### `request_duration_ms`
|
|
|
|
A histogram of the duration of a request. This is measured from when the
|
|
request headers are received to when the request stream has completed.
|
|
|
|
### `response_total`
|
|
|
|
A counter of the number of responses the proxy has received. This is
|
|
incremeneted when the response stream ends.
|
|
|
|
### `response_duration_ms`
|
|
|
|
A histogram of the duration of a response. This is measured from when the
|
|
response headers are received to when the response stream has completed.
|
|
|
|
### `response_latency_ms`
|
|
|
|
A histogram of the total latency of a response. This is measured from when the
|
|
request headers are received to when the response stream has completed.
|
|
|
|
## Labels
|
|
|
|
Each of these metrics has the following labels:
|
|
|
|
* `direction`: `inbound` if the request originated from outside of the pod,
|
|
`outbound` if the request originated from inside of the pod.
|
|
* `authority`: The value of the `:authority` (HTTP/2) or `Host` (HTTP/1.1)
|
|
header of the request.
|
|
* `dst_deployment`: The deployment to which this request is being sent. Only
|
|
applicable if `direction=outbound`.
|
|
* `dst_job`: The job to which this request is being sent. Only applicable if
|
|
`direction=outbound`.
|
|
* `dst_replica_set`: The replica set to which this request is being sent. Only
|
|
applicable if `direction=outbound`.
|
|
* `dst_daemon_set`: The daemon set to which this request is being sent. Only
|
|
applicable if `direction=outbound`.
|
|
* `dst_replication_controller`: The replication controller to which this request
|
|
is being sent. Only applicable if
|
|
`direction=outbound`.
|
|
* `dst_namespace`: The namespace to which this request is being sent. Only
|
|
applicable if `direction=outbound`.
|
|
* `status_code`: The HTTP status code of the response. Only applicable to
|
|
response metrics.
|
|
* `grpc_status_code`: The value of the `grpc-status` trailer. Only applicable
|
|
to response metrics for gRPC responses.
|
|
|
|
The following labels are added by the Prometheus collector. All Kubernetes
|
|
labels are mapped to corresponding `k8s_*` Prometheus labels. Kubernetes labels
|
|
prefixed with `conduit.io/` are added to your application at `conduit inject`
|
|
time. More specifically, Kubernetes labels prefixed with `conduit.io/proxy-*`
|
|
will correspond to `k8s_*` Prometheus labels:
|
|
|
|
* `instance`: ip:port of the pod.
|
|
* `job`: The Prometheus job responsible for the collection, typically
|
|
`conduit-proxy`.
|
|
* `namespace`: Kubernetes namespace that the pod belongs to.
|
|
* `k8s_deployment`: The deployment that the pod belongs to (if applicable).
|
|
* `k8s_job`: The job that the pod belongs to (if applicable).
|
|
* `k8s_replica_set`: The replica set that the pod belongs to (if applicable).
|
|
* `k8s_daemon_set`: The daemon set that the pod belongs to (if applicable).
|
|
* `k8s_replication_controller`: The replication controller that the pod belongs
|
|
to (if applicable).
|
|
* `k8s_pod_template_hash`: Corresponds to the
|
|
[pod-template-hash][pod-template-hash] Kubernetes
|
|
label. This value changes during redeploys and
|
|
rolling restarts.
|
|
|
|
Here's a concrete example, given the following pod snippet:
|
|
|
|
```yaml
|
|
namespace: emojivoto
|
|
labels:
|
|
app: vote-bot
|
|
conduit.io/control-plane-ns: conduit
|
|
conduit.io/proxy-deployment: vote-bot
|
|
pod-template-hash: "3957278789"
|
|
test: vote-bot-test
|
|
```
|
|
|
|
The resulting Prometheus labels will look like this:
|
|
|
|
```
|
|
request_total{
|
|
namespace="emojivoto",
|
|
k8s_app="vote-bot",
|
|
k8s_conduit_io_control_plane_ns="conduit",
|
|
k8s_deployment="vote-bot",
|
|
k8s_pod_template_hash="3957278789",
|
|
k8s_test="vote-bot-test",
|
|
instance="10.1.3.93:4191",
|
|
job="conduit-proxy"
|
|
}
|
|
```
|
|
|
|
[prom-format]: https://prometheus.io/docs/instrumenting/exposition_formats/#format-version-0.0.4
|
|
[pod-template-hash]: https://kubernetes.io/docs/concepts/workloads/controllers/deployment/#pod-template-hash-label
|