From bff338c5156aa4f21118b3af45c4afdc0d9c3a8a Mon Sep 17 00:00:00 2001
From: Simon Cornet <simon@simoncor.net>
Date: Mon, 22 Sep 2025 17:43:45 +0200
Subject: [PATCH] feat(talos): add metrics docs

---
 docs/talos/enable_metrics.md | 44 ++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 docs/talos/enable_metrics.md

diff --git a/docs/talos/enable_metrics.md b/docs/talos/enable_metrics.md
new file mode 100644
index 0000000..e7f5ca0
--- /dev/null
+++ b/docs/talos/enable_metrics.md
@@ -0,0 +1,44 @@
+# Enable Kubernetes Metrics API
+
+By default the metrics API is not available on Talos Linux. This needs to be configured and installed.
+
+## Control Plane
+
+Create a patch for control plane nodes.
+
+```yaml
+machine:
+  kubelet:
+    extraArgs:
+      rotate-server-certificates: true
+
+  files:
+    - content: |
+        [metrics]
+          address = "0.0.0.0:11234"
+      path: /var/cri/conf.d/metrics.toml
+      op: create
+
+cluster:
+  extraManifests:
+    - https://raw.githubusercontent.com/alex1989hu/kubelet-serving-cert-approver/main/deploy/standalone-install.yaml
+    - https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/components.yaml
+```
+
+## Workers
+
+Create a patch for worker nodes.
+
+```yaml
+machine:
+  kubelet:
+    extraArgs:
+      rotate-server-certificates: true
+
+  files:
+    - content: |
+        [metrics]
+          address = "0.0.0.0:11234"
+      path: /var/cri/conf.d/metrics.toml
+      op: create
+```