Default Metrics
This page presents details about the metrics that Istio collects when using its initial configuration. You can add and remove metrics by changing configuration at any time, but this is the built-in set. They can be found here under the section with “kind: metric”. It uses metric template to define these metrics.
We will describe metrics first and then the labels for each metric.
Metrics
Request Count: This is a
COUNTER
incremented for every request handled by an Istio proxy.Request Duration: This is a
DISTRIBUTION
which measures the duration of the request.Request Size: This is a
DISTRIBUTION
which measures the size of the HTTP request’s body size.Response Size: This is a
DISTRIBUTION
which measures the size of the HTTP response body size.Tcp Byte Sent: This is a
COUNTER
which measures the size of total bytes sent during response in case of a TCP connection.Tcp Byte Received: This is a
COUNTER
which measures the size of total bytes received during request in case of a TCP connection.
Labels
Reporter: This identifies the reporter of the request. It is set to
destination
if report is from a server Istio proxy andsource
if report is from a client Istio proxy.reporter: conditional((context.reporter.kind | "inbound") == "outbound", "source", "destination")
Source Workload: This identifies the name of source workload which controls the source.
source_workload: source.workload.name | "unknown"
Source Workload Namespace: This identifies the namespace of the source workload.
source_workload_namespace: source.workload.namespace | "unknown"
Source Principal: This identifies the peer principal of the traffic source. It is set when peer authentication is used.
source_principal: source.principal | "unknown"
Source App: This identifies the source app based on
app
label of the source workload.source_app: source.labels["app"] | "unknown"
Source Version: This identifies the version of the source workload.
source_version: source.labels["version"] | "unknown"
Destination Workload: This identifies the name of destination workload.
destination_workload: destination.workload.name | "unknown"
Destination Workload Namespace: This identifies the namespace of the destination workload.
destination_workload_namespace: destination.workload.namespace | "unknown"
Destination Principal: This identifies the peer principal of the traffic destination. It is set when peer authentication is used.
destination_principal: destination.principal | "unknown"
Destination App: This identifies the destination app based on
app
label of the destination workload.destination_app: destination.labels["app"] | "unknown"
Destination Version: This identifies the version of the destination workload.
destination_version: destination.labels["version"] | "unknown"
Destination Service: This identifies destination service host responsible for an incoming request. Ex:
details.default.svc.cluster.local
.destination_service: destination.service.host | "unknown"
Destination Service Name: This identifies the destination service name. Ex: “details”.
destination_service_name: destination.service.name | "unknown"
Destination Service Namespace: This identifies the namespace of destination service.
destination_service_namespace: destination.service.namespace | "unknown"
Request Protocol: This identifies the protocol of the request. It is set to API protocol if provided, otherwise request or connection protocol.
request_protocol: api.protocol | context.protocol | "unknown"
Response Code: This identifies the response code of the request. This label is present only on HTTP metrics.
response_code: response.code | 200
Connection Security Policy: This identifies the service authentication policy of the request. It is set to
mutual_tls
when Istio is used to make communication secure and report is from destination. It is set tounknown
when report is from source since security policy cannot be properly populated.connection_security_policy: conditional((context.reporter.kind | "inbound") == "outbound", "unknown", conditional(connection.mtls | false, "mutual_tls", "none"))