ISTIOCTL-EXPERIMENTAL-METRICS(1)
π istioctl-experimental-metrics β the metrics page, but make it a vibe
okay so real talk, this is the man page for istioctl-experimental-metrics, from the ISTIOCTL-EXPERIMENTAL-METRICS(1) manual. she's experimental, she's nosy, she wants to know how your workloads are doing. let's go π«Ά
β¨ NAME β¨
istioctl-experimental-metrics β Prints the metrics for the specified workload(s) when running in Kubernetes.
πΈ SYNOPSIS πΈ
istioctl experimental metrics ...
π¦ DESCRIPTION π¦
okay so picture this: it Prints the metrics for the specified service(s) when running in Kubernetes. (yes, workload(s) up in NAME, service(s) down here β she contains multitudes, we move.)
bestie, here's the whole situation. This command finds a Prometheus pod running in the specified istio system namespace. iconic behavior. It then executes a series of queries per requested workload to find the following top-level workload metrics:
- total requests per second π₯
- error rate π
- request latency at p50, p90, and p99 percentiles π
The query results are printed to the console, organized by workload name. cute, legible, slay.
β important vibe check: All metrics returned are from server-side reports. This means that latencies and error rates are from the perspective of the service itself and not of an individual client (or aggregate set of clients). so like, it's the service's own POV, main character energy only. And β Rates and latencies are calculated over a time interval of 1 minute. one whole minute, no cap.
π OPTIONS π
-d,--duration=1m0sβ Duration of query metrics, default value is1m. change it up if a minute isn't giving what you need π-h,--help[=false]β help for metrics. the classic. the blueprint. π
π OPTIONS INHERITED FROM PARENT COMMANDS π
yep, she got these from her mom. still fully functional, still yours to use:
--as=""β Username to impersonate for the operation. User could be a regular user or a service account in a namespace. living someone else's life, respectfully π--as-group=[]β Group to impersonate for the operation, this flag can be repeated to specify multiple groups. stack 'em, collect 'em π--as-uid=""β UID to impersonate for the operation.--context=""β Kubernetes configuration context. pick your universe β-i,--istioNamespace="istio-system"β Istio system namespace. the default is literallyistio-system, she's not trying to be mysterious.- **
--kubeclient-timeout="15s"** β Kubernetes client timeout as atime.Duration` string, defaults to 15 seconds. patience is a virtue but 15s is the limit, bestie π -c,--kubeconfig=""β Kubernetes configuration file.-n,--namespace=""β Kubernetes namespace.--vklog=0β number for the log level verbosity. Like-vflag. ex:--vklog=9. she's chatty at 9, ngl π
π§ EXAMPLE π§
okay so here's how you actually run her, copy-paste ready:
# Retrieve workload metrics for productpage-v1 workload
istioctl experimental metrics productpage-v1
# Retrieve workload metrics for various services with custom duration
istioctl experimental metrics productpage-v1 -d 2m
# Retrieve workload metrics for various services in the different namespaces
istioctl experimental metrics productpage-v1.foo reviews-v1.bar ratings-v1.baz
the third one is the flex, fr fr β name.namespace dotted notation so you can check multiple namespaces in one go π
π SEE ALSO π
istioctl-experimental(1)β go meet the whole experimental family, they're a lot π«Ά
and that's the page!! π Auto generated by spf13/cobra, dated Jan 1980 (yes bestie, 1980, she's vintage π), and the manual is ISTIOCTL-EXPERIMENTAL-METRICS(1). go query some metrics, you're gonna ate. β¨πΈπ
π¦ where this page comes from
- nixos 26.05: istioctl 1.29.2
- nixpkgs unstable: istioctl 1.31.3
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms